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
}
Deneyin.
API Explorer, API'yi ve API seçeneklerini tanımanız için örnek isteklerde bulunmanıza olanak tanır.
Sayfanın sağ tarafındaki API simgesini seçin.
İsteğe bağlı olarak Standart parametreleri göster'i genişletin ve
fields
parametresini alan maskesine ayarlayın.İsteğe bağlı olarak İstek gövdesi'ni düzenleyin.
Yürüt düğmesini seçin. İletişim kutusunda, istekte bulunurken kullanmak istediğiniz hesabı seçin.
API Gezgini panelinde API Gezgini penceresini genişletmek için genişletme simgesini () seçin.
-
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. ↩