Adres doğrulama isteği gönderme

Aşağıdakilerden birine POST isteği göndererek aşağıdaki uç noktalar:

• validateAddress (REST)
• ValidateAddress (gRPC)

İsteğiniz, doğrulanacak adresi tanımlar. Aşağıdaki istek gövdesinde bir alan var ve üç alt alan vardır:

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 istek 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 - Önerilir. Bu isteğe bağlı bir alandır ancak atlanırsa Address Validation API, bölgeyi adresten tahmin eder. Ancak en iyisi ve biliyorsanız regionCode öğesini de ekleyin. Desteklenen bölgelerin listesi için desteklenen bölgeler sayfasını 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 sayesinde örnek isteklerde bulunabilirsiniz. hakkında da bilgi edineceksiniz.

1. API simgesini, sekmesini tıklayın.

2. İsteğe bağlı olarak Standart parametreleri göster seçeneğini genişletin ve fields parametresini alanına ekleyin hakkında daha fazla bilgi edinin.

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

4. Yürüt düğmesini seçin. İletişim kutusunda kullanma konusunda karar vermemiz gerekir.

5. API Gezgini panelinde genişlet simgesini seçin, API Gezgini penceresini genişletmek için tuşlarına basın.