Aşağıdaki uç noktalardan birine POST isteği göndererek 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 istek gövdesinde bir alan ve üç alt alan bulunur:
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 çıkarıp addressLines
dizisinde bir öğe olarak belirtebilirsiniz:
{
"address": {
"regionCode": "US",
"addressLines": ["1600 Amphitheatre Pkwy", "Mountain View, CA, 94043"]
},
}
Adres istek alanları
İsteğin gövdesi tek bir alandan oluşur:
address
:addressLines
alanında en az bir giriş bulunması gerekenPostalAddress
türünde bir alan.
Address Validation API'ye address
alanını gönderirken yalnızca bir alan sağlamanız gerekir: addressLines
. Ancak 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 (Adres Doğrulama API'si) bölgeyi adresten tahmin eder. Ancak en iyi sonuçlar için, biliyorsanızregionCode
öğesini ekleyin. Desteklenen bölgelerin listesi için desteklenen bölgeler sayfasını inceleyin.addressLines
: Zorunlu. Adresin alt yapısını açıklayan adreslerden oluşan bir dizi.
Başvuru kılavuzunda PostalAddress (Posta Adresi) bölümüne bakın. |
USPS CASSTM seçeneği
Amerika Birleşik Devletleri Postal Service® (USPS®)1 adres doğrulama sağlayıcılarını desteklemek ve onaylamak için Kodlama Doğruluğu Destek Sistemi'ni (CASSTM) yönetmektedir.
Yalnızca ABD ve Halkla İlişkiler 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 sokak ve sokak numarasını içeren bir adres girin:
{
"address": {
"regionCode": "US",
"locality": "Mountain View",
"administrativeArea": "CA",
"postalCode": "94043",
"addressLines": ["1600 Amphitheatre Pkwy"]
},
"enableUspsCass": true
}
Deneyin.
API Gezgini, API ve API seçeneklerini tanıyabilmeniz 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 seçeneğini genişletin ve
fields
parametresini alan maskesi olarak ayarlayın.İsteğe bağlı olarak İstek gövdesini düzenleyin.
Yürüt düğmesini seçin. İletişim kutusunda, istekte bulunmak için kullanmak istediğiniz hesabı seçin.
API Gezgini panelinde genişletme simgesini () seçerek API Gezgini penceresini genişletin.
-
Google Haritalar Platformu, Amerika Birleşik Devletleri'nin Posta Hizmeti®'nin münhasır olmayan bir Lisans Sahibidir. Şu ticari markalar ABD Posta Hizmeti®'ne aittir ve şu izinle kullanılmaktadır: United States Postal Service®, CASSTM, CASS CertifiedTM. ↩