Address Validation API hızlı referansı

Address Validation API, bir adresi kabul eder, bileşenlerini tanımlayıp doğrular, adresi posta için standartlaştırır ve adres için bilinen en iyi enlem/boylam koordinatlarını döndürür. ABD ve Porto Riko adresleri için isteğe bağlı olarak USPS CASS işlemeyi etkinleştirebilirsiniz.

Address Validation API: Temel bilgiler

  • Ürün: Address Validation API
  • Kategori: Yerler
  • Platform: Web hizmeti (REST)
  • Çalıştığı yer: Sunucu (arka uç kodu)
  • Lansman aşaması: GA
  • Yaşam döngüsü: Etkin
  • Genel bakış: Address Validation API'ye genel bakış
  • Kullanılabildiği bölgeler: Sınırlı. Desteklenen ülkeler ve veri kalitesi ülkeye göre değişir. Bazı ülkeler önizleme aşamasındadır. Konut ve ticari meta veriler yalnızca kapsam sayfasında işaretlenen ülkeler için döndürülür. USPS CASS yalnızca ABD ve Porto Riko'da desteklenir. (kapsam ayrıntıları)

Address Validation API: Ne zaman kullanılır?

Address Validation API'yi şu durumlarda kullanın:

  • Bir adresin gerçek bir yeri ifade edip etmediğini kontrol etmeniz ve hangi bileşenlerin eksik veya muhtemelen yanlış olduğunu bulmanız gerekir.
  • Posta adresini standartlaştırmanız ve tamamlamanız gerektiğinde (ör. ödeme adımları sırasında)
  • ABD veya Porto Riko'daki adresler için USPS CASS sertifikalı doğrulama ve uspsData gerekir.
  • Kapsam sayfasında listelenen bir ülke için konut veya ticari adres meta verilerine ihtiyacınız vardır.

Address Validation API'yi şu durumlarda kullanmayın:

  • Yalnızca bir adresi enlem/boylam değerine dönüştürmeniz gerekiyorsa ve her bir adres bileşenini doğrulamanız gerekmiyorsa. Bunun yerine Geocoding API'yi kullanın.
  • Bina girişleri, bina ana hatları veya navigasyon noktaları gibi son derece ayrıntılı varış noktası bilgilerine ihtiyacınız varsa Bunun yerine Geocoding API'yi kullanın.

Address Validation API: kurulum

Resmi Address Validation API paketleri:

  • npm: @googlemaps/addressvalidation
  • pypi: google-maps-addressvalidation
  • go: cloud.google.com/go/maps

Address Validation API: Sık yapılan hatalar

  • Sorun: addressComplete özelliği, değeri false olduğunda karardan çıkarılır. Bu nedenle, alanın mevcut olmasını bekleyen kod, eksik adresleri yanlış okuyabilir. Düzeltme: Eksik bir addressComplete özelliğini false olarak değerlendirin veya özelliğin varlığını kontrol edin. /maps/documentation/address-validation/understand-response adresini inceleyin.
  • Sorun: regionCode atlanırsa API, bölgeyi adresten tahmin eder. Bu da daha zayıf sonuçlar verebilir. Düzeltme: Bildiğinizde PostalAddress alanına regionCode değerini ekleyin. /maps/documentation/address-validation/requests-validate-address adresini inceleyin.
  • Sorun: uspsData nesnesinin, doğrulanmış her ABD adresi için tam olarak doldurulacağı garanti edilmez. Düzeltme: Tek doğrulama sinyali olarak uspsData'e güvenmeyin. Karar ve adres bileşenlerini de kullanın. /maps/documentation/address-validation/handle-us-address adresini inceleyin.
  • Sorun: provideValidationFeedback ile gönderilen geri bildirim, dizideki sonraki bir çağrıyı değil, ilk validateAddress çağrısındaki responseId değerini referans almalıdır. Düzeltme: İlk validateAddress yanıtındaki responseId değerini saklayın ve geri bildirim isteğinde gönderin. /maps/documentation/address-validation/handle-updated-address adresini inceleyin.

Address Validation API ile yapabilecekleriniz

Her görev için aşağıda bağlantısı verilen kılavuzlara bakın veya Özellikler Gezgini'nde ürünleri karşılaştırın.