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"

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.

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.

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
}

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.