Filters

To render stations on a map, you need to add a set of filters to the tile request. These filters are sent as query parameters and must be appended after ?.

Query parameters

Below you can find an overview of possible query parameters you can apply.

powers

Configures the charging speed powers that will be included in the tiles. Accepts all or an array of kWh values.

Show query example

          ?powers=all?powers[]=22&powers[]=43&powers[]=50

powerGroups

Configures the charging speed group powers that will be included in the tiles. There are three StationSpeedType groups available: slow, fast and turbo. You can mix powerGroups with individual powers.

Show query example

          ?powerGroups[]=slow&powerGroups[]=fast&powerGroups[]=turbo?powerGroups[]=fast&powers[]=22

connectors

Configures the connector standards that will be included in the tiles. You can send an array with OCPIConnectorTypes.

Show query example

          ?connectors[]=CHADEMO&connectors[]=IEC_62196_T2_COMBO// Available OCPIConnectorTypes//// - CHADEMO// - DOMESTIC_A// - DOMESTIC_B// - DOMESTIC_C// - DOMESTIC_D// - DOMESTIC_E// - DOMESTIC_F// - DOMESTIC_G// - DOMESTIC_H// - DOMESTIC_I// - DOMESTIC_J// - DOMESTIC_K// - DOMESTIC_L// - DOMESTIC_M// - DOMESTIC_N// - DOMESTIC_O// - IEC_60309_2_single_16// - IEC_60309_2_three_16// - IEC_60309_2_three_32// - IEC_60309_2_three_64// - IEC_62196_T1// - IEC_62196_T1_COMBO// - IEC_62196_T2// - IEC_62196_T2_COMBO// - IEC_62196_T3A// - IEC_62196_T3C// - PANTOGRAPH_BOTTOM_UP// - PANTOGRAPH_TOP_DOWN// - TESLA_R// - TESLA_S// - GB_T// - CHAOJI// - NEMA_5_20// - NEMA_6_30// - NEMA_6_50// - NEMA_10_30// - NEMA_10_50// - NEMA_14_30// - NEMA_14_50

amenities

Configures the amenities that should be present near or at charging stations. Accepts an array of strings with any of the following values:

hotel
shopping
bathroom
supermarket
playground
pharmacy
museum
coffee
park
restaurant

Show query example

          ?amenities[]=hotel

availableOnly

Configures if only available stations should be included in the tiles. Accepts a boolean value.

Show query example

          ?availableOnly=true

preferredOperator

Only allow pre-defined preferred operators to be included in the tile service. Preferred operators can be set in advanced project settings within the dashboard.

Show query example

          ?preferredOperator=true

excludedOperator

Prevent excluded operators to be shown in the tile service. Excluded operators can be set in advanced project settings within the dashboard.

Show query example

          ?excludedOperator=true

Count

You can request the number of displayed stations on the map by using the following API endpoint. If you applied any filters you will need to apply them to the count endpoint as well to make sure you receive the correct count.

Tile Service / Count Request

          https://api.chargetrip.io/station/count.jsonhttps://api.chargetrip.io/station/count.json?powers[]=22&powers[]=43&connectors[]=CHADEMO&connectors[]=IEC_62196_T2_COMBO&amenities[]=restaurant&availableOnly=true

It will return a response that looks like this:

Tile Service / Count Response

          {    "count": 158}