Selektoren
Um Netzwerklatenz und Rendering-Leistung zu optimieren, geben die MVT- und JSON-Tile-Services von Chargetrip standardmäßig nur minimale Nutzdaten zurück. Diese Standard-Nutzdaten enthalten die wesentlichen Geometrie- und Clusterdaten, die für das schnelle Rendern von Kartenkacheln benötigt werden.
Mit Selektoren fordern Sie gezielt die Stationsdatenattribute an, die Ihre Client-Anwendung benötigt, ohne unnötigen Overhead bei den Nutzdaten zu verursachen.
Implementierung
Um bestimmte Stationsattribute anzufordern, hängen Sie den Query-Parameter station_properties[] an die URL Ihrer Kachelanfrage an. Wiederholen Sie den Parameter für jeden Selektor, den Sie aufnehmen möchten:
Verfügbare Selektoren
Selektoren gelten nur für Stations-Features. Cluster-Features bleiben unberührt und geben immer count und expansion_zoom zurück.
count·integer· default- Die Anzahl der Stationen innerhalb eines Clusters. Ein Wert von 1 kennzeichnet ein Stations-Feature, ein Wert größer als 1 ein Cluster-Feature.
id·string· default- Die eindeutige Chargetrip-Kennung der Station. Gilt nur für MVT-Kacheln.
lng·float- Der Längengrad der Station. Gilt nur für MVT-Kacheln.
lat·float- Der Breitengrad der Station. Gilt nur für MVT-Kacheln.
operator_id·string- Die eindeutige Chargetrip-Kennung des Betreibers der Station. Wird nicht zurückgegeben, wenn der Betreiber unbekannt ist.
station_maximum_power·integer- Die maximale Ladeleistung (in kW), die an der Station verfügbar ist. Dieser Wert ist statisch und spiegelt unabhängig von Anschlussfiltern immer die höchste Leistungsfähigkeit der Station wider.
connector_maximum_power·integer- Die maximale Ladeleistung (in kW), die von den Anschlüssen bereitgestellt wird, die dem Filter
connectors[]entsprechen. Ist kein Filter angegeben, werden alle Anschlüsse berücksichtigt und der Wert entsprichtstation_maximum_power. preferred_operator·boolean- Gibt an, ob der Betreiber einer Station ein bevorzugter Betreiber ist. Die Betreiberpräferenzen können im Dashboard von Chargetrip verwaltet werden.
connector_minimum_energy_price·float·Beta Dieses Feld befindet sich in der Beta-Phase und kann sich ändern, bevor es stabil wird. - Der niedrigste Energiepreis unter den Anschlüssen der Station. Wird nicht zurückgegeben, wenn nicht verfügbar. Nur anwendbar, wenn die Eco-Movement-Stationsdatenbank verwendet wird, andernfalls wird er ignoriert.
connector_maximum_energy_price·float·Beta Dieses Feld befindet sich in der Beta-Phase und kann sich ändern, bevor es stabil wird. - Der höchste Energiepreis unter den Anschlüssen der Station. Wird nicht zurückgegeben, wenn nicht verfügbar. Nur anwendbar, wenn die Eco-Movement-Stationsdatenbank verwendet wird, andernfalls wird er ignoriert.
price_vat·float·Beta Dieses Feld befindet sich in der Beta-Phase und kann sich ändern, bevor es stabil wird. - Die auf den Preis angewendete Mehrwertsteuer. Wird nicht zurückgegeben, wenn nicht verfügbar. Nur anwendbar, wenn die Eco-Movement-Stationsdatenbank verwendet wird, andernfalls wird er ignoriert.
price_valid_until·string·Beta Dieses Feld befindet sich in der Beta-Phase und kann sich ändern, bevor es stabil wird. - Datum und Uhrzeit, bis zu denen der Preis gültig ist. Wird nicht zurückgegeben, wenn nicht verfügbar. Nur anwendbar, wenn die Eco-Movement-Stationsdatenbank verwendet wird, andernfalls wird er ignoriert.
price_original_currency·string·Beta Dieses Feld befindet sich in der Beta-Phase und kann sich ändern, bevor es stabil wird. - Die Währung, in der der Preis ursprünglich definiert war, vor der Umrechnung in
currency. Wird nicht zurückgegeben, wenn nicht verfügbar. Nur anwendbar, wenn die Eco-Movement-Stationsdatenbank verwendet wird, andernfalls wird er ignoriert. price_conversion_rate·float·Beta Dieses Feld befindet sich in der Beta-Phase und kann sich ändern, bevor es stabil wird. - Der Kurs, mit dem der Preis von seiner ursprünglichen Währung in
currencyumgerechnet wurde. Wird nicht zurückgegeben, wenn nicht verfügbar. Nur anwendbar, wenn die Eco-Movement-Stationsdatenbank verwendet wird, andernfalls wird er ignoriert. evses_blocked·integer- Anzahl der EVSEs, die physisch oder elektronisch blockiert sind. Wenn ein Filter
connectors[]angegeben ist, werden nur blockierte EVSEs gezählt, die mindestens einen der ausgewählten Anschlusstypen haben. evses_planned·integer- Anzahl der EVSEs im Status „planned“. Wenn ein Filter
connectors[]angegeben ist, werden nur geplante EVSEs gezählt, die mindestens einen der ausgewählten Anschlusstypen haben. evses_available·integer- Anzahl der EVSEs im Status „available“. Wenn ein Filter
connectors[]angegeben ist, werden nur verfügbare EVSEs gezählt, die mindestens einen der ausgewählten Anschlusstypen haben. evses_charging·integer- Anzahl der EVSEs, die derzeit belegt sind. Wenn ein Filter
connectors[]angegeben ist, werden nur ladende EVSEs gezählt, die mindestens einen der ausgewählten Anschlusstypen haben. evses_unknown·integer- Anzahl der EVSEs, deren Echtzeitstatus derzeit unbekannt ist. Wenn ein Filter
connectors[]angegeben ist, werden nur EVSEs mit unbekanntem Status gezählt, die mindestens einen der ausgewählten Anschlusstypen haben. evses_reserved·integer- Anzahl der EVSEs, die für einen Fahrer reserviert sind. Wenn ein Filter
connectors[]angegeben ist, werden nur reservierte EVSEs gezählt, die mindestens einen der ausgewählten Anschlusstypen haben. evses_out_of_order·integer- Anzahl der EVSEs, die als außer Betrieb markiert sind. Wenn ein Filter
connectors[]angegeben ist, werden nur außer Betrieb befindliche EVSEs gezählt, die mindestens einen der ausgewählten Anschlusstypen haben. evses_inoperative·integer- Anzahl der EVSEs, die vorübergehend nicht betriebsbereit sind. Wenn ein Filter
connectors[]angegeben ist, werden nur nicht betriebsbereite EVSEs gezählt, die mindestens einen der ausgewählten Anschlusstypen haben.
Beispiele
Stationsleistung und Betreiberpräferenz in JSON-Kacheln anfordern
In JSON-Kacheln bleibt die obligatorische Feature-Struktur (type, geometry, id) bei Stations-Features immer erhalten, während properties nur die angeforderten Selektoren enthält (die Standardeigenschaft count entfällt, da sie nicht angefordert wurde). Cluster-Features bleiben von Selektoren unberührt und geben weiterhin count und expansion_zoom zurück.
Stations-ID, Leistung und Betreiberpräferenz in MVT-Vektorkacheln anfordern
In MVT-Kacheln werden nur explizit angeforderte Selektoren in das Stations-Feature kodiert (die Standardeigenschaft count entfällt), während Cluster-Features von Selektoren unberührt bleiben und immer count und expansion_zoom behalten.
Selektoren mit Anschlussfiltern für den Echtzeit-EVSE-Status kombinieren
Beim Filtern nach einem bestimmten Anschlusstyp (z. B. CCS / IEC_62196_T2_COMBO) berücksichtigen connector_maximum_power und die Anzahl evses_available nur EVSEs, die diesem Anschlussfilter entsprechen.
War dieser Inhalt hilfreich?