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:

• validateAddress (REST)
• ValidateAddress (gRPC)

İsteğiniz, doğrulanacak adresi tanımlayan bir JSON istek içeriği de göndermelidir. Aşağıdaki istek metni 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"

locality öğesini atlayabilir ve addressLines dizisinde bir öğe olarak belirtebilirsiniz:

{
  "address": {
    "regionCode": "US",
    "addressLines": ["1600 Amphitheatre Pkwy", "Mountain View, CA, 94043"]
  },
}

Deneyin.

Adres isteği alanları

İstek metni tek bir alandan oluşur:

• address: addressLines alanında en az bir giriş içermesi gereken PostalAddress türündeki 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: Önerilen. Bu isteğe bağlı bir alandır ancak atlanırsa Address Validation API, bölgeyi adresten çıkarır. Ancak en iyi sonuçları elde etmek için biliyorsanız regionCode değerini ekleyin. Desteklenen bölgelerin listesi için desteklenen bölgeler başlıklı makaleyi inceleyin.
• addressLines: Zorunlu. Adresin alt yapısını açıklayan adresleri içeren bir dizi.

Referans kılavuzundaki PostalAddress bölümüne bakın.

USPS CASS™ seçeneği

United States Postal Service® (USPS®)¹, adres doğrulama sağlayıcılarını desteklemek ve onaylamak için Kodlama Doğruluğu Destek Sistemi'ni (CASS™) yönetir.

Yalnızca ABD ve PR bölgeleri için, istek gövdesinde enableUspsCass değerini true olarak ayarlayarak CASS işlemeyi etkinleştirebilirsiniz. CASS'i kullanırken en iyi sonuçları elde etmek için şehir, eyalet ve posta kodunun yanı sıra sokak 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 Gezgini, API'ye ve API seçeneklerine aşina olabilmeniz için örnek istekler göndermenize olanak tanır.

1. Sayfanın sağ tarafındaki API simgesini seçin.

2. İsteğe bağlı olarak Standart parametreleri göster'i genişletin ve fields parametresini alan maskesine ayarlayın.

3. İsteğe bağlı olarak İstek gövdesini düzenleyin.

4. Yürüt düğmesini seçin. İletişim kutusunda, isteği göndermek için kullanmak istediğiniz hesabı seçin.

5. API Gezgini panelinde, API Gezgini penceresini genişletmek için genişlet simgesini seçin.