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
    Required

    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 & warnings