Senden Sie eine Anfrage zur Adressüberprüfung, indem Sie eine POST-Anfrage an eine der folgenden Endpunkten:
- validateAddress (REST)
- ValidateAddress (gRPC)
Ihre Anfrage sollte auch einen JSON-Anfragetext an die Anfrage übergeben, definiert die zu überprüfende Adresse. Der folgende Anfragetext enthält ein Feld und drei Unterbereiche:
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 in
addressLines
-Array:
{
"address": {
"regionCode": "US",
"addressLines": ["1600 Amphitheatre Pkwy", "Mountain View, CA, 94043"]
},
}
Felder der Adressanfrage
Der Anfragetext besteht aus einem einzelnen Feld:
address
: Ein Feld vom TypPostalAddress
, das unter mindestens einen Eintrag inaddressLines
.
Wenn Sie das Feld address
an die Address Validation API senden, benötigen Sie nur
ein Feld angeben: addressLines
. Die einfachste Adressanfrage
sollte die folgenden untergeordneten Felder enthalten:
regionCode
– empfohlen. Dies ist ein optionales Feld. Wird es jedoch weggelassen, Die Address Validation API leitet die Region von der Adresse ab. Um jedoch enthalten dieregionCode
, sofern Sie sie kennen. Eine Liste der unterstützten Regionen finden Sie unter Unterstützte Regionen.addressLines
: Erforderlich. Ein Array mit Adressen, die den unteren Struktur der Adresse.
Weitere Informationen finden Sie im Referenzleitfaden unter PostalAddress. |
Option USPS CASSTM
Der United States Postal Service® (USPS®)1 verwaltet die Coding Accuracy Support System (CASSTM) zur Unterstützung und Zertifizierung Anbietern von Adressen überprüfen.
Nur für die USA und PR-Regionen können Sie die CASS-Verarbeitung aktivieren, indem Sie
enableUspsCass
bis true
im Anfragetext. Für optimale Ergebnisse bei
CASS eine Adresse mit Straße und Hausnummer sowie
die Stadt, das Bundesland und die Postleitzahl:
{
"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, damit Sie sich mit der API und den API-Optionen vertraut machen können.
Klicken Sie auf das API-Symbol
. rechts auf der Seite.
Maximieren Sie optional Standardparameter anzeigen und legen Sie das
fields
fest. Parameter auf das Feld Maske.Optional können Sie den Anfragetext bearbeiten.
Klicken Sie auf die Schaltfläche Execute (Ausführen). Wählen Sie im Dialogfeld das Konto aus, die Sie für die Anfrage verwenden möchten.
Klicken Sie im API Explorer auf das Symbol zum Maximieren
, um das API Explorer-Fenster zu maximieren.
-
Die Google Maps Platform ist ein nicht exklusiver Lizenznehmer der USA Postal Service®. Die folgenden Marken sind Eigentum der USA Postal Service® und mit Berechtigung verwendet: United States Postal Service®, CASSTM, CASS CertifiedTM. ↩