{ "$schema": "http://json-schema.org/schema#", "$schemaVersion": "0.0.1", "modelTags": "GSMA", "$id": "https://smart-data-models.github.io/dataModel.Transportation/FleetVehicleStatus/schema.json", "title": "Smart Data models - Fleet Vehicle Status schema", "description": "This entity contains a harmonised description of the status of a generic fleet vehicle. This entity is primarily associated with the vertical segment of the transport and logistics but may also be used many other related IoT applications.", "type": "object", "allOf": [ { "$ref": "https://smart-data-models.github.io/data-models/common-schema.json#/definitions/GSMA-Commons" }, { "$ref": "https://smart-data-models.github.io/data-models/common-schema.json#/definitions/Location-Commons" }, { "properties": { "type": { "type": "string", "description": "Property. NGSI Entity identifier. It has to be FleetVehicleStatus", "enum": [ "FleetVehicleStatus" ] }, "fleetVehicle": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 256, "pattern": "^[\\w\\-\\.\\{\\}\\$\\+\\*\\[\\]`|~^@!,:\\\\]+$", "description": "Property. Identifier format of any NGSI entity" }, { "type": "string", "format": "uri", "description": "Property. Identifier format of any NGSI entity" } ], "description": "Relationship. Reference to the FleetVehicle entity to which this status entity relates" }, "fleetVehicleOperation": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 256, "pattern": "^[\\w\\-\\.\\{\\}\\$\\+\\*\\[\\]`|~^@!,:\\\\]+$", "description": "Property. Identifier format of any NGSI entity" }, { "type": "string", "format": "uri", "description": "Property. Identifier format of any NGSI entity" } ], "description": "Relationship. Reference to the FleetVehicleOperation entity to which this status entity relates" }, "restFuelAmount": { "type": "number", "description": "Property. The level of fuel recorded when the vehicle was last at rest (i.e. stopped). The timestamp element of the attribute should indicate when the vehicle was last at rest. Data to be recorded in Litres" }, "lastFuellingAmount": { "type": "number", "description": "Property. The level of fuel added to the vehicle at the last fuelling. The timestamp element of the attribute should indicate when the vehicle was fuelled. Data to be recorded in Litres. Units:'litres'" }, "currentStatus": { "type": "string", "description": "Property. A description of the current status of the vehicle e.g. Enum:'deployed, finished, terminated, servicing, starting'", "enum": [ "deployed", "finished", "servicing", "starting", "terminated" ] }, "currentOperative": { "type": "object", "description": "Property. The current operative (e.g. driver) of the vehicle described as a Schema.org person. Model:'https://schema.org/Person'", "properties": { "givenName": { "type": "string" }, "jobTitle": { "type": "string" } } }, "speed": { "type": "number", "description": "Property. The current speed of the fleet vehicle (km/h). The timestamp element of the attribute should indicate when the reading was obtained. Units:'km/h'" }, "battery": { "type": "number", "minimum": 0, "maximum": 1, "description": "Property. The current percentage of battery left in case of an electric vehicle, or a device connected to the vehicle" }, "bearing": { "type": "number", "description": "Property. The current bearing of the fleet vehicle in degrees relative to North. The timestamp element of the attribute should indicate when the reading was obtained" }, "lastKnownPosition": { "$ref": "https://smart-data-models.github.io/data-models/common-schema.json#/definitions/Location-Commons/properties/location" }, "lastKnownPositionUpdatedAt": { "type": "string", "format": "date-time", "description": "Property. The timestamp of the last known position update for the fleet vehicle" }, "inRestrictedArea": { "type": "boolean", "description": "Property. Indicates if the vehicle is known to be in a restricted area at the time of the status update" }, "mileageFromOdometer": { "type": "number", "description": "Property. The total distance the fleet vehicle has travelled according to the on-board odometer in kilometres (unitCode KMT) or miles (unitCode SMI). See also Schema.org Vehicle/ mileageFromOdometer. The timestamp element records when the odometer reading was taken" } } } ], "required": [ "id", "type" ] }