Anfrage zur Adressbestätigung senden

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

• validateAddress (REST)
• ValidateAddress (gRPC)

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 Unterbereiche:

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 in addressLines-Array:

{
  "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 unter mindestens einen Eintrag in addressLines.

Wenn Sie das Feld address an die Address Validation API senden, benötigen Sie nur ein Feld angeben: addressLines. Die einfachste Adressanfrage sollte die folgenden untergeordneten Felder enthalten:

• regionCode – empfohlen. Dies ist ein optionales Feld. Wird es jedoch weggelassen, Die Address Validation API leitet die Region von der Adresse ab. Um jedoch enthalten die regionCode, sofern Sie sie kennen. Eine Liste der unterstützten Regionen finden Sie unter Unterstützte Regionen.
• addressLines: Erforderlich. Ein Array mit Adressen, die den unteren Struktur der Adresse.

USPS CASS™-Option

Der United States Postal Service® (USPS®)¹ verwaltet die Coding Accuracy Support System (CASSTM) zur Unterstützung und Zertifizierung Anbietern von Adressen überprüfen.

Nur für die USA und PR-Regionen können Sie die CASS-Verarbeitung aktivieren, indem Sie enableUspsCass bis true im Anfragetext. Für optimale Ergebnisse bei der Verwendung von CASS eine Adresse mit Straße und Hausnummer sowie die Stadt, das Bundesland und die Postleitzahl:

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

Testen!

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

1. Klicken Sie auf das API-Symbol . rechts auf der Seite.

2. Optional können Sie Standardparameter anzeigen maximieren und den Parameter fields auf die Feldmaske festlegen.

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 auf das Symbol zum Maximieren , um das API Explorer-Fenster zu maximieren.