Skip to main content

Developers

Dashboard
Dashboard
Rest

Filters

Filters allow applications to refine the charging stations returned by the Tile Service API. Beyond simply hiding non-matching results, certain filters also transform the station data to ensure the response is contextually relevant.

How filters affect data

When a request includes filters, the Tile service performs two distinct operations:

  1. Exclusion of non-matching stationsAny station that does not meet the specified filtering criteria is removed from the response entirely. This operation occurs when station-level filters or EVSE-level filters are used.
  2. Data transformationWhen particular filtering parameters are provided, the Tile Service recalculates some of the station’s dynamic properties. This operation occurs when EVSE-level filters are used.

Implementation

Filter parameters can be appended to the request URL as query strings to any of the Tile Service endpoints (MVT or JSON or Count). If no filters are applied, all available charging stations are returned, and no data transformations are done.

Tile / Filter / Example
bash
https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?{filter_1}&{filter_2}&{filter_n}

Levels

Filters can exist on two levels: EVSE level or station level, each with their own impact and results as described below.

Station level

Filters that evaluate the station’s global attributes. These filters are exclusion-only: exclude non-matching stations but never modify the returned data fields.

amenities · enum · https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?amenities[]=HOTEL
Filter to include only stations that provide the specified amenities.

Possible values

HOTELSHOPPINGBATHROOMSUPERMARKETPLAYGROUNDPHARMACYMUSEUMCOFFEEPARKRESTAURANT
preferred_operators · boolean · https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?preferred_operators=true
Filter to include only stations operated by operators configured as preferred. Preferred operators can be set in project settings within the dashboard.

Possible values

truefalse
hide_excluded_operators · boolean · https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?hide_excluded_operators=true
Filter to exclude stations operated by operators configured as excluded. Excluded operators can be set in project settings within the dashboard.

Possible values

truefalse
operator_ids · string · https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?operator_ids[]=631834841e604d2273ffb2b5&operator_ids[]=64e6979d49ed0ae2316ec052
Filter to include only stations operated by specific operator IDs. Accepts an array of operator IDs.
truck_dedicated · boolean · https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?truck_dedicated=true
Filter to include only stations dedicated or primarily intended for truck charging. Only applicable if the Eco-Movement station database is used; otherwise, it is ignored.

Possible values

truefalse
vehicle_types · enum · https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?vehicle_types[]=VAN&vehicle_types[]=RIGID
Filter to include only stations supporting the specified OCPI vehicle types. All vehicle types are included by default. Only applicable if the Eco-Movement station database is used; otherwise, it is ignored.

Possible values

VANRIGIDTRUCK_WITH_TRAILER

EVSE level

Filters that evaluate the station’s specific charging capabilities. These filters perform exclusion and transformation: non-matching stations are excluded, and matching stations have their dynamic fields recalculated.

minimum_power · integer · https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?minimum_power=50
Filter to include only stations where at least one connector meets or exceeds the specified power value (in kW). Accepts an integer greater than 0.
maximum_power · integer · https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?maximum_power=150
Filter to include only stations where the maximum charging power of any connector does not exceed the specified power value (in kW). Accepts an integer greater than 0.
minimum_energy_price · number · Beta This filter is in beta and may change before it becomes stable. · https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?minimum_energy_price=0.2&currency=EUR
Filter to include only stations whose compatible connectors have at least one active price greater than or equal to the specified value, evaluated in the currency set by currency. See station pricing.
maximum_energy_price · number · Beta This filter is in beta and may change before it becomes stable. · https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?maximum_energy_price=0.5&currency=EUR
Filter to include only stations whose compatible connectors have at least one active price lower than or equal to the specified value, evaluated in the currency set by currency. See station pricing.
connectors · enum · https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?connectors[]=CHADEMO
Filter to include only stations that have EVSEs with the specified connector types. Accepts an array of strings with any OCPI 2.2.1 connector values.

Possible values

CHADEMODOMESTIC_ADOMESTIC_BDOMESTIC_CDOMESTIC_DDOMESTIC_EDOMESTIC_FDOMESTIC_GDOMESTIC_HDOMESTIC_IDOMESTIC_JDOMESTIC_KDOMESTIC_LDOMESTIC_MDOMESTIC_NDOMESTIC_OIEC_60309_2_single_16IEC_60309_2_three_16IEC_60309_2_three_32IEC_60309_2_three_64IEC_62196_T1IEC_62196_T1_COMBOIEC_62196_T2IEC_62196_T2_COMBOIEC_62196_T3AIEC_62196_T3CPANTOGRAPH_BOTTOM_UPPANTOGRAPH_TOP_DOWNTESLA_RTESLA_SGB_TCHAOJINEMA_5_20NEMA_6_30NEMA_6_50NEMA_10_30NEMA_10_50NEMA_14_30NEMA_14_50
evse_statuses · enum · https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?evse_statuses[]=AVAILABLE&evse_statuses[]=CHARGING
Filter to include only stations with EVSEs that have the specified statuses.

