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.
Mutation
In order to update a navigation session you need to provide the id and an array of locations_data
. The other fields, heading
and telemetry
are optional but including them will result in better consumption predictions and more accurate routing.
Locations data heartbeat
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.
Telemetry data
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.
Besides the 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 sales@chargetrip.com.
Arguments
input • non_null • NavigationUpdateInput
Navigation update input
Response
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
NAVIGATION_HEADING_INVALID
Heading should be a value between 0 and 360
NAVIGATION_LOCATION_INVALID
One or more locations sent are invalid
NAVIGATION_LOCATIONS_MINIMUM_LENGTH
You should send us at least one location
NAVIGATION_TELEMETRY_INVALID
Field $TELEMETRYTYPE cannot be negative