Address Validation API'yi neden kullanmalısınız?
Adres Doğrulama API'si ile teslimat tahmin edilebilirliğini artırabilir ve teslimat hatalarını azaltarak daha iyi bir müşteri deneyimi sunabilirsiniz. Bunu, hatalı adresleri yakalayarak ve adres özelliklerini daha iyi anlayarak yapabilirsiniz.
Adres bileşenlerini tek tek doğrulamanız gerekmiyorsa Coğrafi Kodlama API'si ihtiyaçlarınıza daha uygun olabilir. Geocoding API, adresleri enlem ve boylam koordinatlarına dönüştürür. Address Validation API, adreslerin doğruluğunu doğrular. Ayrıntılı bir karşılaştırma için mimari merkezindeki Google Haritalar Platformu'nu kullanarak bina konumu doğrulama özelliği başlıklı makaleyi inceleyin.
Address Validation API ile neler yapabilirsiniz?
Adres Doğrulama API'si ile bir adresin gerçek bir yeri temsil edip etmediğini belirleyebilirsiniz. Adres gerçek bir yeri belirtmiyorsa API, düzeltmeleri için müşterilerinize sunabileceğiniz olası yanlış bileşenleri belirleyebilir. API'yi kullanan örnek bir iş akışı aşağıda verilmiştir:
Müşteri bir adres girer: Aşağıdaki resimde, müşterinin muhtemelen ödeme akışının bir parçası olarak adres girmesine olanak tanıyan temel bir form gösterilmektedir.
Uygulama adresi API'ye gönderir: Uygulama, bu adresi Address Validation API'ye giriş olarak iletir.
API, adresi doğrular ve standart hale getirir: Adres Doğrulama API'si, yanıtında API tarafından belirlenen adresin tamamını döndürür veya eksik bilgilerin nerede olduğunu belirtir.
Müşteri, önerilen adresi düzeltir veya onaylar: API'nin döndürdüğü değere bağlı olarak müşteriye aşağıdaki istemleri gösterebilirsiniz:
Müşterinin onaylaması için önerilen bir adres gösterin:
Müşteriden eksik bilgileri eklemesini isteyin:
API, eksik veya yanlış bilgiler nedeniyle giriş adresini doğrulayamazsa kullanıcıdan adresi düzeltmesini isteyin:
Address Validation API'nin işleyiş şekli
Adres doğrulaması, JSON gövdesi biçiminde adres içeren bir POST isteğini kabul eder. Adresi ayrı bileşenlerine ayırır ve ardından aşağıdaki kontrolleri ve düzeltmeleri yapar:
- Doğru: Varsa alt tesisler dahil olmak üzere bileşen düzeyinde doğrulama kontrolleri sağlar.
- Tam: Eksik veya yanlış adres bileşenlerini tahmin etmeye çalışır.
- Düzgün biçimlendirilmiş: Adres bileşenlerinin biçimini temizler ve standart hale getirir.
Address Validation API'nin işleyiş şeklini görmek için demoyu deneyin.
Kaynaklar
Aşağıdaki tabloda, Address Validation API üzerinden kullanılabilen kaynaklar ve döndürdüğü veriler özetlenmektedir. Ayrıntılı bilgi için Address Validation API referansı başlıklı makaleyi inceleyin.
| Veri kaynakları | Döndürülen veriler |
|---|---|
|
JSON biçiminde adres bileşenleri. Adres 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ılabilen özellikler:
Doğrulama yanıtını anlama başlıklı makaleyi inceleyin. |
Address Validation API'yi kullanma
| 1 | Demoyu deneyin | Hem doğru hem de yanlış çeşitli adres biçimleriyle demoyu keşfedin. Demo, hem hizmetten döndürülen değerleri hem de JSON biçimli API yanıtını keşfetmenin kullanışlı bir yolunu 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 | Kurulum | Google Cloud projenizi oluşturma ile başlayın ve sonraki talimatları uygulayın. |
| 4 | Adres doğrulaması isteme | Temel bir adresle başlayın ve daha fazla doğruluk için CASS'i (yalnızca ABD ve PR adresleri için) etkinleştirebilirsiniz. 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 kullanacağınız iki özellik sağlar. Temel yanıtları anlama başlıklı makaleyi inceleyin. |
| 6 | Doğrulama doğruluğunu iyileştirme | Address Validation API yanıtları hakkında geri bildirim sağlayarak adres doğruluğunun iyileştirilmesine yardımcı olabilirsiniz. Güncellenen adresleri işleme bölümüne bakın. |
Kullanılabilir istemci kitaplıkları
Address Validation API için kullanılabilen istemci kitaplıklarının listesi İstemci kitaplıkları bölümünde verilmiştir.
CASS™ hakkında
United States Postal Service® (USPS®)1, adres doğrulama sağlayıcılarını desteklemek ve onaylamak için Kodlama Doğruluğu Destek Sistemi'ni (CASS™) yönetir. Address Validation API gibi CASS Certified™ sertifikalı bir hizmet, adreste eksik olan bilgileri doldurma, standartlaştırma ve en güncel ve en doğru adresi sunmak için güncelleme yapma özelliğiyle onaylanmıştır.
CASS varsayılan olarak etkin değildir ve yalnızca "US" ve "PR" bölgeleri için desteklenir. CASS'yi etkinleştirmek için doğrulama isteği kapsamında enableUspsCass değerini true olarak ayarlayın. Daha fazla bilgi için Adres doğrulama başlıklı makaleyi inceleyin.
USPS hizmetlerini kullanımımız kapsamında USPS, yapay olarak oluşturulan adreslerle ilgili istekleri değerlendirir. USPS bir giriş adresini yapay olarak oluşturulmuş olarak tanımlarsa Google'ın müşterinin adreslerini 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?
- SSS'yi inceleyin: SSS bölümüne gidin.
- Kapsam alanlarını inceleme: Ülke ve bölge kapsamı ayrıntıları başlıklı makaleyi inceleyin.
- Adresleri yüksek hacimle işleme: Adresleri yüksek hacimle işlemek için Address Validation API'yi kullanma başlıklı makaleyi inceleyin.
-
Google Haritalar Platformu, United States Postal Service®'in münhasır olmayan bir lisans sahibidir. Aşağıdaki ticari markalar United States Postal Service®'e aittir ve izin alınarak kullanılır: United States Postal Service®, CASS™, CASS Certified™. ↩