Adres doğrulama isteği gönderme

Aşağıdaki uç noktalardan birine POST isteği göndererek bir adres doğrulama isteği gönderin:

İ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:

  • addressaddressLines içinde en az bir giriş içermesi gereken PostalAddress 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ız regionCode ö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
}

  1. 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.