MVT

The MVT (Mapbox Vector Tile) service provides access to station-related geographic data in a tile-based format. Vector tiles are encoded as Protocol Buffers (PBF), allowing for efficient serialization of structured data.

Base URL

To access the station data in MVT format, send a request to the following endpoint

Mapbox Vector Tile / Base URL

          https://api.chargetrip.io/v2/station/{z}/{x}/{y}/tile.mvt

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

For each requested tile, the API returns a station layer containing a collection of features. Each feature represents either an individual station or a cluster of stations, depending on the zoom level and station density in the area, along with several additional properties.

Properties

Field	Description
count Integer · default	The count of stations within a cluster. count of 1 means a Station feature, where count greater than 1 means a Cluster feature
expansion_zoom Integer · default	The zoom level at which a cluster splits into multiple smaller clusters or stations.
id String	The identifier of the station.
lng Float	The longitude of the station.
lat Float	The latitude of the station.
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.

Default Response

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

Mapbox Vector Tile / Default selectors response

          //Station feature{  "count": 1,} //Cluster Feature{     "count": 3,  "expansion_zoom":32}