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
uspsDatagerekir. - 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
- Etkinleştirilecek hizmet:
addressvalidation.googleapis.com - Kimlik doğrulama: API anahtarı, OAuth 2.0, hizmet hesabı
- Başlayın: Address Validation API'yi ayarlama
- Referans: Address Validation API referansı
- Fiyatlandırma: Address Validation API kullanımı ve faturalandırması
- Politikalar: Address Validation API politikaları
- Sürüm notları: Address Validation API sürüm notları
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ğerifalseolduğunda karardan çıkarılır. Bu nedenle, alanın mevcut olmasını bekleyen kod, eksik adresleri yanlış okuyabilir. Düzeltme: Eksik biraddressCompleteözelliğinifalseolarak değerlendirin veya özelliğin varlığını kontrol edin. /maps/documentation/address-validation/understand-response adresini inceleyin. - Sorun:
regionCodeatlanırsa API, bölgeyi adresten tahmin eder. Bu da daha zayıf sonuçlar verebilir. Düzeltme: BildiğinizdePostalAddressalanınaregionCodedeğerini ekleyin. /maps/documentation/address-validation/requests-validate-address adresini inceleyin. - Sorun:
uspsDatanesnesinin, doğrulanmış her ABD adresi için tam olarak doldurulacağı garanti edilmez. Düzeltme: Tek doğrulama sinyali olarakuspsData'e güvenmeyin. Karar ve adres bileşenlerini de kullanın. /maps/documentation/address-validation/handle-us-address adresini inceleyin. - Sorun:
provideValidationFeedbackile gönderilen geri bildirim, dizideki sonraki bir çağrıyı değil, ilkvalidateAddressçağrısındakiresponseIddeğerini referans almalıdır. Düzeltme: İlkvalidateAddressyanıtındakiresponseIddeğ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.
- Belirtilen bir adres veya kısmi adres için doğrulanmış bir adres döndürür.
- Doğrulanmış bir adresin enlem/boylam koordinatlarını döndürme
- Doğrulanmış bir adres için Google yer tanımlayıcısını döndürme
- Adres doğrulama için Amerika Birleşik Devletleri Posta Hizmetleri (USPS) Kodlama Doğruluğu Destek Sistemi (CASS) sertifikasını kullanın.
- Doğrulanmış bir adresin işletme, konut veya posta kutusu olup olmadığıyla ilgili bilgileri döndürür.
- Doğrulanmış bir adres için ABD Posta Hizmeti (USPS) teslimat meta verilerini döndürme
- Doğrulanmış bir adresin İngilizce sürümünü döndürme Önizleme
- Doğrulanmış bir adres için Plus Code döndürme