Query isolines

After you receive your isoline ID through the isoline mutation, you can query your isoline. This isoline will contain polygons with the coordinates to render each layer. The amount of polygons is equal to the polygon_count that was set in the isoline mutation.

Query

To query the isoline details, you will need to configure it with the isoline ID. Be sure to include the status in your response and check it. If your isoline hasn't completed processing yet, then your isoline will not be available. To prevent this from happening, you can use the subscription service.

Please keep in mind that isoline mutations can take longer to process. The time is dependent on the range of the car and the amount to which the polygon_count has been set.

Polygons

The amount of polygons is equal to the polygon_count. Every polygon consists of an index and a set of coordinates. This allows you to build beautiful front ends.

Arguments

id non_null ID

Required

ID of the isoline label to retrieve

Frequently used fields

id non_null ID

Required

Isoline id

polygons list FeaturePolygon

Shape of the isoline consisting in a list of polygons

origin non_null FeaturePolygonPoint

Required

Origin point of the request

Other fields

id non_null ID

Required

Isoline id

status non_null IsolineStatus

Required

Isoline status

polygons list FeaturePolygon

Shape of the isoline consisting in a list of polygons

origin non_null FeaturePolygonPoint

Required

Origin point of the request

vehicle_id non_null ID

Required

Vehicle id

polygon_count scalar Int

Number of Isolines to be generated representing SoC (default: 1, max: 100)

season enum RouteSeason

Season to be taken into account when generating the isoline, defaults to current

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

Error

ISOLINE_NOT_FOUND

No isoline label was found with the provided ID

Error

ISOLINE_NOT_FOUND

No isoline label was found with the provided ID