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 auch einen JSON-Anfragetext an die Anfrage übergeben, definiert die zu überprüfende Adresse. 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.

Weitere Informationen finden Sie im Referenzleitfaden unter PostalAddress.

Option USPS CASSTM

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. Maximieren Sie optional Standardparameter anzeigen und legen Sie das fields fest. Parameter auf das Feld Maske.

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, die Sie für die Anfrage verwenden möchten.

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