Anfrage zur Adressbestätigung senden

Wenn Sie eine Anfrage zur Adressüberprüfung senden möchten, stellen Sie eine POST-Anfrage an einen der folgenden Endpunkte:

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

Felder für Adressanfragen

Der Anfragetext besteht aus einem einzigen 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 weglassen, leitet die Address Validation API die Region von der Adresse ab. Die besten Ergebnisse erzielen Sie jedoch, wenn Sie den regionCode einfügen, wenn Sie ihn kennen. Eine Liste der unterstützten Regionen finden Sie unter Unterstützte Regionen.
  • addressLines: Erforderlich. Ein Array mit Adressen, die die Unterstruktur der Adresse beschreiben.
Siehe PostalAddress im Referenzhandbuch.

USPS CASSTM-Option

Der United States Postal Service® (USPS®)1 betreibt das Coding Accuracy Support System (CASSTM), um Anbieter von Adressüberprüfungen zu unterstützen und zu zertifizieren.

Nur für US- und PR-Regionen können Sie die CASS-Verarbeitung aktivieren. Dazu setzen Sie enableUspsCass im Anfragetext auf true. 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
}

  1. Die Google Maps Platform ist ein nicht-exklusiver Lizenznehmer des United States Postal Service®. Die folgenden Marken sind Eigentum des United States Postal Service® und werden mit Genehmigung verwendet: United States Postal Service®, CASSTM, CASS CertifiedTM.