Trip
A Report is essentially a summary of data over a particular period of time.
A summary could for instance be based on driving data (trips), or the usage of access keys.
URL Structure is:
https://api.trackunit.com/public/Report/Trip
GetReportTrip
Will provide a summary of trips traveled with start/stop location info, date and time etc.
A log of the actual driving.
Note
You must specify at least one of
UnitId
orKeyId
.
Parameters
Name | Data type | Note | Note |
---|---|---|---|
unitID | String Optional | N/A | Unit Id to request summary for. |
keyID | String Optional | N/A | Key Id to request summary for. |
dateFrom* | DateTime Required | UTC | Date that we request summary for. |
dateTo* | DateTime Required | UTC | Similar to DateFrom |
Columns
Refer to the following table for description of columns:
Name | Date type | Unit of measurement | Nullability | Note |
---|---|---|---|---|
unitId | String | N/A | FALSE | Unique identifier, unit. |
keyId | String | N/A | TRUE | Unique identifier, key. |
startTime | DateTime | UTC | FALSE | |
startLocation | Location | N/A | TRUE | |
startAddress | Address | N/A | TRUE | |
startKm | Double | Km | FALSE | |
startRun1 | DateTime | UTC | FALSE | |
stopTime | DateTime | UTC | FALSE | |
stopLocation | Location | N/A | TRUE | |
stopAddress | Address | N/A | TRUE | |
stopKm | Double | Km | FALSE | |
stopRun1 | Double | Second | FALSE | |
finished | Bool | N/A | FALSE | |
maxSpeed | Double | Km/h | TRUE |
Request (example)
{
"unitId": "46209",
"dateFrom": "2013-08-05T07:00:00.0000000",
"dateTo": "2013-08-06T07:00:00.0000000"
}
Response
{
"list":[
{
"unitId": "46209",
"startTime":" 2013-08-05T07:26:07.0000000",
"startLocation":{
"latitude": 56.0380633333333,
"longitude": 12.6013966666667
},
"startAddress":{
"country": "DK",
"zipCode": "3000",
"city": "Helsingør",
"streetAddress": "Esrumvej 9A"
},
"startKm": 12959,
"startRun1": 0,
"stopTime": "2013-08-05T07:30:18.0000000",
"stopLocation":{
"latitude": 56.0453933333333,
"longitude": 12.5890566666667
},
"stopAddress":{
"country": "DK",
"zipCode": "3000",
"city": "Helsingør",
"streetAddress": "Tårnhøjvej 6"
},
"stopKm": 12961,
"stopRun1": 0,
"finished": true,
"maxSpeed": 33.336
},
{
"unitId": "46209",
"startTime": "2013-08-05T07:35:36.0000000",
"startLocation":{
"latitude": 56.04539,
"longitude": 12.5891783333333
},
"startAddress":{
"country": "DK",
"zipCode": "3000",
"city": "Helsingør",
"streetAddress": "Tårnhøjvej 6"
},
"startKm": 12961,
"startRun1": 0,
"stopTime": "2013-08-05T07:40:15.0000000",
"stopLocation":{
"latitude": 56.0370916666667,
"longitude": 12.580795
},
"stopAddress":{
"country": "DK",
"zipCode": "3000",
"city": "Helsingør",
"streetAddress": "Blichersvej 33"
},
"stopKm": 12963,
"stopRun1": 0,
"finished": true,
"maxSpeed": 40.744
},
{
"unitId": "46209",
"startTime": "2013-08-06T05:40:18.0000000",
"startLocation":{
"latitude": 56.037205,
"longitude": 12.5807183333333
},
"startAddress":{
"country": "DK",
"zipCode": "3000",
"city": "Helsingør",
"streetAddress": "Blichersvej 33"
},
"startKm": 12963,
"startRun1": 0,
"stopTime": "2013-08-06T05:45:39.0000000",
"stopLocation":{
"latitude": 56.02579,
"longitude": 12.5709166666667
},
"stopAddress":{
"country": "DK",
"zipCode": "3000",
"city": "Helsingør",
"streetAddress": "H P Christensens Vej 4A"
},
"stopKm": 12966,
"stopRun1": 0,
"finished": true,
"maxSpeed": 72.228
},
{
"unitId": "46209",
"startTime": "2013-08-06T06:08:57.0000000",
"startLocation":{
"latitude": 56.025885,
"longitude": 12.57114
},
"startAddress":{
"country": "DK",
"zipCode": "3000",
"city": "Helsingør",
"streetAddress": "H P Christensens Vej 4B"
},
"startKm": 12966,
"startRun1": 0,
"stopTime": "2013-08-06T06:25:31.0000000",
"stopLocation":{
"latitude": 55.9742283333333,
"longitude": 12.411285
},
"stopAddress":{
"country": "DK",
"zipCode": "3480",
"city": "Fredensborg",
"streetAddress": "Hammersvej 15"
},
"stopKm": 12981,
"stopRun1": 0,
"finished": true,
"maxSpeed": 125.936
}
]
}
Updated less than a minute ago