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

  • 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 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ı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.
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
}

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