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 belgede örnekler için REST kullanılmıştır ancak yaklaşım benzerdir. gRPC kullanın.

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

Ayrıca locality öğesini atlayabilir ve bunu addressLines dizisi:

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

Deneyin.

Adres isteği alanları

İsteğin gövdesi tek bir alandan oluşur:

• address — PostalAddress türünde bir alan; şu değeri içermelidir: addressLines içinde en az bir giriş var.

Address Validation API'ye address alanını gönderirken yalnızca ihtiyacınız olanlar bir alan sağlar: 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 tahmin eder. Ancak en iyi sonuçları elde etmek için regionCode değerini biliyorsanız dahil edin. Desteklenen bölgelerin listesi için desteklenen bölgeler başlıklı makaleyi inceleyin.
• addressLines: Zorunlu. Alt kısmı tanımlayan adreslerden oluşan bir dizi yapın.

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

USPS CASSTM seçeneği

Amerika Birleşik Devletleri Postal Service® (USPS®)¹ Desteklemek ve sertifikalandırmak için Kodlama Doğruluğu Destek Sistemi (CASSTM) adres doğrulama sağlayıcılarını kullanın.

Not: Address Validation API, CASS-CertifiedTM hizmeti olarak onaylanmıştır. Bu hizmetin eksik adresi doldurma özelliğinin onaylandığı anlamına gelir standart hale getirmek ve en güncel ve doğru bilgilerle güncellemek girin.

Yalnızca ABD ve Halkla İlişkiler bölgeleri için CASS işlemesini enableUspsCass, istek gövdesinde true olarak değiştirildi. En iyi sonuçları elde etmek için CASS ile birlikte sokak ve sokak numarasını da içeren bir adres girin şehir, eyalet ve posta kodu:

{
  "address": {
    "regionCode": "US",
    "locality": "Mountain View",
    "administrativeArea": "CA",
    "postalCode": "94043",
    "addressLines": ["1600 Amphitheatre Pkwy"]
  },
  "enableUspsCass": true
}

Not: CASS işlemesine ihtiyaç duymuyorsanız veya doğrulama yapıyorsanız ABD ve Halkla İlişkiler bölgeleri dışındaki adresleri kullanmak için Google, kullanabilirsiniz.

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 genişlet simgesini seçin, API Gezgini penceresini genişletmek için tuşlarına basın.

---

1. Google Haritalar Platformu, ABD'deki münhasır olmayan bir Lisans Sahibidir Postal Service®. Aşağıdaki ticari markalar ABD'ye aittir Postal Service® ve izinle kullanılır: United States Postal Service®, CASSTM, CASS CertifiedTM. ↩