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 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=YOUR_API_KEY"
Ayrıca locality
öğesini atlayıp addressLines
dizisinde bir öğe olarak belirtebilirsiniz:
{
"address": {
"regionCode": "US",
"addressLines": ["1600 Amphitheatre Pkwy", "Mountain View, CA, 94043"]
},
}
Adres isteği alanları
İstek 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 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, adresten bölgeyi tahmin eder. Ancak en iyi sonuçları elde etmek 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.
Başvuru kılavuzunda PostalAddress öğesine 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 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 cadde ve sokak numarasını da içeren bir adres girin:
{
"address": {
"regionCode": "US",
"locality": "Mountain View",
"administrativeArea": "CA",
"postalCode": "94043",
"addressLines": ["1600 Amphitheatre Pkwy"]
},
"enableUspsCass": true
}
-
Google Maps Platform, ABD Postal Service®'in münhasır olmayan Lisans Sahibidir. Şu ticari markalar United States Postal Service®'e aittir ve şu izinle kullanılmaktadır: United States Postal Service®, CASSTM, CASS CertifiedTM. ↩