Den US-Bundesstaat eines Standorts oder einer Ladestation anhand des Länderunterteilungscodes ermitteln

Dieser Artikel richtet sich an Betreiber, die Standort- und Ladestationsadressen über die Partner-API oder in Exporten abrufen. Er zeigt, wo der Status einer Adresse zu finden ist und wie der Wert gesetzt wird.

Was der Länderuntereinheitscode ist

Jeder Standort und jede Ladestation hat einen Länderuntereinheitscode. Er folgt dem ISO-3166-2-Standard und gibt den Bundesstaat, die Provinz oder die Region der Adresse an.

Bei einer US-Adresse besteht der Code aus US-, gefolgt vom zweistelligen Bundesstaatscode. Zum Beispiel steht US-GA für Georgia.

Adressen von Standorten und Ladestationen haben kein separates Bundesstaatfeld. Verwende stattdessen den Code.

Den Code in der Partner-API lesen

Die Partner-API gibt den Code als countrySubdivisionCode zurück.

Ressource	Wo der Code zu finden ist
Standort	location.address.countrySubdivisionCode
Ladestation	location.address.countrySubdivisionCode
Konto (Team)	address.countrySubdivisionCode

So rufst du den Bundesstaat eines Standorts ab:

1. Rufe den Standort über die Partner-API ab.
2. Lies location.address.countrySubdivisionCode in der Antwort.
3. Teile den Wert am Bindestrich. Der Teil danach ist der Bundesstaatscode, zum Beispiel GA.

Der Wert ist null, wenn Monta keinen Code für die Adresse hat.

Wie der Code festgelegt wird

Du gibst den Code nicht selbst ein. Monta trägt ihn automatisch anhand der Adresse ein, wenn du die Adresse eines Standorts oder einer Ladestation erstellst oder bearbeitest.

Eine Ladestation, die einem Standort hinzugefügt wird, erhält den Code dieses Standorts. Wenn du einer Ladestation über die Partner-API eigene Koordinaten gibst, schlägt Monta den Code für diesen Punkt nach. Wenn du die Markierung in Hub verschiebst, wird der Code gelöscht und die nächtliche Nachbefüllung trägt ihn erneut ein – jedoch nur für Ladestationen in den USA.

Für ältere Adressen in den Vereinigten Staaten trägt Monta den Code durch eine nächtliche Nachbefüllung ein. Ältere Adressen in anderen Ländern bleiben leer, bis die Adresse erneut gespeichert wird.

Den Code in Exporten verwenden

Öffne in Hub Analytics > Datenexporte und wähle den Datensatz Standorte, EVSEs oder Konten. Der Code ist als Spalte Länderunterteilungscode verfügbar. In der exportierten Datei lautet die Spaltenüberschrift country_subdivision_code. Informationen zum Erstellen und Ausführen eines Exports findest du unter Wie verwende ich Datenexporte in Hub?.

Wenn der Code leer ist

Wenn countrySubdivisionCode für einen Standort oder eine Ladestation null ist:

1. Überprüfe, ob die Adresse des Standorts eine Adresse enthält, die Monta auflösen kann.
2. Bearbeite die Adresse und speichere sie erneut. Monta sucht dann den Code nach.
3. Wenn der Code weiterhin leer ist, wende dich mit der Standort- oder Ladestation-ID an den Monta-Support.