Update mileage

Once a vehicle is declared, the distances of all trips are aggregated to calculate the total analyzed distance.

If the vehicle has already been driven before it has been registered on the platform, there will be an offset between the vehicle odometer and the total analyzed distance (computed by DriveQuant services).

If you find an offset between the vehicle's odometer and the total analyzed distance, you can set vehicle mileage.

The vehicle mileage value is updated :

1. Every time a trip is analyzed.

2. Each time the odometer update API is used.

If you have your admin API key, you can try the API via this link.

Update vehicle mileage

put

Authorizations

api-key

DriveKit-Admin-API-KeystringRequired

Path parameters

vehicleIdstringRequired

Header parameters

DriveKit-Admin-API-KeystringRequired

Admin API Key

Body

application/json

distancenumber · max: 500000Required

Vehicle odometer reading in kilometer

Responses

200

OK

application/json

analyzedDistancenumberOptional

Distance analysed by the app

creationDatestring · date-timeOptional

Creation date of the vehicle

Example: 2020-01-10T10:00:00.125+0200

distancenumberOptional

Total distance travelled by the vehicle

offsetDistancenumberOptional

offset between analysed and total distance

400

Bad Request

application/json

401

Unauthorized

application/json

404

Not Found

application/json

put

/drivekit/admin/vehicles/{vehicleId}/distance

HTTPcURLJavaScriptPython

PUT /v3/drivekit/admin/vehicles/{vehicleId}/distance HTTP/1.1
Host: service.drivequant.com
DriveKit-Admin-API-Key: text
Content-Type: application/json
Accept: */*
Content-Length: 14

{
  "distance": 1
}

{
  "analyzedDistance": 4589,
  "creationDate": "2020-01-10T10:00:00.125+0200",
  "distance": 10052,
  "offsetDistance": 5463
}