Filter

Mit Filtern können Anwendungen die von der Tile-Service-API zurückgegebenen Ladestationen verfeinern. Über das reine Ausblenden nicht passender Ergebnisse hinaus transformieren bestimmte Filter auch die Stationsdaten, damit die Antwort kontextuell relevant ist.

Wie Filter die Daten beeinflussen

Wenn eine Anfrage Filter enthält, führt der Tile-Service zwei unterschiedliche Operationen aus:

1. Ausschluss nicht passender StationenJede Station, die die angegebenen Filterkriterien nicht erfüllt, wird vollständig aus der Antwort entfernt. Diese Operation findet statt, wenn Filter auf Stationsebene oder auf EVSE-Ebene verwendet werden.
2. DatentransformationWenn bestimmte Filterparameter angegeben sind, berechnet der Tile-Service einige dynamische Eigenschaften der Station neu. Diese Operation findet statt, wenn Filter auf EVSE-Ebene verwendet werden.

Implementierung

Filterparameter können als Query-Strings an die Anfrage-URL jedes Endpunkts des Tile-Service (MVT, JSON oder Anzahl) angehängt werden. Werden keine Filter angewendet, werden alle verfügbaren Ladestationen zurückgegeben und es erfolgen keine Datentransformationen.

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

Ebenen

Filter können auf zwei Ebenen existieren: auf EVSE-Ebene oder auf Stationsebene, jeweils mit eigenen Auswirkungen und Ergebnissen, wie unten beschrieben.

Stationsebene

Filter, die die globalen Attribute der Station auswerten. Diese Filter schließen nur aus: Sie schließen nicht passende Stationen aus, verändern aber nie die zurückgegebenen Datenfelder.

amenities · enum · Show example urlhttps://api.chargetrip.io/v2/station/10/516/352/tile.mvt?amenities[]=HOTEL

Filter, der nur Stationen einschließt, die die angegebenen Ausstattungen bieten.

Mögliche Werte

HOTELSHOPPINGBATHROOMSUPERMARKETPLAYGROUNDPHARMACYMUSEUMCOFFEEPARKRESTAURANT

preferred_operators · boolean · Show example urlhttps://api.chargetrip.io/v2/station/10/516/352/tile.mvt?preferred_operators=true

Filter, der nur Stationen einschließt, die von als bevorzugt konfigurierten Betreibern betrieben werden. Bevorzugte Betreiber können in den Projekteinstellungen im Dashboard festgelegt werden.

Mögliche Werte

truefalse

hide_excluded_operators · boolean · Show example urlhttps://api.chargetrip.io/v2/station/10/516/352/tile.mvt?hide_excluded_operators=true

Filter, der Stationen ausschließt, die von als ausgeschlossen konfigurierten Betreibern betrieben werden. Ausgeschlossene Betreiber können in den Projekteinstellungen im Dashboard festgelegt werden.

Mögliche Werte

truefalse

operator_ids · string · Show example urlhttps://api.chargetrip.io/v2/station/10/516/352/tile.mvt?operator_ids[]=631834841e604d2273ffb2b5&operator_ids[]=64e6979d49ed0ae2316ec052

Filter, der nur Stationen einschließt, die von bestimmten Betreiber-IDs betrieben werden. Akzeptiert ein Array von Betreiber-IDs.

truck_dedicated · boolean · Beispiel-URL anzeigenhttps://api.chargetrip.io/v2/station/10/516/352/tile.mvt?truck_dedicated=true

Filtert so, dass nur Stationen enthalten sind, die speziell oder hauptsächlich zum Laden von Lkw vorgesehen sind. Nur anwendbar, wenn die Eco-Movement-Stationsdatenbank verwendet wird, andernfalls wird er ignoriert.

Mögliche Werte

truefalse

vehicle_types · enum · Beispiel-URL anzeigenhttps://api.chargetrip.io/v2/station/10/516/352/tile.mvt?vehicle_types[]=VAN&vehicle_types[]=RIGID

Filtert so, dass nur Stationen enthalten sind, die die angegebenen OCPI-Fahrzeugtypen unterstützen. Standardmäßig sind alle Fahrzeugtypen enthalten. Nur anwendbar, wenn die Eco-Movement-Stationsdatenbank verwendet wird, andernfalls wird er ignoriert.

Mögliche Werte

VANRIGIDTRUCK_WITH_TRAILER

EVSE-Ebene

Filter, die die spezifischen Lademöglichkeiten der Station auswerten. Diese Filter schließen aus und transformieren: Nicht passende Stationen werden ausgeschlossen, und bei passenden Stationen werden die dynamischen Felder neu berechnet.

minimum_power · integer · Show example urlhttps://api.chargetrip.io/v2/station/10/516/352/tile.mvt?minimum_power=50

Filter, der nur Stationen einschließt, bei denen mindestens ein Anschluss den angegebenen Leistungswert (in kW) erreicht oder überschreitet. Akzeptiert eine ganze Zahl größer als 0.

maximum_power · integer · Show example urlhttps://api.chargetrip.io/v2/station/10/516/352/tile.mvt?maximum_power=150

