Adres doğrulama isteği gönderme

Avrupa Ekonomik Alanı'ndaki (AEA) geliştiriciler

Fatura adresiniz Avrupa Ekonomik Alanı'ndaysa 8 Temmuz 2025'ten itibaren Hizmetleri kullanımınız Google Haritalar Platformu AEA Hizmet Şartları'na tabi olacaktır. İşlevler bölgeye göre değişir. Daha fazla bilgi edinin.

Aşağıdaki uç noktalardan birine POST isteği göndererek Address Validation isteği gönderin:

• validateAddress (REST)
• ValidateAddress (gRPC)

Not: Bu dokümandaki örneklerde REST kullanılmıştır ancak yaklaşım gRPC ile benzerdir.

İsteğiniz, doğrulanacak adresi tanımlayan bir JSON istek gövdesini de isteğe iletmelidir. Aşağıdaki istek gövdesi 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"

locality özelliğini atlayıp addressLines dizisinde bir öğe olarak da belirtebilirsiniz:

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

API Gezgini, API ve API seçeneklerini tanıyabilmeniz için canlı istekler göndermenize olanak tanır:

Deneyin.

Adres isteği alanları

İstek içeriği tek bir alandan oluşur:

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

Address Validation API'ye address alanını gönderirken yalnızca bir alan sağlamanız gerekir: addressLines. Ancak en basit adres isteği şu alt alanları içermelidir:

• regionCode — Önerilir. Bu alan isteğe bağlıdır ancak belirtilmezse Address Validation API, bölgeyi adresten tahmin eder. Ancak en iyi sonuçları elde etmek için biliyorsanız regionCode değerini ekleyin. Desteklenen bölgelerin listesi için desteklenen bölgeler başlıklı makaleyi inceleyin.
• addressLines: Zorunlu. Adresin alt yapısını açıklayan adresleri içeren bir dizi.

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

USPS CASS™ seçeneği

Amerika Birleşik Devletleri Posta Hizmetleri® (USPS®)¹, adres doğrulama sağlayıcılarını desteklemek ve onaylamak için Kodlama Doğruluğu Destek Sistemi'ni (CASS™) kullanır.

Not: Address Validation API, CASS-Certified™ hizmeti olarak onaylanmıştır. Bu, hizmetin eksik adres bilgilerini doldurma, standartlaştırma ve en güncel ve doğru adrese güncelleme yeteneğinin onaylandığı anlamına gelir.

Yalnızca ABD ve Porto Riko 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ı elde etmek için sokak ve sokak numarasının yanı sıra şehir, eyalet ve posta kodunu içeren bir adres girin:

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

Not: CASS işleme gerekmiyorsa veya ABD ve Porto Riko bölgeleri dışındaki adresleri doğruluyorsanız Google bu özelliğin etkinleştirilmesini önermez.

Deneyin.

API Gezgini, API'yi ve API seçeneklerini tanıyabilmeniz 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. Execute (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 panelinde, API Gezgini penceresini genişletmek için tam ekran simgesini fullscreen seçin.

---

1. Google Haritalar Platformu, United States Postal Service®'in münhasır olmayan lisans sahibidir. Aşağıdaki ticari markalar United States Postal Service®'e aittir ve izin alınarak kullanılmaktadır: United States Postal Service®, CASS™, CASS Certified™. ↩