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)

Not: Bu dokümanda örnekler için REST kullanılmıştır ancak yaklaşım gRPC ile benzerdir.

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

Not: Address Validation API, CASS-Certified™ hizmeti olarak onaylanmıştır. Bu, hizmetin eksik adres bilgilerini doldurma, standartlaştırma ve en güncel ve doğru adresle güncelleme özelliğinin onaylandığı anlamına gelir.

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
}

Not: CASS işlemesine ihtiyacınız yoksa veya ABD ve PR bölgelerinin dışındaki adresleri doğruluyorsanız Google bu özelliği etkinleştirmenizi önermez.

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.

---

1. Google Haritalar Platformu, United States Postal Service®'in münhasır olmayan bir lisans sahibidir. Aşağıdaki ticari markalar United States Postal Service®'e aittir ve izin alınarak kullanılır: United States Postal Service®, CASS™, CASS Certified™. ↩