Possible values

BLOCKEDPLANNEDAVAILABLECHARGINGUNKNOWNRESERVEDOUT_OF_ORDERINOPERATIVE

Currency conversion

The currency query parameter is supported across the Tile Service endpoint (tile.json, tile.mvt and count). It sets the currency of the energy prices that are returned and filtered on.

  • When currency is omitted, connector_minimum_energy_price and connector_maximum_energy_price are returned in EUR.
  • When currency is a valid ISO 4217 currency code, such as USD, GBP, DKK or EUR:
    • The values returned in connector_minimum_energy_price and connector_maximum_energy_price are converted from their source currency into the requested currency on the server, using the active conversion rate.
    • The minimum_energy_price and maximum_energy_price filters are evaluated against the converted prices in the requested currency, or in EUR if currency is omitted.
  • When the original currency is the same as the requested currency, price_conversion_rate is returned as 1.0.
  • When currency is not a valid ISO 4217 currency code, the tile service returns an error with these details:
    • Status: 400 Bad Request
    • Code: TILE_INVALID_PARAMETER_VALUE
    • Message: Invalid parameter 'currency': found string {invalid currency} but expected one of {supported currencies}.
Example URL
bash
https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?maximum_energy_price=0.5&currency=USD

Examples

To display the behavior, examples have been provided for filtering and data transformations below.

Filter examples

Filters can exist on two levels: EVSE level or station level, each with their own impact and results as described below.

Same filter type, different values
Example URL
bash
https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?connectors[]=IEC_62196_T1_COMBO&connectors[]=CHADEMO
StationPropertiesMatches
A2x IEC_62196_T1_COMBO
1x CHAdeMO
1x TOILET
1x RESTAURANT		Matching reason Has CHAdeMO charger
B1x IEC_62196_T1_COMBO
1x IEC_62196_T2_COMBO
1x RESTAURANT		Title The description text
C2x IEC_62196_T2_COMBO
1x TOILET		Title The description text
Multiple different filter types
Example URL
bash
https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?minimum_power=120&evse_statuses[]=AVAILABLE&connectors[]=IEC_62196_T1_COMBO
StationPropertiesMatches
A2x IEC_62196_T1_COMBO
1x CHAdeMO
1x TOILET
1x RESTAURANT		Title The description text
B1x IEC_62196_T1_COMBO
1x IEC_62196_T2_COMBO
1x RESTAURANT		Title The description text
C2x IEC_62196_T2_COMBO
1x TOILET		Title The description text

Data transformation examples

Some outputs are recalculated when EVSE-level filters are applied. These fields are “transformed” to ignore connectors that don’t match the user’s search criteria. These “dynamic” output fields are connector_maximum_power, connector_minimum_energy_price, connector_maximum_energy_price and evse_status_*.

Same filter type, different values The request includes a CHADEMO connector filter. The station is included because it has a CHADEMO connector, but the dynamic fields are transformed to ignore the Combo Type 1 chargers.

