Anfrage zur Adressbestätigung senden

Senden Sie eine Anfrage zur Adressüberprüfung, indem Sie eine POST-Anfrage an einen der folgenden Endpunkte senden:

• validateAddress (REST)
• ValidateAddress (gRPC)

Ihre Anfrage sollte auch einen JSON-Anfragetext an die Anfrage übergeben, in dem die zu validierende Adresse definiert wird. Der folgende Anfragetext enthält ein Feld und drei Unterfelder:

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

Testen!

Felder der Adressanfrage

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 Unterfelder enthalten:

• regionCode – empfohlen. Dieses Feld ist optional. Wenn Sie es jedoch nicht angeben, leitet die Address Validation API die Region von der Adresse ab. Die besten Ergebnisse erzielen Sie jedoch, wenn Sie regionCode angeben, sofern Sie es 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 Referenzleitfaden unter PostalAddress.

Option USPS CASSTM

Der United States Postal Service® (USPS®)¹ unterhält das Coding Accuracy Support System (CASSTM), um Anbieter von Adressvalidierung zu unterstützen und zu zertifizieren.

Nur für die USA und die PR-Region können Sie die CASS-Verarbeitung aktivieren, indem Sie im Anfragetext enableUspsCass auf true setzen. Die besten Ergebnisse bei Verwendung von CASS erzielen Sie, wenn Sie eine Adresse angeben, die Straße und Hausnummer sowie Stadt, Bundesland und Postleitzahl enthält:

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

Jetzt 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. Erweitern 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 Execute (Ausführen). Wählen Sie im Dialogfeld das Konto aus, das Sie für die Anfrage verwenden möchten.

5. Klicken Sie im Bereich „API Explorer“ auf das Symbol zum Maximieren (), um das API Explorer-Fenster zu maximieren.