Address Validation API'ye genel bakış

Adres Doğrulamaya Genel Bakış

Adres Doğrulama API'si, adres kabul eden bir hizmettir. Adres bileşenlerini tanımlar ve doğrular. Ayrıca, adresi postalama için standart hale getirir ve adres için bilinen en iyi enlem/boylam koordinatlarını bulur. İsteğe bağlı olarak, 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 teslimatın öngörülebilirliğini iyileştirebilir ve teslimat hatalarını azaltarak müşteri deneyimini iyileştirebilirsiniz. Bunu, kötü adresleri tespit ederek ve adres özellikleriyle ilgili daha çok bilgi edinerek yapabilirsiniz.

Adres bileşenlerini tek tek doğrulamanız gerekmiyorsa Coğrafi Kodlama API'si ihtiyaçlarınız için daha uygun olabilir. Geocoding API, adresleri enlem/boylam koordinatlarına dönüştürürken Address Validation API, adreslerin doğruluğunu kontrol eder. Ayrıntılı bir karşılaştırma için Mimari Merkezi'nde Google Haritalar Platformu'nu kullanarak konum doğrulama özelliği oluşturma konusuna bakın.

Address Validation API ile neler yapabilirsiniz?

Address Validation API ile bir adresin gerçek bir yere ait olup olmadığını belirleyebilirsiniz. Adres gerçek bir yere işaret etmiyorsa API, müşterilerinize düzeltmeniz için sunabileceğiniz yanlış olabilecek bileşenleri tanımlayabilir. Aşağıda, API'yı kullanan örnek bir iş akışı verilmiştir:

  1. Müşteri adres girer: Aşağıdaki resimde, müşterinin muhtemelen ödeme akışının bir parçası olarak adres girmesini sağlayan basit bir form gösterilmektedir.
    Müşterinin girdiği adres.

  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 olarak API tarafından belirlenen tam adresi döndürür veya eksik bilgilerin nerede olduğunu belirtir.

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

    • Müşterinin onaylaması için önerilen bir adres sunun:
      Müşteriden, API tarafından belirlenen adresi onaylamasını isteyin.

    • Müşteriden eksik bilgileri eklemesini isteyin:
      Müşteriden eksik adres bilgilerini girmesini isteyin.

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

Address Validation API'nin işleyiş şekli

Adres doğrulama, JSON gövdesi biçimindeki adrese sahip POST isteğini kabul eder. Adresi bağımsız bileşenlerine ayırır ve ardından aşağıdaki kontrolleri ve düzeltmeleri yapar:

  • Doğru: Uygun olduğunda alt şirket dahil olmak üzere bileşen düzeyinde doğrulama kontrolleri sağlar.
  • Tamamlandı: Eksik veya yanlış adres bileşenleri tahmin edilmeye çalışılı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 üzerinden kullanılabilen kaynaklar, döndürdüğü verilerle birlikte özetlenmektedir. Ayrıntılı bilgi için Address Validation API referansı'na bakın.

Veri kaynakları Döndürülen veriler

Bileşenleri JSON biçiminde belirtin.

Adresi doğrulama başlıklı makaleyi inceleyin.

Tam ve doğrulanmış adres (mümkünse).

Her adres bileşeninin doğrulama durumu.

Adres için kullanılabiliyorsa:

  • Coğrafi kod
  • Adres kesinliği
  • Varsa posta hizmetleri verileri.

Doğrulama yanıtını anlama konusuna bakın.

Address Validation API'yi kullanma

1 Demoyu deneyin Hem doğru hem de yanlış olan çeşitli adres formlarını kullanarak demoyu keşfedin. Demo, hem hizmetten döndürülen değerleri hem de JSON biçimli API yanıtını keşfetmek için faydalı bir yol sunar.
2 Kapsamı kontrol etme Address Validation API'nin hangi ülkeleri ve bölgeleri desteklediğini görmek için kapsam ayrıntılarını inceleyin.
3 Hazırlanın Google Cloud projenizi oluşturma işlemiyle başlayın ve aşağıdaki talimatları tamamlayın.
4 Adres doğrulama isteğinde bulunma Basit bir adresle başlayın ve ardından daha fazla doğruluk için CASS'i etkinleştirebilirsiniz (yalnızca ABD ve PR adresleri için). Adres doğrulama isteğinde bulunma başlıklı makaleyi inceleyin.
5 Yanıtları işleme Address Validation API yanıtı, her birini farklı şekillerde kullandığınız iki özellik sağlar. Temel yanıtları anlama başlıklı makaleye bakın.
6 Doğrulama doğruluğunu iyileştirme Address Validation API yanıtlarıyla ilgili geri bildirim göndererek adres doğruluğunu iyileştirmeye yardımcı olabilirsiniz. Adres doğrulama geri bildirimi sağlama başlıklı makaleyi inceleyin.

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

ABD Posta Hizmeti® (USPS®)1, adres doğrulama sağlayıcılarını desteklemek ve onaylamak için Kodlama Doğruluğu Destek Sistemi'ni (CASSTM) yönetir. Address Validation API gibi bir CASS CertifiedTM hizmetinin, bir adresteki eksik bilgileri doldurma, standartlaştırma ve size en güncel ve en doğru adresi verecek şekilde güncelleme becerisi onaylanmıştır.

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

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

Sırada ne var?


  1. Google Maps Platform, ABD'nin münhasır olmayan Lisans Sahibidir Postal Service®. Şu ticari markalar United StatesPostal Service®'e aittir ve şu izinle kullanılmaktadır: United States Postal Service®, CASSTM, CASS CertifiedTM.