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"]
},
}
Felder für Adressanfragen
Der Anfragetext besteht aus einem einzelnen Feld:
address
: 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 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 dieregionCode
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.
Weitere Informationen finden Sie im Leitfaden unter PostalAddress. |
USPS CASS™-Option
Der United States Postal Service® (USPS®)1 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.
Wählen Sie rechts auf der Seite das API-Symbol aus.
Optional können Sie Standardparameter anzeigen maximieren und den Parameter
fields
auf die Feldmaske festlegen.Optional können Sie den Anfragetext bearbeiten.
Klicken Sie auf die Schaltfläche Ausführen. Wählen Sie im Dialogfeld das Konto aus, mit dem Sie die Anfrage stellen möchten.
Klicken Sie im API Explorer-Steuerfeld auf das Symbol zum Maximieren , um das Fenster des API Explorers zu maximieren.
-
Die Google Maps Platform ist ein nicht exklusiver Lizenznehmer von United States Postal Service®. Die folgenden Marken sind eingetragene Marken von United States Postal Service® und werden mit dessen Zustimmung verwendet: United States Postal Service®, CASS™, CASS Certified™. ↩