Address Validation API'ye genel bakış

Address Validation API, adres kabul eden bir hizmettir. Adres bileşenlerini tanımlar ve doğrular. Ayrıca, postalama için adresi standart hâle getirir ve bunun için bilinen en iyi enlem/boylam koordinatlarını bulur. Dilerseniz ABD ve Porto Riko'daki adresler için Kodlama Doğruluğu Destek Sistemi'ni (CASSTM) etkinleştirebilirsiniz.

Address Validation API'yi neden kullanmalısınız?

Address Validation API ile teslimatların öngörülebilirliğini artırabilir ve teslim hatalarını azaltabilir, böylece daha iyi bir müşteri deneyimi sunabilirsiniz. Bunun için kötü adresleri yakalar ve adres özellikleriyle ilgili daha iyi bir farkındalık elde edersiniz.

Adres bileşenlerini tek tek doğrulamanız gerekmiyorsa Geocoding API ihtiyaçlarınız için daha uygun olabilir. Geocoding API, adresleri enlem/boylam koordinatlarına dönüştürürken Address Validation API adresleri doğruluk açısından doğrular. Ayrıntılı bir karşılaştırma için Mimari Merkezi'ndeki Google Haritalar Platformu'nu kullanarak konum doğrulama özelliği oluşturma bölümüne bakın.

Address Validation API ile yapabilecekleriniz

Address Validation API ile bir adresin gerçek bir yere işaret edip etmediğini belirleyebilirsiniz. Adres gerçek bir yeri belirtmiyorsa API, müşterilerinize düzeltmeleri için sunabileceğiniz yanlış bileşenleri tanımlayabilir. Aşağıda, API'nin kullanıldığı örnek bir iş akışı verilmiştir:

1. Müşteri bir adres giriyor: Aşağıdaki resimde, müşterinin muhtemelen ödeme akışının bir parçası olarak adres girmesine olanak tanıyan basit bir form gösterilmektedir.
   

2. Uygulama, adresi API'ye gönderir: Uygulama, bu adresi Address Validation API'ye giriş olarak iletir.

3. API, adresi doğrular ve standartlaştırır – Address Validation API, yanıtında API tarafından belirlenen tam adresi döndürür veya bilgilerin eksik olduğu yerleri belirtir.

4. Müşteri önerilen adresi düzeltir veya onaylar: API'nin iade ettiği öğeye bağlı olarak müşteriye aşağıdaki istemleri sağlayabilirsiniz:

   • Müşterinin onaylaması için önerilen bir adres sunun:
     

   • Müşteriden eksik bilgileri eklemesini isteyin:
     

   • API, giriş adresini eksik veya yanlış bilgi nedeniyle doğrulayamazsa kullanıcıdan adresi düzeltmesini isteyin:
     

Address Validation API'nin işleyiş şekli

Adres doğrulaması, adresi JSON gövdesi biçiminde olan bir POST isteğini kabul eder. Adresi kendi bileşenlerine ayırır, ardından aşağıdaki kontrolleri ve düzeltmeleri yapar:

• Doğru: Uygun olduğunda alt şirketler de dahil olmak üzere bileşen düzeyinde doğrulama denetimleri sağlar.
• Tamamlandı: Eksik veya yanlış adres bileşenlerini tahmin etmeye çalışır.
• İyi biçimlendirilmiş: Adres bileşenlerinin biçimini temizler ve standart hale getirir.

Address Validation API'nin nasıl çalıştığını görmek için demoyu deneyin.

Kaynaklar

Aşağıdaki tabloda, Address Validation API aracılığıyla kullanılabilen kaynaklar döndürdüğü verilerle birlikte özetlenmektedir. Ayrıntılı bilgi için Address Validation API referansı bölümüne bakın.

Veri kaynakları	Döndürülen veriler
Bileşenleri JSON biçiminde adresleyin. Adres doğrulama başlıklı makaleyi inceleyin.	Eksiksiz, doğrulanmış adres (mümkünse). Her bir adres bileşeninin doğrulama durumu. Bir adres için kullanılabiliyorsa: Coğrafi kod Adres kesinliği Varsa posta hizmetleri verileri. Doğrulama yanıtını anlama bölümüne bakın.

Address Validation API'yi kullanma

1	Demoyu deneyin	Doğru ve yanlış adres formlarını kullanarak demoyu inceleyin. Demo, hem hizmetin döndürdüğü değerleri hem de JSON biçimli API yanıtını keşfetmenin faydalı bir yolunu sunar.
2	Kapsamı kontrol etme	Address Validation API'nin desteklediği ülkeleri ve bölgeleri görmek için kapsam ayrıntılarını inceleyin.
3	Kurulumu yapın	Google Cloud projenizi oluşturun ve sonraki talimatları uygulayın.
4	Adres doğrulaması isteme	Basit bir adresle başlayın ve daha sonra doğruluğu artırmak için CASS'i (yalnızca ABD ve PR adresleri için) etkinleştirebilirsiniz. Adres doğrulaması isteme konusuna bakın.
5	Yanıtları işleme	Address Validation API yanıtı, her biri farklı şekilde kullandığınız iki özellik sağlar. Temel yanıtları anlama başlıklı makaleye göz atın.
6	Doğrulama doğruluğunu artırma	Address Validation API yanıtlarıyla ilgili geri bildirim sağlayarak adres doğruluğunu iyileştirmeye yardımcı olabilirsiniz. Güncellenen adresleri işleme alma başlıklı makaleye göz atın.

Kullanılabilir istemci kitaplıkları

Address Validation API'de kullanılabilen istemci kitaplıklarının listesi için İstemci kitaplıkları bölümüne bakın.

CASSTM hakkında

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. Address Validation API gibi bir CASS CertifiedTM hizmetinin, bir adreste eksik olan bilgileri doldurma, standartlaştırma ve size en güncel ve en doğru adresi sağlayacak şekilde güncelleme becerisi onaylanmıştır.

CASS varsayılan olarak etkin değildir ve yalnızca "US" ile "PR" bölgeleri için desteklenir. CASS'i etkinleştirmek için doğrulama isteğinin parçası olarak enableUspsCass öğesini true olarak ayarlayın. Daha fazla bilgi için Adres doğrulama bölümünü inceleyin.

USPS hizmetlerimiz kapsamında yapay olarak oluşturulmuş adreslere yönelik talepleri değerlendirir. USPS bir giriş adresinin yapay olarak oluşturulduğunu tespit ederse Google'ın müşteri için adresleri doğrulamayı durdurması ve müşterinin iletişim bilgilerini (ad ve adres), ilgili giriş adresini ve birleştirilmiş kullanım verilerini USPS'e bildirmesi gerekir. API'yi kullanarak bu Hizmete Özel Şartlar'ı kabul etmiş olursunuz.

Sırada ne var?

• SSS'yi inceleyin: SSS sayfasına gidin.
• Kapsam alanlarını inceleme: Ülke ve bölge kapsam ayrıntıları bölümüne gidin.
• Yüksek hacimdeki adresleri işleme: Adresleri yüksek hacimde işlemek için Address Validation API'yi kullanma başlıklı makaleyi inceleyin.