Sign in / Sign up
Isoline introduction Subscribe to isoline details

Create an isoline

Isolines are an effective way to visualize a vehicle’s range and a powerful tool to combat range anxiety. By letting the end-user select a vehicle and an origin, an isoline can be generated that shows how far the vehicle can drive in all directions from the origin on a single charge. Variables such as weather, taking a ferry or even doing a round-trip can be taken into account and exposed to the end-user. This way the EV's range becomes even more clear. To control response and rendering times, more advanced settings such as the precision and number of polygons can be customized.

Isoline

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

Isoline

Mutation

To start the createIsoline mutation, it is required to provide an origin (longitude, latitude) and a vehicle id. The id can be fetched through the vehicleList query.

  • Season

    • Weather conditions can significantly impact a vehicle’s range, so implementing the season argument is a great way for end-users to gain insight into the performance of the selected EV. The season argument can be set to summer, winter or current. If no season is provided, current weather conditions are applied.

  • Polygon count

    • Use the polygon_count argument to specify the amount of polygons generated for an isoline. By default, this is set to 1 polygon. The maximum amount of polygons is 20. The polygon count can be used to visualize battery percentages. For example, if 5 polygons are used, each polygon will represent 20% of the battery.

  • Quality

    • The quality argument refers to the precision level of the polygons’ edge. A high precision polygon takes longer to generate as opposed to a low precision one. By default, this is set to high.

  • Round trip

    • Use the round_trip argument to indicate if a vehicle should be able to return to the origin from any point in the isoline on a single charge.

  • Climate control

    • Use the climate_control argument to indicate if climate control is on or off during the simulated trip.

  • Ferries

    • Use the ferry_connections argument to indicate if the isoline calculation should take into account ferry connections (none or single); this will impact the total reach of the isoline.

  • Occupants

    • Use the occupants argument to indicate how many occupants are present in the vehicle. By default, this is set to 1.

  • Total occupant weight

    • Use the total_occupants_weight argument to indicate the total weight of the occupants. The type argument can be used to switch between the imperial or metric system. In the case of weight, possible units are kilogram and pound. Source defines whether total occupant weight comes from a manual (default) or telemetry source.

  • Cargo

    • Use the total_cargo_weight argument to indicate the total cargo weight. The type argument can be used to switch between the imperial or metric system. In the case of weight, possible units are kilogram and pound. Source defines whether total cargo weight comes from a manual (default) or telemetry source.

  • State of charge

    • Use the state_of_charge argument to indicate the current state of charge of the vehicle. The type argument can be used to switch between kilometer, mile, kilowatt_hour or percentage as unit. Source defines whether the state of charge comes from a manual (default) or telemetry source.

  • Final state of charge

    • Use the final_state_of_charge argument to indicate how much battery is left at the end of the isoline. By default, this is set to 0%. The type argument can be used to switch between kilometer, mile, kilowatt_hour or percentage as unit.

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.