Anfrage zur Adressbestätigung senden

Senden Sie eine Anfrage zur Adressbestätigung, indem Sie eine POST-Anfrage an einen der folgenden Endpunkte senden:

• validateAddress (REST)
• ValidateAddress (gRPC)

Hinweis: In dieser Dokumentation wird für die Beispiele REST verwendet. Der Ansatz ist jedoch mit gRPC vergleichbar.

Ihre Anfrage sollte außerdem einen JSON-Anfragetext an die Anfrage übergeben, in dem die zu validierende Adresse definiert ist. Der folgende Anfragetext enthält ein Feld und drei untergeordnete Felder:

curl -X POST -d '{
  "address": {
    "regionCode": "US",
    "locality": "Mountain View",
    "addressLines": ["1600 Amphitheatre Pkwy"]
  }
}' \
-H 'Content-Type: application/json' \
"https://addressvalidation.googleapis.com/v1:validateAddress?key=API_KEY"

Sie können locality auch weglassen und es als Element im addressLines-Array angeben:

{
  "address": {
    "regionCode": "US",
    "addressLines": ["1600 Amphitheatre Pkwy", "Mountain View, CA, 94043"]
  },
}

Testen!

Felder für Adressanfragen

Der Anfragetext besteht aus einem einzigen Feld:

• address: Feld vom Typ PostalAddress, das mindestens einen Eintrag in addressLines enthalten muss.

Wenn Sie das Feld address an die Address Validation API senden, müssen Sie nur ein Feld angeben: addressLines. Die einfachste Adressanfrage sollte jedoch die folgenden untergeordneten Felder enthalten:

• regionCode – Empfohlen. Dies ist ein optionales Feld. Wird es jedoch weggelassen, leitet die Address Validation API die Region aus der Adresse ab. Die besten Ergebnisse erzielen Sie jedoch, wenn Sie die regionCode angeben, falls Sie sie kennen. Eine Liste der unterstützten Regionen finden Sie unter Unterstützte Regionen.
• addressLines – erforderlich. Ein Array mit Adressen, die die untergeordnete Struktur der Adresse beschreiben.

Weitere Informationen finden Sie im Leitfaden unter PostalAddress.

USPS CASS™-Option

Der United States Postal Service® (USPS®)¹ unterstützt und zertifiziert Adressvalidierungsanbieter mit dem Coding Accuracy Support System (CASS™).

Hinweis: Die Address Validation API ist als CASS-Certified™-Dienst bestätigt. Das bedeutet, dass der Dienst bestätigt wurde, dass er fehlende Adressinformationen ausfüllen, standardisieren und auf die aktuellste und korrekteste Adresse aktualisieren kann.

Nur für die Regionen USA und PR können Sie die CASS-Verarbeitung aktivieren, indem Sie im Anfragetext enableUspsCass auf true setzen. Für optimale Ergebnisse bei der Verwendung von CASS sollten Sie eine Adresse angeben, die die Straße und Hausnummer sowie die Stadt, den Bundesstaat und die Postleitzahl enthält:

{
  "address": {
    "regionCode": "US",
    "locality": "Mountain View",
    "administrativeArea": "CA",
    "postalCode": "94043",
    "addressLines": ["1600 Amphitheatre Pkwy"]
  },
  "enableUspsCass": true
}

Hinweis: Wenn Sie keine CASS-Verarbeitung benötigen oder Adressen außerhalb der USA und Puerto Rico prüfen, empfiehlt Google nicht, diese Funktion zu aktivieren.

Testen!

Mit dem API Explorer können Sie Beispielanfragen stellen, um sich mit der API und den API-Optionen vertraut zu machen.

1. Wählen Sie rechts auf der Seite das API-Symbol  aus.

2. Maximieren Sie optional Standardparameter anzeigen und legen Sie den Parameter fields auf die Feldmaske fest.

3. Optional können Sie den Anfragetext bearbeiten.

4. Klicken Sie auf die Schaltfläche Ausführen. Wählen Sie im Dialogfeld das Konto aus, mit dem Sie die Anfrage stellen möchten.

5. Klicken Sie im API Explorer-Steuerfeld auf das Symbol zum Maximieren , um das Fenster des API Explorer zu maximieren.

---

1. Die Google Maps Platform ist ein nicht exklusiver Lizenznehmer von United States Postal Service®. Die folgenden Marken sind eingetragene Marken von United States Postal Service® und werden mit dessen Zustimmung verwendet: United States Postal Service®, CASS™, CASS Certified™. ↩