Current section
Files
Jump to
Current section
Files
specs/capabilities/trips.json
{
"name": "trips",
"name_cased": "trips",
"name_pretty": "Trips",
"category": "poi",
"authorization": true,
"identifier": {
"msb": 0,
"lsb": 106
},
"api": {
"intro": 12,
"update": 13
},
"state": "all",
"properties": [
{
"id": 1,
"name": "type",
"name_cased": "type",
"name_pretty": "Type",
"added": 12,
"type": "enum",
"size": 1,
"description": "Type of the trip",
"enum_values": [
{
"id": 0,
"name": "single"
},
{
"id": 1,
"name": "multi"
},
{
"id": 2,
"name": "eco"
}
],
"examples": [
{
"data_component": "00",
"value": "single",
"description": "Trip had a single stop"
}
]
},
{
"id": 2,
"name": "driver_name",
"name_cased": "driverName",
"name_pretty": "Driver name",
"added": 12,
"type": "string",
"description": "Name of the driver of the trip",
"examples": [
{
"data_component": "486172692053656c646f6e",
"value": "Hari Seldon",
"description": "Driver name is 'Hari Seldon'"
}
]
},
{
"id": 3,
"name": "description",
"name_cased": "description",
"name_pretty": "Description",
"added": 12,
"type": "string",
"description": "Description of the trip",
"examples": [
{
"data_component": "546f20736176652068756d616e6b696e64",
"value": "To save humankind",
"description": "Description of the trip is 'To save humankind'"
}
]
},
{
"id": 4,
"name": "start_time",
"name_cased": "startTime",
"name_pretty": "Start time",
"added": 12,
"type": "timestamp",
"size": 8,
"description": "Start time of the trip",
"examples": [
{
"data_component": "00000172cc7e5190",
"value": "2020-06-19T12:12:10.000Z",
"description": "Trip started at 19 June 2020 at 12:12:10 GMT"
}
]
},
{
"id": 5,
"name": "end_time",
"name_cased": "endTime",
"name_pretty": "End time",
"added": 12,
"type": "timestamp",
"size": 8,
"description": "End time of the trip",
"examples": [
{
"data_component": "00000172ccb54010",
"value": "2020-06-19T13:12:10.000Z",
"description": "Trip ended at 19 June 2020 at 13:12:10 GMT"
}
]
},
{
"id": 6,
"name": "start_address",
"name_cased": "startAddress",
"name_pretty": "Start address",
"added": 12,
"type": "string",
"description": "Start address of the trip",
"examples": [
{
"data_component": "536b616c69747a65722053747261c39f652036382c203130393937204265726c696e2c204765726d616e79",
"value": "Skalitzer Straße 68, 10997 Berlin, Germany",
"description": "Trip started from Skalitzer Straße 68, 10997 Berlin, Germany"
}
]
},
{
"id": 7,
"name": "end_address",
"name_cased": "endAddress",
"name_pretty": "End address",
"added": 12,
"type": "string",
"description": "End address of the trip",
"examples": [
{
"data_component": "536b616c69747a65722053747261c39f652036382c203130393937204265726c696e2c204765726d616e79",
"value": "Skalitzer Straße 68, 10997 Berlin, Germany",
"description": "Trip ended at Skalitzer Straße 68, 10997 Berlin, Germany"
}
]
},
{
"id": 8,
"name": "start_coordinates",
"name_cased": "startCoordinates",
"name_pretty": "Start coordinates",
"added": 12,
"type": "types.coordinates",
"description": "Start coordinates of the trip",
"examples": [
{
"data_component": "404a40090b417ca2402ae122d948dc12",
"values": {
"latitude": 52.500276,
"longitude": 13.439719
},
"description": "Trip started from 52.500276:13.439719"
}
]
},
{
"id": 9,
"name": "end_coordinates",
"name_cased": "endCoordinates",
"name_pretty": "End coordinates",
"added": 12,
"type": "types.coordinates",
"description": "End coordinates of the trip",
"examples": [
{
"data_component": "404a40090b417ca2402ae122d948dc12",
"values": {
"latitude": 52.500276,
"longitude": 13.439719
},
"description": "Trip ended at 52.500276:13.439719"
}
]
},
{
"id": 10,
"name": "start_odometer",
"name_cased": "startOdometer",
"name_pretty": "Start odometer",
"added": 12,
"type": "unit.length",
"size": 10,
"description": "Odometer reading at the start of the trip",
"examples": [
{
"data_component": "120440c4820000000000",
"value": {
"kilometers": 10500.0
},
"description": "At the start of the trip the odometer was showing 10500.0km"
}
]
},
{
"id": 11,
"name": "end_odometer",
"name_cased": "endOdometer",
"name_pretty": "End odometer",
"added": 12,
"type": "unit.length",
"size": 10,
"description": "Odometer reading at the end of the trip",
"examples": [
{
"data_component": "120440c4978000000000",
"value": {
"kilometers": 10543.0
},
"description": "At the start of the trip the odometer was showing 10543.0km"
}
]
},
{
"id": 12,
"name": "average_fuel_consumption",
"name_cased": "averageFuelConsumption",
"name_pretty": "Average fuel consumption",
"added": 12,
"type": "unit.fuel_efficiency",
"size": 10,
"description": "Average fuel consumption during the trip",
"examples": [
{
"data_component": "0f00401d5c28f5c28f5c",
"value": {
"liters_per_100_kilometers": 7.34
},
"description": "Average fuel consumption during the trip was 7.34 l/100km"
}
]
},
{
"id": 13,
"name": "distance",
"name_cased": "distance",
"name_pretty": "Distance",
"added": 12,
"type": "unit.length",
"size": 10,
"description": "Distance of the trip",
"examples": [
{
"data_component": "12044045800000000000",
"value": {
"kilometers": 43.0
},
"description": "Distance of trip was 43.0km"
}
]
},
{
"id": 14,
"name": "start_address_components",
"name_cased": "startAddressComponents",
"name_pretty": "Start address components",
"name_singluar": "start_address_component",
"added": 12,
"type": "types.address_component",
"multiple": true,
"description": "Start address components",
"examples": [
{
"data_component": "0000064265726c696e",
"values": {
"type": "city",
"value": "Berlin"
},
"description": "City component value is 'Berlin'"
},
{
"data_component": "0100074765726d616e79",
"values": {
"type": "country",
"value": "Germany"
},
"description": "Country component value is 'Germany'"
},
{
"data_component": "0200024445",
"values": {
"type": "country_short",
"value": "DE"
},
"description": "Country short component value is 'DE'"
},
{
"data_component": "0300064265726c696e",
"values": {
"type": "district",
"value": "Berlin"
},
"description": "District component value is 'Berlin'"
},
{
"data_component": "0400053130313137",
"values": {
"type": "postal_code",
"value": "10117"
},
"description": "Postal code component value is '10117'"
},
{
"data_component": "050014536b616c69747a65722053747261c39f65203638",
"values": {
"type": "street",
"value": "Skalitzer Straße 68"
},
"description": "Street component value is 'Skalitzer Straße 68'"
},
{
"data_component": "06000b4272616e64656e62757267",
"values": {
"type": "state_province",
"value": "Brandenburg"
},
"description": "Country component value is 'Brandenburg'"
},
{
"data_component": "0700074765726d616e79",
"values": {
"type": "other",
"value": "Germany"
},
"description": "Other component value is 'Germany'"
}
]
},
{
"id": 15,
"name": "end_address_components",
"name_cased": "endAddressComponents",
"name_pretty": "End address components",
"name_singluar": "end_address_component",
"added": 12,
"type": "types.address_component",
"multiple": true,
"description": "End address components",
"examples": [
{
"data_component": "0000064265726c696e",
"values": {
"type": "city",
"value": "Berlin"
},
"description": "City component value is 'Berlin'"
},
{
"data_component": "0100074765726d616e79",
"values": {
"type": "country",
"value": "Germany"
},
"description": "Country component value is 'Germany'"
},
{
"data_component": "0200024445",
"values": {
"type": "country_short",
"value": "DE"
},
"description": "Country short component value is 'DE'"
},
{
"data_component": "0300064265726c696e",
"values": {
"type": "district",
"value": "Berlin"
},
"description": "District component value is 'Berlin'"
},
{
"data_component": "0400053130313137",
"values": {
"type": "postal_code",
"value": "10117"
},
"description": "Postal code component value is '10117'"
},
{
"data_component": "050014536b616c69747a65722053747261c39f65203638",
"values": {
"type": "street",
"value": "Skalitzer Straße 68"
},
"description": "Street component value is 'Skalitzer Straße 68'"
},
{
"data_component": "06000b4272616e64656e62757267",
"values": {
"type": "state_province",
"value": "Brandenburg"
},
"description": "Country component value is 'Brandenburg'"
},
{
"data_component": "0700074765726d616e79",
"values": {
"type": "other",
"value": "Germany"
},
"description": "Other component value is 'Germany'"
}
]
},
{
"id": 16,
"name": "event",
"name_cased": "event",
"name_pretty": "Event",
"added": 13,
"type": "enum",
"size": 1,
"enum_values": [
{
"id": 0,
"name": "harsh_braking"
},
{
"id": 1,
"name": "harsh_acceleration"
},
{
"id": 2,
"name": "sharp_turn"
},
{
"id": 3,
"name": "over_rpm",
"name_pretty": "Over RPM"
},
{
"id": 4,
"name": "overspeed"
},
{
"id": 5,
"name": "idling_engine_on"
},
{
"id": 6,
"name": "emergency_braking"
}
],
"examples": [
{
"data_component": "01",
"value": "harsh_acceleration",
"description": "Driving event of harsh acceleration encountered"
}
]
},
{
"id": 17,
"name": "eco_level",
"name_cased": "ecoLevel",
"name_pretty": "Eco level",
"added": 13,
"type": "enum",
"size": 1,
"enum_values": [
{
"id": 0,
"name": "high"
},
{
"id": 1,
"name": "medium"
}
],
"examples": [
{
"data_component": "00",
"value": "high",
"description": "Eco driving level is high"
}
]
},
{
"id": 18,
"name": "thresholds",
"name_cased": "thresholds",
"name_pretty": "Thresholds",
"name_singluar": "Threshold",
"added": 13,
"type": "types.eco_driving_threshold",
"multiple": true,
"description": "Eco driving thresholds",
"examples": [
{
"data_component": "000000000000000000",
"values": {
"type": "zero",
"value": 0.0
},
"description": "Eco driving zero-threshold is set at 0.0"
},
{
"data_component": "010000000000000000",
"values": {
"type": "one",
"value": 0.0
},
"description": "Eco driving one-threshold is set at 0.0"
}
]
},
{
"id": 19,
"name": "total_fuel_consumption",
"name_cased": "totalFuelConsumption",
"name_pretty": "Total fuel consumption",
"added": 13,
"type": "unit.volume",
"size": 10,
"description": "Total fuel consumption during the trip",
"examples": [
{
"data_component": "19024037666666666666",
"value": {
"liters": 23.4
},
"description": "Total fuel consumption during the trip was 23.4 l"
}
]
},
{
"id": 20,
"name": "total_idle_fuel_consumption",
"name_cased": "totalIdleFuelConsumption",
"name_pretty": "Total idle fuel consumption",
"added": 13,
"type": "unit.volume",
"size": 10,
"description": "Fuel consumed while idle since the last ignition on.",
"examples": [
{
"data_component": "19024004000000000000",
"value": {
"liters": 2.5
},
"description": "Since the last ignition the vehicle has consumed 2.5 l while ideling."
}
]
},
{
"id": 21,
"name": "maximum_speed",
"name_cased": "maximumSpeed",
"name_pretty": "Maximum speed",
"added": 13,
"type": "unit.speed",
"size": 10,
"description": "Maximum speed recorded since the last igntion on.",
"examples": [
{
"data_component": "16014050d33333333333",
"value": {
"kilometers_per_hour": 67.3
},
"description": "Maximum speed since last ignition on is 67.3km/h"
}
]
},
{
"id": 22,
"name": "road_type",
"name_cased": "roadType",
"name_pretty": "Road type",
"added": 13,
"type": "enum",
"size": 1,
"description": "Type of road travelled on.",
"enum_values": [
{
"id": 0,
"name": "private_or_gravel"
},
{
"id": 1,
"name": "local"
},
{
"id": 2,
"name": "county"
},
{
"id": 3,
"name": "rural"
},
{
"id": 4,
"name": "federal_highway"
},
{
"id": 5,
"name": "highway"
},
{
"id": 6,
"name": "country"
},
{
"id": 7,
"name": "national"
}
],
"examples": [
{
"data_component": "01",
"value": "local",
"description": "Road was of local type."
}
]
},
{
"id": 23,
"name": "braking_count",
"name_cased": "brakingCount",
"name_pretty": "Braking count",
"added": 13,
"type": "uinteger",
"size": 2,
"description": "Number of times the brakes were applied during the trip.",
"examples": [
{
"data_component": "00a1",
"value": 161,
"description": "Brakes were applied 161 times during the trip."
}
]
}
]
}