Filter

Mit Filtern können Anwendungen die Ladestationen eingrenzen, die von der Tile Service API zurückgegeben werden. Neben dem reinen Ausblenden nicht passender Ergebnisse 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 erfolgt, wenn Filter auf Stationsebene oder auf EVSE-Ebene verwendet werden.
2. DatentransformationWenn bestimmte Filterparameter angegeben werden, berechnet der Tile Service einige dynamische Eigenschaften der Station neu. Diese Operation erfolgt, wenn Filter auf EVSE-Ebene verwendet werden.

Implementierung

Filterparameter können als Query-Strings an die Anfrage-URL jedes Tile-Service-Endpoints (MVT, JSON oder Count) angehängt werden. Wenn keine Filter angewendet werden, 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 · Beispiel-URL anzeigenhttps://api.chargetrip.io/v2/station/10/516/352/tile.mvt?amenities[]=HOTEL

Filtert so, dass nur Stationen enthalten sind, die die angegebenen Ausstattungen bieten.

Mögliche Werte

HOTELSHOPPINGBATHROOMSUPERMARKETPLAYGROUNDPHARMACYMUSEUMCOFFEEPARKRESTAURANT

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

Filtert so, dass nur Stationen enthalten sind, die von Betreibern betrieben werden, die als bevorzugt konfiguriert sind. Bevorzugte Betreiber können in den Projekteinstellungen im Dashboard festgelegt werden.

Mögliche Werte

truefalse

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

Filtert so, dass Stationen ausgeschlossen werden, die von Betreibern betrieben werden, die als ausgeschlossen konfiguriert sind. Ausgeschlossene Betreiber können in den Projekteinstellungen im Dashboard festgelegt werden.

Mögliche Werte

truefalse

operator_ids · string · Beispiel-URL anzeigenhttps://api.chargetrip.io/v2/station/10/516/352/tile.mvt?operator_ids[]=631834841e604d2273ffb2b5&operator_ids[]=64e6979d49ed0ae2316ec052

Filtert so, dass nur Stationen enthalten sind, 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 Ladefähigkeiten der Station auswerten. Diese Filter schließen aus und führen eine Transformation durch: Nicht passende Stationen werden ausgeschlossen, und bei passenden Stationen werden die dynamischen Felder neu berechnet.

minimum_power · integer · Beispiel-URL anzeigenhttps://api.chargetrip.io/v2/station/10/516/352/tile.mvt?minimum_power=50

Filtert so, dass nur Stationen enthalten sind, bei denen mindestens ein Anschluss den angegebenen Leistungswert (in kW) erreicht oder überschreitet. Akzeptiert eine ganze Zahl größer als 0.

maximum_power · integer · Beispiel-URL anzeigenhttps://api.chargetrip.io/v2/station/10/516/352/tile.mvt?maximum_power=150

Filtert so, dass nur Stationen enthalten sind, 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.

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.

connectors · enum · Beispiel-URL anzeigenhttps://api.chargetrip.io/v2/station/10/516/352/tile.mvt?connectors[]=CHADEMO

Filtert so, dass nur Stationen enthalten sind, 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 · Beispiel-URL anzeigenhttps://api.chargetrip.io/v2/station/10/516/352/tile.mvt?evse_statuses[]=AVAILABLE&evse_statuses[]=CHARGING

Filtert so, dass nur Stationen enthalten sind, die EVSEs mit den angegebenen Status haben.

Mögliche Werte

BLOCKEDPLANNEDAVAILABLECHARGINGUNKNOWNRESERVEDOUT_OF_ORDERINOPERATIVE

Währungsumrechnung

Der Query-Parameter currency wird vom Tile-Service-Endpoint unterstützt (tile.json, tile.mvt und count). Er legt die Währung der Energiepreise fest, die zurückgegeben und nach denen gefiltert wird.

• 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, bzw. 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 folgenden Details zurück:
  • Status: 400 Bad Request
  • Code: TILE_INVALID_PARAMETER_VALUE
  • Nachricht: 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

Um das Verhalten zu veranschaulichen, finden Sie unten Beispiele für Filter 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 für 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 evse_status_*.

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

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

{  "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}

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

{  "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}

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