Anfrage zur Adressbestätigung senden

Entwickler im Europäischen Wirtschaftsraum (EWR)

Senden Sie eine Address Validation-Anfrage, indem Sie eine POST-Anfrage an einen der folgenden Endpunkte senden:

Ihre Anfrage sollte auch 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 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 einzelnen Feld:

  • address: Ein 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. Wenn es weggelassen wird, leitet die Address Validation API die Region aus der Adresse ab. Die besten Ergebnisse erzielen Sie jedoch, wenn Sie die regionCode angeben, sofern Sie sie kennen. Eine Liste der unterstützten Regionen finden Sie unter Unterstützte Regionen.
  • addressLines: Erforderlich. Ein Array mit Adressen, die die untere Struktur der Adresse beschreiben.
Weitere Informationen finden Sie im Referenzhandbuch unter PostalAddress.

Option „USPS CASS™“

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

Nur für die Regionen USA und Puerto Rico können Sie die CASS-Verarbeitung aktivieren, indem Sie im Anfragetext enableUspsCass auf true setzen. Die besten Ergebnisse mit CASS erzielen Sie, wenn Sie eine Adresse mit Straße und Hausnummer sowie Ort, Bundesstaat und Postleitzahl angeben:

{
  "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 erstellen, 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. Wählen Sie den Button Ausführen aus. Wählen Sie im Dialogfeld das Konto aus, das Sie für die Anfrage verwenden möchten.

  4. Wählen Sie im APIs Explorer-Bereich das Vollbildsymbol fullscreen aus, um das APIs Explorer-Fenster 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™. ↩