Vind de Amerikaanse staat van een locatie of laadpaal met de landsubdivisiecode

Dit artikel is bedoeld voor exploitanten die locatie- en laadpaaladressen ophalen via de Partner API of in exports. Het laat zien waar je de status van een adres kunt vinden en hoe de waarde wordt ingesteld.

Wat de landsubdivisiecode is

Elke locatie en laadpaal heeft een landsubdivisiecode. Deze volgt de ISO 3166-2-standaard en geeft de staat, provincie of regio van het adres aan.

Voor een Amerikaans adres bestaat de code uit US- gevolgd door de tweeletterige staatscode. Bijvoorbeeld: US-GA is Georgia.

Adressen op locaties en laadpalen hebben geen apart staatsveld. Gebruik in plaats daarvan de code.

De code lezen in de Partner API

De Partner API retourneert de code als countrySubdivisionCode.

Resource	Waar je de code kunt vinden
Site	location.address.countrySubdivisionCode
Charge point	location.address.countrySubdivisionCode
Account (team)	address.countrySubdivisionCode

Om de staat van een locatie op te halen:

1. Haal de locatie op via de Partner API.
2. Lees location.address.countrySubdivisionCode in de respons.
3. Splits de waarde bij het koppelteken. Het deel erna is de staatscode, bijvoorbeeld GA.

De waarde is null wanneer Monta geen code heeft voor het adres.

Hoe de code wordt ingesteld

Je voert de code niet zelf in. Monta vult deze automatisch in op basis van het adres wanneer je het adres van een site of laadpaal aanmaakt of bewerkt.

Een laadpaal die aan een site wordt toegevoegd, krijgt de code van die site. Als je een laadpaal eigen coördinaten geeft via de Partner API, zoekt Monta de code voor dat punt op. Als je de pin in Hub verplaatst, wordt de code gewist en vult de nachtelijke backfill deze opnieuw in, maar alleen voor laadpalen in de VS.

Voor oudere adressen in de Verenigde Staten vult Monta de code in via een nachtelijke backfill. Oudere adressen in andere landen blijven leeg totdat het adres opnieuw wordt opgeslagen.

De code gebruiken in exports

Open in Hub Analytics > Data exports en kies de dataset Locations, EVSEs of Accounts. De code is beschikbaar als de kolom Country subdivision code. In het geëxporteerde bestand is de kolomkop country_subdivision_code. Zie Hoe gebruik ik Data exports in Hub? voor meer informatie over het samenstellen en uitvoeren van een export.

Als de code leeg is

Als countrySubdivisionCode null is voor een locatie of laadpaal:

1. Controleer of het adres van de locatie een adres bevat dat Monta kan omzetten.
2. Bewerk en sla het adres opnieuw op. Monta zoekt dan de code op.
3. Als de code nog steeds leeg is, neem dan contact op met Monta support met het locatie- of laadpaal-ID.