Anfrage zur Adressbestätigung senden

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

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"]
  },
}

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

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®)1 unterstützt und zertifiziert Adressvalidierungsanbieter mit dem Coding Accuracy Support System (CASS™).

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
}

Testen!

Mit dem APIs 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 api aus.

  2. Bearbeiten Sie optional die Anfrageparameter.

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

  4. Klicken Sie im Bereich „APIs Explorer“ auf das Symbol für Vollbildmodus fullscreen, um das Fenster „APIs 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™. ↩

Zurück
OAuth verwenden
Weiter
Grundlegende Antwort verstehen