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)
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 TypPostalAddress
, das mindestens einen Eintrag inaddressLines
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 denregionCode
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
}
Jetzt testen
Mit dem API Explorer können Sie Beispielanfragen stellen, um sich mit der API und den API-Optionen vertraut zu machen.
Maximieren Sie optional Standardparameter anzeigen und legen Sie für den Parameter
fields
die Feldmaske fest.Bearbeiten Sie optional den Anfragetext.
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.
Wählen Sie im Bereich „API Explorer“ das Symbol „Maximieren“ aus, um das Fenster „API Explorer“ zu maximieren.
-
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. ↩