Aşağıdaki uç noktalardan birine POST isteği göndererek bir adres doğrulama isteği gönderin:
- validateAddress (REST)
- ValidateAddress (gRPC)
İsteğiniz, doğrulanacak adresi tanımlayan isteğe bir JSON istek gövdesi de iletmelidir. Aşağıdaki isteğin gövdesi bir alan ve üç alt alan içerir:
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"
Ayrıca, locality
öğesini çıkarabilir ve addressLines
dizisinde bir öğe olarak belirtebilirsiniz:
{
"address": {
"regionCode": "US",
"addressLines": ["1600 Amphitheatre Pkwy", "Mountain View, CA, 94043"]
},
}
Adres isteği alanları
İsteğin gövdesi tek bir alandan oluşur:
address
—addressLines
içinde en az bir giriş içermesi gerekenPostalAddress
türünde bir alan.
address
alanını Address Validation API'ye gönderirken yalnızca bir alan sağlamanız yeterlidir: addressLines
. Bununla birlikte, en basit adres isteği aşağıdaki alt alanları içermelidir:
regionCode
- Önerilir. Bu, isteğe bağlı bir alandır ancak atlanırsa Address Validation API, adresten bölgeyi çıkarır. Ancak en iyi sonuçlar için biliyorsanızregionCode
özelliğini de ekleyin. Desteklenen bölgelerin listesi için desteklenen bölgeleri inceleyin.addressLines
- Zorunlu. Adresin alt yapısını açıklayan adresler içeren bir dizi.
Referans kılavuzunda PostalAddress konusuna bakın. |
USPS CASSTM seçeneği
ABD Posta Hizmeti® (USPS®)1, adres doğrulama sağlayıcılarını desteklemek ve onaylamak için Kodlama Doğruluğu Destek Sistemi'ni (CASSTM) yönetir.
Yalnızca US ve PR bölgeleri için istek gövdesinde enableUspsCass
değerini true
olarak ayarlayarak CASS işlemeyi etkinleştirebilirsiniz. CASS kullanırken en iyi sonuçlar için şehir, eyalet ve posta koduyla birlikte cadde ve sokak numarasını içeren bir adres sağlayın:
{
"address": {
"regionCode": "US",
"locality": "Mountain View",
"administrativeArea": "CA",
"postalCode": "94043",
"addressLines": ["1600 Amphitheatre Pkwy"]
},
"enableUspsCass": true
}
-
Google Maps Platform, United States Mail Service®'in münhasır olmayan Lisans Sahibidir. Şu ticari markalar United States Mail Service®'e aittir ve izinle kullanılmaktadır: United States Postal Service®, CASSTM, CASS CertifiedTM. ↩