Divisions: divisionsByAddress

Sucht nach politischen geografischen Einheiten für eine einzelne Adresse. Jetzt testen

Anfrage

HTTP-Anfrage

GET https://www.googleapis.com/civicinfo/v2/divisionsByAddress

Parameter

Parametername Wert Beschreibung
Optionale Abfrageparameter
address string Die Adresse, die gesucht werden soll.

Anfragetext

Geben Sie bei dieser Methode keinen Anfragetext an.

Antwort

Bei Erfolg gibt diese Methode einen Antworttext mit der folgenden Struktur zurück:

{
  "kind": "civicinfo#divisionsByAddressResponse",
  "normalizedInput": {
    "locationName": string,
    "line1": string,
    "line2": string,
    "line3": string,
    "city": string,
    "state": string,
    "zip": string,
  },
  "divisions": {
    key: {
      "name": string,
        "alsoKnownAs": [
        string
      ],
    },
  }
Name der Eigenschaft Wert Beschreibung Hinweise
kind string

Identifiziert die Art der Ressource.

Wert: der feste String "civicinfo#divisionsByAddressResponse".

normalizedInput nested object Die normalisierte Version der angeforderten Adresse.
normalizedInput.locationName string Der Name des Standorts
normalizedInput.line1 string Der Straßenname und die Hausnummer der Adresse.
normalizedInput.line2 string Die zweite Zeile der Adresse, falls erforderlich.
normalizedInput.line3 string Die dritte Zeile der Adresse, falls erforderlich.
normalizedInput.city string Die Stadt der Adresse.
normalizedInput.state string Die aus zwei Buchstaben bestehende Abkürzung der US-Bundesstaaten für die Adresse.
normalizedInput.zip string Die US-Postleitzahl der Adresse.
divisions object Politische geografische Einheiten, in denen sich die angeforderte Adresse befindet.
divisions.(key) nested object Die eindeutige Open Civic Data-ID (OCD-ID) für die Abteilung.
divisions.(key).alsoKnownAs[] list

Alle anderen gültigen OCD-IDs, die sich auf dieselbe Division beziehen.

Da OCD-IDs für Menschen lesbar und vorhersehbar sind, gibt es gelegentlich mehrere Kennzeichnungen für eine einzelne Division. Diese Kennungen sind als einander gleichwertig definiert und eine davon wird immer als primäre Kennung angegeben. Die primäre Kennung wird in „OCD ID“ zurückgegeben und alle anderen gleichwertigen gültigen Kennungen werden in der Liste zurückgegeben.

Wenn die OCD-ID der folgenden Abteilung beispielsweise ocd-division/country:us/district:dc ist, enthält die Liste ocd-division/country:us/state:dc.

divisions.(key).name string Der Name der Abteilung.

Testen!