Sections

Sign in / Sign up
Introduction Subscribe to isoline details

Create an isoline

To get started with isolines, you will first need to fetch an isoline ID. This isoline ID can then be sent to subscribe to an isoline and retrieve the isoline data.

Isoline

Show the distance a vehicle is able to go from a certain location

Isoline

Mutation

To get an isoline ID, you will need to provide us with a vehicle ID, an origin location and a polygon count. If no polygon count is given 1 polygon will be generated. Additionally, you can provide us with the season. If no season is provided, current weather conditions will be used for the calculation.

  • Season

    • If you want to request an isoline during a specific season you can use the season property in the isoline mutation. The season can be set to summer, winter and current. If no season is provided current weather conditions will apply.

  • Polygon count

    • You can set the number of polygons to be generated. You can go up to a hundred polygons for a more detailed isoline. By default the count is set to zero.

The isoline mutation is currently released as a beta product and thus experimental. Anything within the isoline product and roadmap may change, break, or disappear at any time.

Arguments

input • IsolineInput

• Required

Isoline input

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_INVALID_NUMBER_OF_POLYGONS

Field polygon_count should be a value between 1 and 20

Error

ISOLINE_LIMIT_EXCEEDED

Isoline query limit exceeded