Address Validation API'ye genel bakış

Adres Doğrulamaya Genel Bakış

Address Validation API, adres kabul eden bir hizmettir. Adres bileşenlerini tanımlar ve doğrular. Ayrıca, posta göndermek için adresi standartlaştırır 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ülebilir olmasını sağlayabilir, teslimat hatalarını azaltabilir ve böylece daha iyi bir müşteri deneyimi sunabilirsiniz. Bunu, kötü adresleri yakalayarak ve adres özellikleriyle ilgili daha fazla bilgi edinerek yapabilirsiniz.

Adres bileşenlerini tek tek doğrulamanız gerekmiyorsa Coğrafi Kodlama API'si ihtiyaçlarınıza daha uygun bir çözüm 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 bölümüne 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, düzeltmeleri için müşterilerinize sunabileceğiniz yanlış olabilecek bileşenleri tespit edebilir. Aşağıda, API'nın kullanıldığı örnek bir iş akışı verilmiştir:

  1. Müşteri bir 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 standart hale getirir – Address Validation API, yanıtta 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 döndürdüğü bilgiye 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, giriş adresini eksik veya yanlış bilgi nedeniyle 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 bir POST isteğini kabul eder. Adresi bağımsız bileşenlerine ayırıp aşağıdaki kontrolleri ve düzeltmeleri yapar:

  • Doğru: Kullanılabilir olduğunda alt şirket 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 özetlenmiştir. Belirli ayrıntılar 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.

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

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

Her adres bileşeninin doğrulama durumu.

Bir adres için kullanılabilir olduğunda:

  • 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 inceleyin. 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 ile 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ıtı 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 sağlayarak adres doğruluğunun iyileştirilmesine yardımcı olabilirsiniz. Güncellenen adresleri işleme 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ünü inceleyin.

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 adreste eksik olan bilgileri doldurma, bu hizmeti standartlaştırma ve size en güncel ve en doğru adresi verecek şekilde güncelleme becerileri olduğu 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 değerini true olarak ayarlayın. Daha fazla bilgi için Adresi doğrulama bölümünü inceleyin.

USPS hizmetlerini kullanırken USPS, yapay olarak oluşturulmuş adreslere yönelik talepleri 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, United States Mail Service®'in münhasır olmayan Lisans Sahibidir. Şu ticari markalar United States Mail Service®'e aittir ve izinle kullanılmaktadır: United States Postal Service®, CASSTM, CASS CertifiedTM.