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:

• validateAddress (REST)
• ValidateAddress (gRPC)

Hinweis: In dieser Dokumentation wird REST für Beispiele verwendet. Der Ansatz ist jedoch mit gRPC ähnlich.

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

Testen!

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®)¹ betreibt das Coding Accuracy Support System (CASSTM), um Anbieter von Adressüberprüfungen zu unterstützen und zu zertifizieren.

Hinweis: Die Address Validation API ist als CASS-CertifiedTM-Dienst bestätigt. Dadurch wird bestätigt, dass der Dienst fehlende Adressinformationen ergänzen, standardisieren und auf die aktuellste und genaueste Adresse aktualisieren kann.

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
}

Hinweis :Wenn keine CASS-Verarbeitung erforderlich ist oder Sie Adressen außerhalb der USA und der PR-Region validieren möchten, rät Google davon ab, diese Funktion zu aktivieren.

Jetzt testen

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

1. Maximieren Sie optional Standardparameter anzeigen und legen Sie für den Parameter fields die Feldmaske fest.

2. Bearbeiten Sie optional den Anfragetext.

3. Klicken Sie auf die Schaltfläche Execute (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 „API Explorer“ das Symbol „Maximieren“ aus, um das Fenster „API Explorer“ zu maximieren.

---

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. ↩