Example URL
bash
https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?connectors[]=IEC_62196_T1_COMBO&connectors[]=CHADEMO
Response
json
{  "id": "station_a",  // Static: Remains 150 kW (This represents the station maximum power across all connectors)  "station_maximum_power": 150,  // Dynamic: Adjusted to 100 kW (Max power of the CHADEMO connector)  "connector_maximum_power": 100,  // Dynamic: Counts the 1 CHADEMO chargers  "evse_status_out_of_order": 0,  // Dynamic: 0, because the charging Type 1 plugs are filtered out  "evse_status_available": 1}

Price filters The request includes a maximum_energy_price filter, optionally combined with other EVSE-level filters. A connector only matches when it meets all filters at once, and the dynamic price fields are recalculated for the matching connectors only.

Baseline station A

  • EVSE 1: CCS • 150 kW • Available • 0.65 €
  • EVSE 2: CCS • 50 kW • Available • 0.35 €
  • EVSE 3: Type 2 • 22 kW • Available • 0.25 €

Scenario 1: price filter only

Example URL
bash
https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?maximum_energy_price=0.40

Match: EVSE 2 and 3 qualify. EVSE 1 is excluded.

Response
json
{  "connector_maximum_power": 50,  "evse_status_available": 2,  // Dynamic: lowest price of the matching connectors, not of the entire station  "connector_minimum_energy_price": 0.25,  // Dynamic: highest price of the matching connectors, not of the entire station  "connector_maximum_energy_price": 0.35}

Scenario 2: connector filter only

Example URL
bash
https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?connectors[]=CCS

Match: EVSE 1 and 2 qualify.

Response
json
{  "connector_maximum_power": 150,  "evse_status_available": 2,  // Dynamic: lowest price of the CCS connectors  "connector_minimum_energy_price": 0.35,  // Dynamic: highest price of the CCS connectors  "connector_maximum_energy_price": 0.65}

Scenario 3: price and connector filter

Example URL
bash
https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?connectors[]=CCS&maximum_energy_price=0.30

Match:

  • Evaluates on connector == CCS AND price <= 0.30.
  • The CCS connectors (EVSE 1 and 2) cost 0.65 € and 0.35 €, so they fail the price filter.
  • The Type 2 connector (EVSE 3) meets the price, but fails the connector filter.

Result: Excluded station (0 matching EVSEs).

Scenario 4: price and power filter

Example URL
bash
https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?minimum_power=100&maximum_energy_price=0.40

Match:

  • Evaluates on power >= 100 kW AND price <= 0.40 € on the same EVSE.
  • The 150 kW connector is too expensive (0.65 €).
  • The cheaper connectors (0.25 € to 0.35 €) are too slow (50 kW or less).

Result: Excluded station (0 matching EVSEs).

Was this content helpful?

Build

Developers

Updates

Resources

Legal

Reach out

Chargetrip ©

Status unknown

Manage cookies

Effective: 20th March, 2024 · Updated: 1 September, 2026

We use cookies to help improve your experience of developers.chargetrip.com. This cookie policy is part of the privacy policy, and covers the use of cookies between your device and our site. We also provide basic information on third-party services we may use, who may also use cookies as part of their service, though they are not covered by our policy.

If you don’t wish to accept any cookies from us, you should instruct your browser to refuse cookies from developers.chargetrip.com, with the understanding that we may be unable to provide you with some of your desired content and services.

A cookie is a small piece of data that a website stores on your device when you visit, typically containing information about the website itself, a unique identifier that allows the site to recognize your web browser when you return, additional data that serves the purpose of the cookie itself, and the lifespan of the cookie itself.

Cookies are used to enable certain features (e.g. logging in), to track site usage (e.g. analytics), to store your user settings (e.g. timezone, notification preferences), and to personalize your content (e.g. advertising, language).

Cookies set by the website you are visiting are normally referred to as “first-party cookies,” and typically only track your activity on that particular site. Cookies set by other sites and companies (i.e. third parties) can be used to track you on other websites that use the same third-party service.

Essential cookies

Cookies set by the website you are visiting are normally referred to as “first-party cookies,” and typically only track your activity on that particular site. Cookies set by other sites and companies (i.e. third parties) can be used to track you on other websites that use the same third-party service.

Performance cookies

Targeting / advertising cookies are used in determining what promotional content is more relevant and appropriate to you and your interests. Websites may use them to deliver targeted advertising or to limit the number of times you see an advertisement. This helps companies improve the effectiveness of their campaigns and the quality of content presented to you. These cookies may be set by the website you’re visiting (first-party) or by third-party services. Targeting/advertising cookies set by third parties may be used to track you on other websites that use the same third-party service. We use targeting/advertising cookies on our site.

Marketing / advertising cookies

Targeting / advertising cookies are used in determining what promotional content is more relevant and appropriate to you and your interests. Websites may use them to deliver targeted advertising or to limit the number of times you see an advertisement. This helps companies improve the effectiveness of their campaigns and the quality of content presented to you. These cookies may be set by the website you’re visiting (first-party) or by third-party services. Targeting/advertising cookies set by third parties may be used to track you on other websites that use the same third-party service. We use targeting/advertising cookies on our site.

Third party promise

We review the privacy policies of all our third-party providers before enlisting their services to ensure their practices align with ours. We will never knowingly include third-party services that compromise or violate the privacy of our users.

Cookie
google-cookie-consent
Description
Stores your cookie preferences, meaning which categories you have accepted or declined, so we can respect your choice on every visit and only load the analytics or marketing tools you have allowed.
Lifetime
2 years

How you can control or opt out of cookies

If you do not wish to accept cookies from us, you can instruct your browser to refuse cookies from our website. Most browsers are configured to accept cookies by default, but you can update these settings to either refuse cookies altogether or to notify you when a website is trying to set a cookie.

If you browse websites from multiple devices, you may need to update your settings on each individual device.

Although some cookies can be blocked with little impact on the experience of a website, blocking all cookies may mean you are unable to access certain features and content across the sites you visit.

We may update this Cookie Policy from time to time in order to reflect, for example, changes to the cookies we use or for other operational, legal, or regulatory reasons. Please re-visit this Cookie Policy to stay informed about our use of cookies and related technologies. The date at the top of this Cookie Policy indicates when it was last updated.