Anfrage zur Adressbestätigung senden

Senden Sie eine Anfrage zur Adressbestätigung, indem Sie eine POST-Anfrage an einen der folgenden Endpunkte senden:

• 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 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 es als Element im addressLines-Array angeben:

{
  "address": {
    "regionCode": "US",
    "addressLines": ["1600 Amphitheatre Pkwy", "Mountain View, CA, 94043"]
  },
}

Testen!

Felder für Adressanfragen

Der Anfragetext besteht aus einem einzelnen Feld:

• address: 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. Wird es jedoch weggelassen, leitet die Address Validation API die Region aus der Adresse ab. Die besten Ergebnisse erzielen Sie jedoch, wenn Sie die regionCode angeben, falls 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®)¹ unterhält das Coding Accuracy Support System (CASSTM), um Anbieter von Adressvalidierung zu unterstützen und zu zertifizieren.

Nur für die Regionen USA und PR können Sie die CASS-Verarbeitung aktivieren, indem Sie im Anfragetext enableUspsCass auf true setzen. Die besten Ergebnisse bei der Verwendung von CASS werden erzielt, wenn Sie eine Adresse angeben, die die Straße und Hausnummer sowie die Stadt, 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 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. 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-Steuerfeld auf das Symbol zum Maximieren , um das Fenster des API Explorers zu maximieren.