Filter, der nur Stationen einschließt, bei denen die maximale Ladeleistung keines Anschlusses den angegebenen Leistungswert (in kW) überschreitet. Akzeptiert eine ganze Zahl größer als 0.

minimum_energy_price · number · betaBeta Dieser Filter befindet sich in der Beta-Phase und kann sich ändern, bevor er stabil wird. · Beispiel-URL anzeigenhttps://api.chargetrip.io/v2/station/10/516/352/tile.mvt?minimum_energy_price=0.2&currency=EUR

Filtert so, dass nur Stationen enthalten sind, deren kompatible Anschlüsse mindestens einen aktiven Preis haben, der größer oder gleich dem angegebenen Wert ist, ausgewertet in der über currency festgelegten Währung. Siehe Stationspreise. Nur anwendbar, wenn die Eco-Movement-Stationsdatenbank verwendet wird, andernfalls wird er ignoriert.

maximum_energy_price · number · betaBeta Dieser Filter befindet sich in der Beta-Phase und kann sich ändern, bevor er stabil wird. · Beispiel-URL anzeigenhttps://api.chargetrip.io/v2/station/10/516/352/tile.mvt?maximum_energy_price=0.5&currency=EUR

Filtert so, dass nur Stationen enthalten sind, deren kompatible Anschlüsse mindestens einen aktiven Preis haben, der kleiner oder gleich dem angegebenen Wert ist, ausgewertet in der über currency festgelegten Währung. Siehe Stationspreise. Nur anwendbar, wenn die Eco-Movement-Stationsdatenbank verwendet wird, andernfalls wird er ignoriert.

connectors · enum · Show example urlhttps://api.chargetrip.io/v2/station/10/516/352/tile.mvt?connectors[]=CHADEMO

Filter, der nur Stationen einschließt, die EVSEs mit den angegebenen Anschlusstypen haben. Akzeptiert ein Array von Strings mit beliebigen OCPI-2.2.1-Anschlusswerten.

Mögliche Werte

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 · Show example urlhttps://api.chargetrip.io/v2/station/10/516/352/tile.mvt?evse_statuses[]=AVAILABLE&evse_statuses[]=CHARGING

Filter, der nur Stationen einschließt, deren EVSEs die angegebenen Status haben.

Mögliche Werte

BLOCKEDPLANNEDAVAILABLECHARGINGUNKNOWNRESERVEDOUT_OF_ORDERINOPERATIVE

Währungsumrechnung

Der Query-Parameter currency wird vom Tile-Service-Endpunkt (tile.json, tile.mvt und count) unterstützt. Er legt die Währung der zurückgegebenen und gefilterten Energiepreise fest.

• Wenn currency weggelassen wird, werden connector_minimum_energy_price und connector_maximum_energy_price in EUR zurückgegeben.
• Wenn currency ein gültiger ISO-4217-Währungscode ist, etwa USD, GBP, DKK oder EUR:
  • Die in connector_minimum_energy_price und connector_maximum_energy_price zurückgegebenen Werte werden serverseitig mit dem aktuellen Umrechnungskurs von ihrer Ursprungswährung in die angeforderte Währung umgerechnet.
  • Die Filter minimum_energy_price und maximum_energy_price werden anhand der umgerechneten Preise in der angeforderten Währung ausgewertet, oder in EUR, wenn currency weggelassen wird.
• Wenn die ursprüngliche Währung der angeforderten Währung entspricht, wird price_conversion_rate als 1.0 zurückgegeben.
• Wenn currency kein gültiger ISO-4217-Währungscode ist, gibt der Tile-Service einen Fehler mit diesen Details zurück:
  • Status: 400 Bad Request
  • Code: TILE_INVALID_PARAMETER_VALUE
  • Meldung: Invalid parameter 'currency': found string {invalid currency} but expected one of {supported currencies}.

https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?maximum_energy_price=0.5&currency=USD

Beispiele

Zur Veranschaulichung des Verhaltens finden Sie unten Beispiele für Filterung und Datentransformationen.

Filterbeispiele

Filter können auf zwei Ebenen existieren: auf EVSE-Ebene oder auf Stationsebene, jeweils mit eigenen Auswirkungen und Ergebnissen, wie unten beschrieben.

https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?connectors[]=IEC_62196_T1_COMBO&connectors[]=CHADEMO

https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?minimum_power=120&evse_statuses[]=AVAILABLE&connectors[]=IEC_62196_T1_COMBO

Beispiele zur Datentransformation

Einige Ausgaben werden neu berechnet, wenn Filter auf EVSE-Ebene angewendet werden. Diese Felder werden „transformiert“, damit Anschlüsse ignoriert werden, die nicht den Suchkriterien des Nutzers entsprechen. Diese „dynamischen“ Ausgabefelder sind connector_maximum_power, connector_minimum_energy_price, connector_maximum_energy_price und evses_*.

https://api.chargetrip.io/v2/station/10/516/352/tile.mvt?connectors[]=IEC_62196_T1_COMBO&connectors[]=CHADEMO

{  "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  "evses_out_of_order": 0,  // Dynamic: 0, because the charging Type 1 plugs are filtered out  "evses_available": 1}

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

{  "connector_maximum_power": 50,  "evses_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}

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

{  "connector_maximum_power": 150,  "evses_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}

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

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