Create a new route
As described in the route introduction, the first thing you will need to do is fetch a
route ID. This
route ID can then be sent to subscribe to route details and retrieve a polyline and other route data.
To get a
route ID, you will need to provide us with EV details and at least a departure location and destination. Apart from that you can also support any of the options that are described below.
Support alternative stations along a route
If you want to request alternative charging stations along a route, you can set the
stationsAlongRouteRadius property of the route mutation. The radius can be set between
5000 meters. This will return all applicable stations within the set radius following the specified powers and standards.
Support stations as waypoint
You can add a station as a waypoint or as a destination. To do this, add
Get additional properties
Our route destination, origin and stations have an optional
properties attribute in any of our route queries. You can use this to fetch a complete
address, the current temperature (
temp) and air
pressure at that location.
In your route request, you can rank or exclude operators based on preference. We support ten different levels of preference. Level 1 is considered the highest level, and level 10 is the lowest. It is possible to skip levels or add multiple operators to the same level. Every level lowers the preference by 10 percent. Enable your operator ranking by setting it to
If you always prefer and exclude the same operators, we recommend that you add your operator ranking to your client configuration instead. The route request will override any client configuration you might have.
If successful, the HTTP status code in the response header is
200 and the response body contains the attributes you
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
No car was found with the provided ID
Negative value for $LOCATION is not allowed.
Operator $OPERATORID is in both in the ranking and excluded lists
Operator $OPERATORID is present multiple times in the exclude lists
Operator $OPERATORID is present multiple times in the ranking lists
Operator ranking must be between 1 and 10!
No operator was found with the $OPERATORID ID
The route operator type was set to $ROUTEOPTYPE, but no ranking was provided. Please add an operator to your client or route request
The destination station for the route requested was not found with the provided ID
The provided final state of charge is too high. The value must be less than or equal to the car battery capacity value
The destination coordinates provided are not valid
The origin coordinates provided are not valid
The via coordinates provided are not valid
Provided number of passengers is not valid. The value must be between 1 and $PASSENGERCOUNT for this car
The provided minimum power is too small. The value must be greater than 0 kwh
The origin station for the route requested was not found with the provided ID
The radius value is above allowed, the maximum value is 5000 meters
The radius value is below allowed, the minimum value is 500 meters
The provided state of charge is too high. The value must be less than or equal to the car battery capacity value
The charger standard used on this car is not supported by the station
The minimum power requested is higher than the station could support
The station speed is not fast or turbo
The via station for the route requested was not found with the provided ID
Coordinates [$DESTINATIONCOORDINATES] of destination don't match with station coordinates [$STATIONCOORDINATES]
Coordinates [$ORIGINCOORDINATES] of origin don't match with station coordinates [$STATIONCOORDINATES]
Coordinates [$VIACOORDINATES] of via don't match with station coordinates [$STATIONCOORDINATES]