Filters
To render stations on a map, a set of filters need to be added to the tile request. These filters are sent as query parameters and must be appended after ?.
Query parameters
An overview of possible query parameters can be found below.
powers
Query parameter that configures the charging speed powers that will be included in the tiles.
Accepts all
or an array of kW values.
powerGroups
Query parameter that configures the charging speed group powers that will be included in the tiles. There are three StationSpeedType groups available: slow
, fast
and turbo
. Power groups can be mixed with individual powers.
connectors
Query parameter that configures the connector standards that will be included in the tiles. Accepts an array with OCPIConnectorTypes
.
amenities
Query parameter that 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
availableOnly
Query parameter that configures if only available stations should be included in the tiles. Accepts a boolean value. By default it is set to false.
preferredOperator
Query parameter that configures if only pre-defined preferred operators should be included in the tiles. Accepts a boolean value. Preferred operators can be set in advanced project settings within the dashboard. By default it is set to false.
excludedOperator
Query parameter that prevents excluded operators to be shown in the tiles. Accepts a boolean value. Excluded operators can be set in advanced project settings within the dashboard. By default it is set to false.
publicOnly
Query parameter that configures if only public stations should be included in the tiles. Accepts a boolean value. Only applies if the Eco-Movement station database is being used, otherwise it is ignored. By default it is set to false.
operatorIds
Query parameter that configures the operators that will be included in the tiles. Accepts an array with operator ids.
Count
The number of displayed stations on the map can be requested by using the following API endpoint. Any filters need to be applied to the count endpoint as well to make sure the correct count is returned.
Tile Service / Count Request
- 01
- 02
https://api.chargetrip.io/station/count.json
https://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
- 01
- 02
- 03
{
"count": 158
}