Anfrage zur Adressbestätigung senden

Senden Sie eine Anfrage zur Adressvalidierung, 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 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 Unterfelder enthalten:

• regionCode – Empfohlen. Dies ist ein optionales Feld. Wenn es weggelassen wird, leitet die Address Validation API die Region aus der Adresse ab. Für optimale Ergebnisse sollten Sie die regionCode jedoch angeben, wenn 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.

USPS CASS™-Option

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

Nur für die USA und Puerto Rico können Sie die CASS-Verarbeitung aktivieren, indem Sie im Anfragetext enableUspsCass auf true setzen. Um mit CASS optimale Ergebnisse zu erzielen, geben Sie eine Adresse an, die die Straße und Hausnummer sowie den Ort, 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, das Sie für die Anfrage verwenden möchten.

4. Wählen Sie im Bereich „APIs Explorer“ das Symbol für den Vollbildmodus fullscreen aus, um das APIs Explorer-Fenster zu maximieren.