This API returns the same data as the Driver Performance Report on Motia Telematics Portal. Drivers are scored based on 5 KPI's, idling, speeding, harsh acceleration events per 100KM, harsh braking events per 100KM and harsh cornering events per 100KM. The total score is then aggregated across all 5 scores to give a total percentage score.
The API will return all drivers that have drive the vehicles your API user account has access to between the 2 dates and times requested in the API call. Any queries or issues you have with the API please send an example of the request and response to fleetsupport@motia.com
Service URL
https://ws.mycubo.online/IntegrationService.svc
Service method and input parameters
GetDVPRFByUserList(string token,string FromDate, string ToDate)
-FromDate–date time (DD/MM/YYYY & HH:MM Format eg 01/01/2022%2000:00)
-ToDate– date time (DD/MM/YYYY & HH:MM Format eg 01/01/2022%2023:59)
-Token- By Using below api to get the token (Instructions Here)
Service Response
- ErrorMessage - empty for successful call
- DVPRF – list of data
Sample Response – Expired or Invalid Token
Request
Response
{
"DVPRF": null,
"ErrorMessage": "Token was expired."
}
Sample Response – Invalid Credentials
Request
Response
{
"DVPRF": null,
"ErrorMessage": "Login failed. Please enter valid username and password."
}
Sample Request – Too Many Requests Per Minute
Request
Response
{
"DVPRF": null,
"ErrorMessage": "Last request was 3 seconds ago. Request is allowed once per
60 second period."
}
Sample Request – Correct Request
Request
Response
{
"DVPRF": [
{
"AverageMPG": 11.26,
"DriverId": "DN111129980029",
"DriverName": "Colin Craig Tacho",
"PercentageHACount": 100.00,
"PercentageHCCount": 100.00,
"PercentageHLCount": 100.00,
"PercentageHRCount": 100.00,
"PercentageHbCount": 100.00,
"PercentageIdleDuration": 43.3000000000000000,
"PercentageJourneysOverspeed": 71.61000000,
"PrercentageOverallPerformance": 82.98,
"TotalDistanceTravelled": 12747.72,
"TotalFuelBurnt": 1132.44,
"TotalHACount": 0,
"TotalHCCount": 0,
"TotalHLCount": 0,
"TotalHRCount": 0,
"TotalHbCount": 0,
"TotalIdleDurationAsString": "423:50:17",
"TotalJourneyCount": 722,
"TotalJourneyDurationAsString": "747:31:10",
"TotalJourneysOverspeed": 205,
"Vehicle_Record": [
{
"FriendlyName": "Truck 1",
"Registration": "131D37416"
},
{
"FriendlyName": "Truck 2",
"Registration": "MGZ 4429"
},
{
"FriendlyName": "Truck 3",
"Registration": "LRZ8302"
}
]
}
],
"ErrorMessage": null
}
Comments
0 comments
Article is closed for comments.