Updating a navigation session
Once you have created a navigation session and set up a subscription, you can provide more data to update the navigation session. Based on the locations and telemetry data, the Chargetrip algorithms optimize the route.
In order to update a navigation session you need to provide the id and an array of
locations_data. The other fields,
telemetry are optional but including them will result in better consumption predictions and more accurate routing.
You need to send at least one location in
locations_data array. If you are using Mapbox as a data provider you will periodically receive updates that can be stored in a local cache. Alternatively, you could store a location every 5 or 10 seconds depending on the vehicle speed.
We recommend you to send the vehicle location at least every 5 minutes.
Besides location data our API accepts telemetry data. This is real-time data coming directely from the vehicle. You can read more about connected vehicle data here. This data may includes the
state_of_charge of the vehicle. This would allow you to send us a new SoC value after charging at a station. Or you could send us intermittend SoC values to confirm our rolling prediction.
state_of_charge, you can provide us with other telemetry data like the average
tire_pressure of all wheels or whether or not the vehicle is charging via the
is_charging boolean. There are many more accepted telemetry fields depending on the make and model of the vehicle. You can find an overview of accepted/recommended telemetry fields here. Chargetrip can easily add additional custom telemetry inputs; heat pump, active weight, refrigeration, PV etc. Please contact your account manager or contact firstname.lastname@example.org.
Navigation update input
If successful, the HTTP status code in the response header is 200 and the response body contains the attributes you requested.
If unsuccessful, the header status code is an error code and the response body contains an error response object. The error response object can be any of the ones below.
Errors and warnings
Heading should be a value between 0 and 360
One or more locations sent are invalid
You should send us at least one location
Field $TELEMETRYTYPE cannot be negative