Bu belgede, Address Validation API'den gelen çeşitli yanıtları işlemek için bir adres kontrol sistemi oluşturma süreci açıklanmaktadır. Yanıtın doğru kullanılması için mantığınızı nasıl oluşturacağınız, API'den gelen diğer sinyalleri nasıl araştıracağınız ve müşterilerinizden ne zaman ve nasıl daha fazla bilgi isteyeceğiniz ele alınmaktadır.
API yanıtı, genel olarak sisteminizin bir adresi işlemesi gereken aşağıdaki yöntemleri belirler:
- Düzelt: Adresin kalitesi düşük. Daha fazla bilgi için istemde bulunmalısınız.
- Onayla: Adres yüksek kalitede ancak giriş adresinde değişiklikler var. Onay isteyebilirsiniz.
- Kabul et: Adres yüksek kalitelidir. Belirtilen adresi kabul edebilirsiniz.
Temel amaç
Bu belge, sisteminizi API yanıtını en iyi şekilde analiz edecek ve sağlanan adreslerle gerçekleştirilecek sonraki işlemleri belirleyecek şekilde değiştirmenize yardımcı olur. Aşağıdaki sözde kod, olası bir akışı göstermektedir.
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.
Tam mantık durumunuza göre değişir. Daha fazla bilgi için Uygulama kılavuzu sayfasına göz atın. Genişletilmiş Bileşen Kitaplığı'ndaki bu mantığın açık kaynak uygulamamızı da kullanabilirsiniz.
İş 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. Burada açıklanan sinyaller
verdict
mülkünden alınır ve kontrol edilmesi gereken tek sinyal değildir. Ancak, adres kalitesine dair bir ilk gösterge sağlar. Her davranış türü, bu belgede incelemeniz gerekebilecek diğer sinyalleri açıklayan bir bölüme karşılık gelir.
Sistem davranışınız | |||
---|---|---|---|
Adresi düzeltme |
|
||
Adresi onaylayın |
|
||
Adresi kabul et |
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 modeli oluşturmanıza yardımcı olabilir. Ancak, bunlar yalnızca öneridir. Bu nedenle, uygulamanızın iş modelinize uygun olması gerektiğini unutmayın.
Rehberlik | Ayrıntılar | |
---|---|---|
Risk düzeyi |
Düzeltme isteğinde bulunma ile adresi girildiği şekliyle kabul etme arasında denge kurarken durumunuza uygun tolerans düzeyini göz önünde bulundurun. |
Address Validation API, doğrulama sürecinizi optimize etmek için risk düzeyinize dahil edebileceğiniz çeşitli sinyaller döndürür. Örneğin, bir adresin onaylanmamış sokak numarası varsa bu adresi yine de kabul edebilirsiniz. Diğer yandan, işletmenizin faaliyetleri daha fazla adres kesinliği gerektiriyorsa kullanıcınızdan istekte bulunabilirsiniz. Her iki kategoriye de denk olabilecek bir örnek için Adresi kabul et - örnekler başlıklı makalenin ABD dışındaki onaylanmamış sokak numarası bölümüne bakın. |
Adresleri kabul et |
Müşteri, istemlere yanıt vermezse sisteminizin orijinal girişi kabul etmesine izin vermek iyi bir uygulamadır. |
Bu durumlarda, müşteri sistemde olmayan bir adres (örneğin, yeni inşaat için) girmiş olabilir. |
Geri bildirim gönderme |
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 teslim edilemediği açıkça gösterildiğinde ilgili adresi düzeltin. Daha sonra sisteminiz müşteriden gerekli bilgileri sağlamasını isteyebilir. Bunun ardından, teslim edilecek bir adres almak için iş akışınızı yeniden gönderebilirsiniz.
Sinyalleri düzeltin
Address Validation API, bir adresin düzeltilmesi gerekip gerekmediğini bildirmek için bir dizi sinyal sağlar.
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 ortaya çıktığı ve nasıl düzeltileceği hakkında daha fazla bilgi edinmek için adres bileşeni sinyallerini incelemelidir.- İşlenmiş
address
nesnesi birmissingComponentTypes
alanı döndürdüğünde 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, belirli sorunların teşhis edilmesine yardımcı olacak diğer sinyalleri de sağlar:
Şüpheli bileşenler | Bir bileşenin onay düzeyi sıralaması UNCOMFIRMED_AND_SUSPICIOUS olduğunda bileşen yanlış olabilir.
|
---|---|
Çözümlenmemiş bileşen | unresolvedToken, girişin, adresin geçerli bir parçası olarak tanınmayan bir bölümüdür. |
3. ABD adres sinyalleri
Yalnızca ABD'deki adresler için geçerli olan belirli alanlar, adresin teslim edilemeyeceğine ve düzeltilmesi gerektiğine dair faydalı bir sinyal sağlar. Düzeltme gerektiren bir adres için şunu görürsünüz:
dpvConfirmation
|
N , D veya boş.
|
---|
dpvConfirmation
ile ilgili ayrıntılar için ABD adreslerini işleme bölümüne bakın.
Bir adresi onaylayın
Karar, Address Validation API'nin doğrulanmış bir adres oluşturmak için bileşenlerde tahminde bulunduğu veya değişiklikler yaptığını gösterdiğinde bir adresi onaylarsınız. Bu gibi durumlarda teslimat yapılan bir adresiniz vardır ancak sonuçta ortaya çıkacak adresin müşteri tarafından hedeflenen adres olduğundan daha emin olmayı tercih edersiniz.
Müşteriye doğru istemi sunmak için mantığınız, API'nin bileşene uygulanacak işlemi (ör. inferred
, replaced
veya spellCorrected
) belirlemek veya işaretlemek için hizmet tarafından işaretlenen bileşenleri tanımlar.
Referansta AddressComponent (Adres bileşeni) konusuna bakın.
Sinyalleri onaylama
Address Validation API, bir adresin onaylanıp onaylanmayacağını size bildirmek için bir dizi sinyal sağlar.
1. Doğrulama Ayrıntı Düzeyi
validationGranularity
değerinin ROUTE
veya daha yüksek olması kabul edilebilir ancak PREMISE veya SUBPREMISE, teslimata dair daha güçlü bir sinyal sağlar.
2. Diğer sinyaller
Müşteriyle adres girişini onaylamaya karar verilirken karar, incelenecek bileşenleri belirlemek için aşağıdakileri de sağlar:
Tahmin edilen veriler | hasInferredComponents alanı true olduğunda, API'nin diğer adres bileşenlerinden topladığı bilgileri doldurduğunu anlarsınız.
|
---|---|
Değiştirilen veriler | hasReplacedComponents alanı true olduğunda API, girilen verileri adresi geçerli saydığı verilerle değiştirir.
|
3. ABD adres sinyalleri
Yalnızca ABD'deki adresler için geçerli olan belirli alanlar, mantığınızın müşteriyle ayrıntıları onaylaması gerektiğini gösterir. Aşağıdakilerden biri geçerlidir:
dpvConfirmation
|
S
|
---|---|
Adres yanıtı | subpremise değerine sahip missingComponentType alanı içerir.
|
Bir adresi kabul etme
Verilen karar, adresin teslim edilebildiğine ve satışa dönük süreçte başka müşteri etkileşimi olmadan kullanılabildiğine dair yüksek derecede güven sağlıyorsa söz konusu adresi kabul etmiş olursunuz.
Sinyalleri kabul et
Address Validation API, bir adresin onaylanıp onaylanmayacağını size bildirmek için bir dizi sinyal sağlar.
1. Doğrulama Ayrıntı Düzeyi
PREMISE
veya daha iyi bir validationGranularity
kabul edilir ancak bazı durumlarda ROUTE
yine de teslimat adresi belirtir.
2. Diğer sinyaller
Yüksek kaliteli adresle ilgili karara göre aşağıdakiler de sağlanmalı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, teslim edilebilecek yüksek kaliteli adresleri gösterir. Kabul edilebilir bir ABD adresi için aşağıdakileri görmeniz gerekir:
dpvConfirmation
|
Y
|
---|