Sign in / Sign up
Mapbox Vector Tile Filters

JSON Tile

The JSON API service provides access to geographic data related to stations, organized in a tile-based format.

Base URL

Station data is accessible by sending a GET request to the following endpoint:

Mapbox Vector Tile / Base URL

  • 01
          https://api.chargetrip.io/v2/station/{z}/{x}/{y}/tile.json

URL Parameters

  • {z}: Zoom level (integer) – Determines the scale of the map and the detail of the data returned.
  • {x}: Tile column (integer) – Identifies the X coordinate of the tile in the grid.
  • {y}: Tile row (integer) – Identifies the Y coordinate of the tile in the grid.

Most map providers have built-in methods to convert latitude and longitude to pixel coordinates. To manually convert latitude and longitude coordinates to x and y use the Web Mercator Projection.

Optional Query Parameters

Use these parameters to refine the data returned within each tile:

  • ?{filter}: Filters the stations returned based on specific criteria. See filters documentation.
  • ?stationProperties[]={selector} : Specifies the fields returned for each station feature. See selectors documentation.

Response

The API returns a GeoJSON FeatureCollection. Each feature represents either an individual station or a station cluster and follows the following schema.

FieldDescription
id
String · Optional		The unique identifier of the station.
type
String · Mandatory		Set to "Feature".
geometry
Object · Mandatory		Standard GeoJSON Point geometry
properties
Object · Default		Feature's properties

Properties

The properties object includes the following station-specific attributes.

FieldDescription
count
Integer · default		Count of stations within a cluster. 1 means a Station feature. Greater than 1 means a Cluster feature
expansion_zoom
Integer · default		Zoom level at which a cluster splits into multiple smaller clusters or stations.
station_maximum_power
Integer		Maximum charging power (in kW) across all connectors, regardless of any applied filters.
connector_maximum_power
Integer		Maximum charging power (in kW) available across the filtered connectors. This value is dynamic.
preferred_operator
Boolean		Indicates if the operator of a station is as a preferred operator. Preferred operators can be managed on project level in the Dashboard.
operator_id
String		Operator identifier of the operator of the station. The property will be null if the operator's data is not available.
evse_status_blocked
Integer		Number of EVSEs in blocked status. This value is dynamic.
evse_status_planned
Integer		Number of EVSEs in planned status. This value is dynamic.
evse_status_available
Integer		Number of EVSEs in status available. This value is dynamic.
evse_status_charging
Integer		Number of EVSEs in status charging. This value is dynamic.
evse_status_unknown
Integer		Number of EVSEs in status unknown. This value is dynamic.
evse_status_reserved
Integer		Number of EVSEs in status reserved. This value is dynamic.
evse_status_out_of_order
Integer		Number of EVSEs in status out_of_order. This value is dynamic.
evse_status_inoperative
Integer		Number of EVSEs in status inoperative. This value is dynamic.

Dynamic vs. Static Properties

The properties evse_status_* and connector_maximum_power are dynamic and calculated based on the used filters. If no filters are applied, these properties aggregate data from all EVSEs at the station. All other properties are static and reflect the station’s total configuration, regardless of any applied filters.

Default Response

If no selectors are provided, the API returns a GeoJSON FeatureCollection containing only the essential properties, marked as default in the table. To return additional properties, selectors must be used. Visit the selectors section to learn how to use them.

GeoJSON Tile / Default 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
          {  "type": "FeatureCollection",  "features": [    {      "type": "Feature",      "geometry": {        "type": "Point",        "coordinates": [6.789, 52.234]      },      // Station feature      "properties": {        "count": 1,            }    },     {      "type": "Feature",      "geometry": {        "type": "Point",        "coordinates": [6.723, 50.000]      },      // Cluster Feature      "properties": {                "count": 3,                "expansion_zoom":18             }    }  ]}