Bu dokümanda, amacınız doğrultusunda bir adres denetim sistemi oluşturmak için Address Validation API'den gelen çeşitli yanıtları işleme. Bu videoda ise yanıtı doğru kullanmak, diğer sinyalleri incelemek ve hakkında daha fazla bilgi edinebileceğiniz hakkında daha fazla bilgi edinin.
Genel olarak API yanıtı, sisteminizin bunu yapması için aşağıdaki adımları şu adresi işle:
- . Düzelt: Adresin kalitesi düşük. Daha fazla bilgi için istemde bulunmalısınız.
- . Onayla: Adres yüksek kalitede ancak farklı olabilir. Bir ekip üyesine onayı.
- . Kabul et: Adres yüksek kalitededir. Şunları yapabilirsiniz: sağlanan adresi kabul edin.
Temel amaç
Bu belge, sisteminizi API yanıtını en iyi şekilde analiz edecek ve sağlanan adreslerle ilgili yapılacak işlemleri belirler. Aşağıdakiler sözde kod olası bir akışı gösterir.
if (the API response indicates significant problems in the address)
FIX - prompt the user to fix the address
else if (the API response indicates less significant problems in the address)
CONFIRM - confirm with the user that the address is correct
else
ACCEPT - continue with the address returned by the API.
Kesin mantık durumunuza göre değişir. Uygulama kılavuzu başlıklı makaleyi inceleyin. inceleyebilirsiniz. İsterseniz bu mantığın açık kaynak uygulamamızı kullanarak Genişletilmiş Bileşen Kitaplığı'nda bulabilirsiniz.
İş akışına genel bakış
Aşağıdaki tabloda sisteminiz için iki işlem özetlenmiştir:
- Düzeltmeye göre kullanılacak iş akışı, onaylama, kabul etme davranışı.
- Yanıtta kontrol edilmesi gereken ilk sinyaller. Sinyaller
açıklamaları
verdict
özelliğinden gelir ve tek başına yeterli değildir. emin olmak için güvenli URL'ler, ancak adres için bir başlangıç kalitedir. Her davranış türü bu belgedeki bir bölüme karşılık gelir ve incelemeniz gerekebilecek diğer sinyalleri
Sistem davranışınız | |||
---|---|---|---|
Adresi düzeltme | .
|
||
Adresi onaylayın | .
|
||
Adresi kabul edin | .
Address Validation API yanıtı, mükemmel kalite adresini gösteriyor.
|
Uygulama kılavuzu
Sisteminizin Address Validation API'den gelen sinyallere nasıl yanıt vereceğini tasarlarken, aşağıdaki öneriler daha etkili bir yanıt oluşturmanıza yardımcı olabilir modeli. Ancak, bunlar yalnızca öneridir. Bu nedenle, iş modelinize uygun olması gerektiğini unutmayın.
Rehberlik | Ayrıntılar | |
---|---|---|
Risk düzeyi |
Erişim düzeyini ikiniz için de uygun olan talep ve talep arasında bir denge kurarken ve adres girildiği şekliyle kabul edilir. |
Address Validation API, çeşitli sinyaller döndürür doğrulamanızı optimize etmek için risk düzeyinize dahil edebileceğiniz bahsedeceğim. Örneğin, bir adresin onaylanmamış sokak numarası varsa, şunları yapabilirsiniz: kabul etmelisiniz. Diğer yandan, işletmenizin faaliyetleri daha fazla adres kesinliği söz konusu olduğunda, kullanıcınıza istekte bulunabilirsiniz. Örneğin, herhangi bir kategoriye girebilir. ABD dışı onaylanmamış sokak numarası bölümüne bakın. Adresi kabul et - örnekler başlıklı makaleyi inceleyin. |
Adresleri kabul et |
Sisteminizin orijinal girişi kabul etmesine izin vermek iyi bir uygulamadır. müşteri istemlere yanıt vermiyorsa. |
Bu durumlarda, müşteri aşağıdaki durumlarda olmayan bir adres girmiş olabilir: örneğin yeni inşaat için kullanılabilir. |
Geri bildirim sağlama |
Bir adres doğrulama isteğini yeniden gönderdiğinizde,
|
Bu, Google'ın nihai yanıtı nasıl ele aldığınızı bildirir. Güncellenen adresleri işleme alma başlıklı makaleye göz atın. |
Adres düzeltme
Sonuçlar, adresin farklı olduğunu açıkça gösterdiğinde bir adresi düzeltin teslimat olabilir. Ardından, sisteminiz müşteriden gerekli bilgileri sağlamasını isteyebilir. ve ardından bir teslimat almak üzere iş akışınızı yeniden girin.
Sinyalleri düzeltin
Address Validation API, bir düzeltilmelidir.
1. Doğrulama ayrıntı düzeyi ve eksik bileşenler
Aşağıdaki iki sinyal, sorunlu bir adres için en iyi göstergeyi sağlar:
validationGranularity
alanıOTHER
olduğunda, sisteminiz hatanın nerede olduğuyla ilgili daha fazla bilgi edinmek için adres bileşeni sinyallerini incelemek ve nasıl düzeltileceğini açıklayacağız.- İşlendikten sonra işlenen
address
nesnesi,missingComponentTypes
alanında, sisteminizin bu bileşeni kontrol etmesi gerekir. Eksik bileşenler, ayrıca bir adresin eksik ve teslim edilememesine neden olur.
2. Diğer sinyaller
Address Validation API, kullanıcılara yardımcı olacak diğer sinyalleri de Belirli sorunları teşhis edin:
Şüpheli bileşenler | Bir bileşenin onay düzeyi sıralaması
UNCOMFIRMED_AND_SUSPICIOUS , muhtemelen bileşen
yanlış.
|
---|---|
Çözümlenmemiş bileşen | unresolvedToken girişin, adresin geçerli bir bölümü olarak tanınmayan bir bölümüdür. |
3. ABD adres sinyalleri
Yalnızca ABD'deki adresler için geçerli olan bazı alanlar, URL'lerin teslimat yapılamaz ve düzeltilmesi gerekir. Şunu gerektiren bir adres için: şu değişiklikleri görmeniz gerekir:
dpvConfirmation
|
N , D veya boş.
|
---|
dpvConfirmation
hakkında ayrıntılı bilgi için bkz.
ABD adreslerini işleyin.
Bir adresi onaylayın
Karar, Address Validation API'nin olduğunu belirttiğinde bir adresi onaylarsınız. ya da bileşenler üzerinde tahminde bulunarak veya değişiklikler yapılarak doğrulanmış adrestir. Bu gibi durumlarda teslim edilebilir bir adresiniz olur ancak nihai adresin reklamveren tarafından hedeflenen adres olduğuna bir fırsattır.
Müşteriye doğru istemi sunmak için mantığınız,
hangi işlemi belirlemek veya API'yi işaretlemek için hizmet tarafından işaretlenen bileşenler
inferred
, replaced
veya spellCorrected
gibi bileşene uygulanır.
Referansta AddressComponent (Adres bileşeni) konusuna bakın.
Sinyalleri onaylama
Address Validation API, bir adresi onaylanmalıdır.
1. Doğrulama Ayrıntı Düzeyi
ROUTE
veya daha iyi bir validationGranularity
kabul edilir ancak
İLK GÖSTERİM veya GÖNDERİM, teslim edilebilirliğe dair daha güçlü bir sinyal sağlar.
2. Diğer sinyaller
Müşteriyle adres girişini onaylamaya karar verirken karar, hangi bileşenlerin araştırılacağını belirlemek için aşağıdakileri sağlar:
Tahmin edilen veriler | hasInferredComponents alanı true olduğunda,
API'nin başka bir adresten topladığı bilgileri doldurduğunu biliyorsunuz
bileşenlerine ayıralım.
|
---|---|
Değiştirilen veriler | hasReplacedComponents alanı true olduğunda,
API, girilen verileri, adresi geçerli kıldığı verilerle değiştirdi.
|
3. ABD adres sinyalleri
Yalnızca ABD'deki adresler için geçerli olan belirli alanlar, mantığınızın Müşteriyle teyit almanız gerekir. Aşağıdakilerden biri geçerlidir:
dpvConfirmation
|
S
|
---|---|
Adres yanıtı | Şu değere sahip missingComponentType alanı içerir:
subpremise .
|
Bir adresi kabul etme
Verilen karar, müşterinin o hususa dair güven derecesi yüksek olduğu için bir adresi adres, teslimat kapsamında olmalı ve müşterinin başka işlem yapmasına gerek kalmadan kullanılabilir. önemli bir parçasıdır.
Sinyalleri kabul et
Address Validation API, bir adresi onaylanmalıdır.
1. Doğrulama Ayrıntı Düzeyi
PREMISE
veya daha iyi bir validationGranularity
kabul edilir ancak bazı yerlerde
durumlarda, ROUTE
yine de teslim edilecek bir adresi belirtir.
2. Diğer sinyaller
Yüksek kaliteli adres kararı aşağıdakileri de sağlamalıdır:
- Değiştirilen veri yok. Bu durumda,
hasReplacedComponents: FALSE
. - Tahmin edilen bileşen yok. Bu durumda,
hasInferredComponents: FALSE
.
3. ABD adres sinyalleri
Yalnızca ABD'deki adresler için geçerli olan belirli alanlar, yüksek kaliteli adres olduğunu gösterir. bir alan vardır. Kabul edilebilir bir ABD adresi için takip etmek için:
dpvConfirmation
|
Y
|
---|