Adres doğrulama isteği gönderme

Aşağıdaki uç noktalardan birine POST isteği göndererek adres doğrulama isteği gönderin:

• validateAddress (REST)
• ValidateAddress (gRPC)

İsteğiniz, doğrulanacak adresi tanımlayan isteğe bir JSON istek gövdesi de iletmelidir. Aşağıdaki istek gövdesinde bir alan ve üç alt alan bulunur:

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 çıkarıp addressLines dizisinde bir öğe olarak belirtebilirsiniz:

{
  "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: addressLines alanında en az bir giriş bulunması gereken PostalAddress türünde bir alan.

Address Validation API'ye address alanını 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 - Önerilir. Bu, isteğe bağlı bir alandır ancak atlanırsa Address Validation API (Adres Doğrulama API'si) bölgeyi adresten tahmin eder. Ancak en iyi sonuçlar için, biliyorsanız regionCode öğesini ekleyin. Desteklenen bölgelerin listesi için desteklenen bölgeler sayfasını inceleyin.
• addressLines: Zorunlu. Adresin alt yapısını açıklayan adreslerden oluşan bir dizi.

Başvuru kılavuzunda PostalAddress (Posta Adresi) bölümüne bakın.

USPS CASSTM seçeneği

Amerika Birleşik Devletleri Postal Service® (USPS®)¹ adres doğrulama sağlayıcılarını desteklemek ve onaylamak için Kodlama Doğruluğu Destek Sistemi'ni (CASSTM) yönetmektedir.

Yalnızca ABD ve Halkla İlişkiler bölgeleri için istek gövdesinde enableUspsCass değerini true olarak ayarlayarak CASS işlemeyi etkinleştirebilirsiniz. CASS kullanırken en iyi sonuçlar için şehir, eyalet ve posta koduyla birlikte sokak ve sokak numarasını içeren bir adres girin:

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

Deneyin.

API Gezgini, API ve API seçeneklerini tanıyabilmeniz için örnek isteklerde bulunmanıza olanak tanır.

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

2. İsteğe bağlı olarak Standart parametreleri göster seçeneğini genişletin ve fields parametresini alan maskesi olarak ayarlayın.

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

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

5. API Gezgini panelinde genişletme simgesini () seçerek API Gezgini penceresini genişletin.