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 atlayabilir ve addressLines dizisinde öğe olarak belirtebilirsiniz:

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

API Gezgini, API ve API seçenekleri hakkında bilgi edinmek için canlı isteklerde bulunmanıza olanak tanır:

Adres isteği alanları

İstek metni tek bir alandan oluşur:

• address: PostalAddress türünde bir alan. addressLines içinde en az bir giriş içermelidir.

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 — Önerilir. Bu isteğe bağlı bir alandır ancak atlanırsa Adres Doğrulama API'si bölgeyi adresten çıkarır. Ancak en iyi sonuçları elde etmek için regionCode bilgisini biliyorsanız ekleyin. Desteklenen bölgelerin listesi için desteklenen bölgeler başlıklı makaleyi inceleyin.
• addressLines — Zorunlu. Adresin alt yapısını açıklayan adreslerin bulunduğu bir dizi.

USPS CASS™ seçeneği

United States Postal Service® (USPS®)¹, adres doğrulama sağlayıcılarını desteklemek ve sertifikalandırmak için Coding Accuracy Support System (CASS™)'i kullanır.

Yalnızca ABD ve Porto Riko bölgelerinde, 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 girin:

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

Deneyin!

API Gezgini, API ve API seçeneklerine alışabilmeniz için örnek istekler göndermenize olanak tanır.

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

2. İsteğe bağlı olarak istek parametrelerini düzenleyin.

3. Yürüt düğmesini seçin. İletişim kutusunda, isteği göndermek için kullanmak istediğiniz hesabı seçin.

4. API Gezgini penceresini genişletmek için API Gezgini panelinde tam ekran simgesini fullscreen seçin.