IBGE Estados

Laden Sie die 27 föderativen Einheiten aus der IBGE-Lokalitäten-API und vergleichen Sie id, Kürzel, Name und Region in einer Liste.

Offizielle Dokumentation

Aktuelle öffentliche Antwort

Laden Sie die Liste und lesen Sie id, sigla, nome und regiao zusammen. Die Dokumentation bietet außerdem /api/v1/localidades/estados/{id} für eine Einheit, deren id bereits bekannt ist.

Was die Antwort enthält

Laden Sie die 27 föderativen Einheiten aus der IBGE-Lokalitäten-API und vergleichen Sie id, Kürzel, Name und Region in einer Liste.

Die Liste hilft bei der Standardisierung räumlicher Angaben, bestätigt aber weder Adresse, Gemeinde, Postleitzahl, Liefergebiet, Telefonvorwahl, Wohnort noch den aktuellen Standort einer Person. Nutzen Sie für einen konkreten Fall eine zum Zweck passende Quelle und vollständige Ortsdaten.

Felder, die wichtig sind

id: Code der föderativen Einheit
sigla: zweibuchstabiges Kürzel
nome: Name der föderativen Einheit
regiao: id, Kürzel und Name

Was jeder Datensatz enthält

Die Staatenliste liefert 27 föderative Einheiten. In jedem Datensatz ist id der von der API verwendete numerische Code, sigla kennzeichnet die UF mit zwei Buchstaben und nome nennt die Bezeichnung. Das Objekt regiao besitzt eine weitere id, sigla und nome für die brasilianische Region der Einheit.

Verwechseln Sie die id des Staates nicht mit der id in regiao.
Verwenden Sie sigla, wenn ein Feld eine UF verlangt, etwa GO oder SP.
Nutzen Sie nome zur Anzeige und id, wenn eine Integration den API-Code benötigt.

Eine Einheit abfragen

Der Button dieser Seite lädt die vollständige Liste, sodass Sie ein Kürzel neben Name und Region prüfen können. Wenn die id bekannt ist, zeigt die IBGE-Dokumentation /api/v1/localidades/estados/{id}; zum Beispiel liefert die Abfrage 52 Goiás.

Vergleichen Sie den vollständigen Datensatz, bevor Sie eine Kennung kopieren.
Suchen Sie eine Einheit nach Namen und bestätigen Sie das Kürzel im selben Eintrag.
Nutzen Sie die id-Route erst, nachdem Sie den Code aus der Quelle erhalten haben.

Grenzen der Klassifikation

Die Region in der Antwort ist eine territoriale Klassifikation des IBGE. Sie sagt nicht, wo jemand wohnt, berechnet keine Entfernung und ersetzt weder vollständige Adresse noch Postleitzahl oder Gemeindesuche. Für Logistik, Service oder Registrierung verbinden Sie die Staatsreferenz mit einer Quelle für den konkreten Ort.

Leiten Sie keine Gemeinde oder Nachbarschaft aus einem UF-Kürzel ab.
Nutzen Sie die Liste nicht zur Prüfung eines Liefergebiets.
Bestätigen Sie Adressen mit einer für den konkreten Fall passenden Quelle.