Sections

  • Basics
  • API reference
  • Release notes
  • Deprecations
  • Examples
Sign in / Sign up
    • System
    • Day
    • Night
  • Sign in / Sign up
Mutation to create an isoline
Query isoline details

Subscribe to isolines

After you receive your isoline ID through the isoline mutation, you can start an isoline subscription. The isoline will contain polygons with the coordinates to render each layer. Because isolines take some time to finish, you can use a GraphQL subscription as described in the introduction.

Subscription

To subscription service needs to be initiated with an isoline ID. From there on it will start calculating and, based on your interval, provide you with an isoline status.

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.

Arguments

id • ID

• Required

Frequently used fields

polygons • FeatureMultiPolygon

Shape of the isoline consisting in a list of multipolygons

type • FeatureType

Feature type

Show FeatureType enum values

Feature

geometry • MultiPolygon

Geometry of the feature

type • MultiPolygonType

MultiPolygon type

Show MultiPolygonType enum values

MultiPolygon

coordinates • Float

List of coordinates representing a polygon

properties • PolygonProperties

Properties of the MultiPolygon Feature

index • Int

Index of the feature inside the list

Other fields

id • ID

Isoline id

status • IsolineStatus

Isoline status

Show IsolineStatus enum values

done

Isoline label has been successfully generated

pending

Isoline label is under processing

error

There was an error while generating the isoline label

ferries • FeatureLineString

List of the ferries uniting islands formed by the isoline

type • FeatureType

Feature type

Show FeatureType enum values

Feature

geometry • LineString

Geometry of the feature

type • LineStringType

LineString type

Show LineStringType enum values

LineString

coordinates • Float

List of coordinates arrays with longitude as first value and latitude as second one

origin • FeatureMultiPolygonPoint

Origin point of the request

type • FeatureType

Feature type

Show FeatureType enum values

Feature

geometry • Point

Geometry of the feature

type • PointType

Point type

Show PointType enum values

Point

coordinates • Float

The coordinates array with longitude as first value and latitude as second one

properties • JSON

Optional object where you can store custom data you need in your application.

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

summer

We suppose it is summer and we have the best weather conditions

winter

We suppose it is winter and we have the worst weather conditions

current

We fetch the current weather conditions

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

Request

  • 01
  • 02
  • 03
  • 04
  • 05
  • 06
  • 07
  • 08
  • 09
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
          subscription getIsoline{  isoline( id:"62dea58c3bedd2ce2ee7e26f"){   status    polygons{      type      geometry{        coordinates      }      properties{        index      }    }    polygon_count    season    origin{      geometry{        coordinates      }    }  }}
        

Response

  • 01
  • 02
  • 03
  • 04
  • 05
  • 06
  • 07
  • 08
  • 09
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
          {  "data": {    "isoline": {      "status": "done",      "polygons": [        {          "type": "Feature",          "geometry": {            "coordinates": [              [                [                  8.581592700000002,                  53.009527199999994                ],                [                  8.59715885,                  53.002257799999995                ],                ...                [                  8.6045613,                  52.99412415                ]                     ]            ]          },          "properties": {            "index": 0          }        }      ],      "polygon_count": 1,      "season": "summer",      "origin": {        "geometry": {          "coordinates": [            9.9936818,            53.5510846          ]        }      }    }  }}
        
  • Basics

    API Basics GraphQL Basics EV basics
  • API reference

    API Vehicles Stations Routes Navigation Vehicle connectivity Tile service Isolines
  • Products

    Website Dashboard Help center SDKs
  • Tooling

    Playground Voyager Examples API Status
  • Legal

    Terms & Conditions Privacy Policy Cookie Policy SLA Security
Mission StatementState of chargeTry Chargetrip Go

© Chargetrip 2023

Build with love in

Amsterdam ❤️

API reference

  • API
  • Vehicles
  • Stations
  • Routes
  • Navigation
  • Vehicle connectivity
  • Tile service
  • Isolines

Sections

  • Quick setup guide
  • Pagination
  • Introduction
  • Query vehicles
  • Query vehicle details
  • Query premium vehicle details
  • Introduction
  • Query stations
  • Query station details
  • Query stations around a GeoJSON point
  • Query station reviews
  • Mutate to create a station review
  • Query station operators
  • Query station operator details
  • Query station tariffs
  • Query station tariff details
  • Query station amenities
  • Query station statistics
  • Introduction
  • Mutate to create a new route
  • Subscribe to route updates
  • Query route details
  • Query route path
  • Introduction
  • Mutate to start a new navigation session
  • Subscribe to navigation updates
  • Query navigation session
  • Mutate to update a navigation session
  • Mutate to recalculate navigation
  • Mutate to finish navigation
  • Introduction
  • Mutate to create a new connected vehicle
  • Subscribe to a connected vehicle
  • Mutate to authorize a connected vehicle
  • Query connected vehicle list
  • Query data from vehicle
  • Query connected vehicle
  • Mutate to update a connected vehicle
  • Mutate to remove a connected vehicle
  • Introduction
  • Properties
  • Filters
  • Integration
  • Introduction
  • Mutation to create an isoline
  • Subscribe to isoline details
  • Query isoline details