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 vehicle 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 ID

Required

ID of the isoline label to retrieve

Frequently used fields

id ID

Isoline id

polygons FeatureMultiPolygon

Shape of the isoline consisting in a list of multipolygons

origin FeatureMultiPolygonPoint

Origin point of the request

Other fields

status IsolineStatus

Isoline status

Show IsolineStatus enum values

ferries FeatureLineString

List of the ferries uniting islands formed by the isoline

vehicle_id ID

Vehicle id

polygon_count Int

Number of Isolines to be generated representing SoC (default: 1, maximum: 20)

season RouteSeason

Season to be taken into account when generating the isoline. Default: current

Show RouteSeason enum values

Response

A response can either contain a data or an errors object. The response header will always return 200 as a status code.

Data object

When successful, a data object will be returned with the requested fields. If there are no fields present the data object will return the operation name with the appropriate return type. If the operation was a query, this output will be an object of the schema’s query root type; if the operation was a mutation, this output will be an object of the schema’s mutation root type.

Error object

If unsuccessful, an errors object will be returned with more details in the extensions object. The error object can contain any of the following objects.

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