Doğrulama mantığınızı oluşturun

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:

1. Düzeltmeye göre kullanılacak iş akışı, onaylama, kabul etme davranışı.
2. 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	verdict tarafından verilen yanıt, sağlanması gereken önemli bilgilerin eksik olduğunu gösteriyor. Address Validation API tarafından döndürülen adres teslimat kalitesinde olmayabilir. İş akışı Gerekirse adres bileşenlerini araştırın. Müşteriden adres sorunlarını düzeltmesini isteyin. Güncellenen adres için doğrulama isteyin. (İsteğe bağlı) API'nin geri bildirim uç noktasına bir istek gönderin. Güncellenen adresleri işleme alma başlıklı makaleye göz atın. Adresle devam et. Sonuç sinyalleri Aşağıdakilerden herhangi biri geçerlidir: validationGranularity şu değere ayarlandı: OTHER. Ayrıntı düzeyi değerlerini inceleyin. addressComplete false.
Adresi onaylayın	verdict tarafından gönderilen yanıt, teslim edilebilir bir adresi belirtiyor ancak orijinal girişte değişiklikler yapıldı: yazımı düzeltilmiş verileri veya onaylanabilecek verileri çıkarma. İş akışı Düzeltmeler gerekiyor: Gerekirse adres bileşenlerini araştırın. Güncellenen adres için doğrulama isteyin. (İsteğe bağlı) API'nin geri bildirim uç noktasına bir istek gönderin. Güncellenen adresleri işleme alma başlıklı makaleye göz atın. Adresle devam et. Düzeltme gerekmez: (İsteğe bağlı) API'nin geri bildirim uç noktasına bir istek gönderin. Güncellenen adresleri işleme alma başlıklı makaleye göz atın. Adresle devam et. Sonuç sinyalleri Aşağıdakilerin tümü geçerlidir: validationGranularity, ROUTE veya daha iyi bir içerik içeriyor. Ayrıntı düzeyi değerlerini inceleyin. addressComplete true. hasInferredComponents alanı true VEYA hasReplacedComponents alanı true.
Adresi kabul et	Address Validation API yanıtı, mükemmel kalite adresini gösteriyor. İş akışı Döndürülen adresle devam edin. Sonuç sinyalleri Aşağıdakilerin tümü geçerlidir: validationGranularity, PREMISE veya daha iyi bir içerik içeriyor. Ayrıntı düzeyi değerlerini inceleyin. addressComplete true. Tahmin edilen veya değiştirilen bileşen yoktur.

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, provideValidationFeedback uç noktasına istek de gönderebilirsiniz.	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.

Demoyu deneyin. Bu dokümanın geri kalanında, yukarıda açıklanan düzeltme, onaylama ve kabul etme süreçlerini anlamanıza yardımcı olacak çeşitli örnekler verilmiştir. Bu örneklerden sonuçları, bunları Address Validation API demosuna girerek inceleyebilirsiniz.

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.

Not: Aynı adres için Address Validation API'ye yapılan istekleri tekrar ettiğinizde sonucunuzu belirtmek için provideValidationFeedback çağrısı yapabilirsiniz. Amerika Birleşik Devletleri'ndeki Adresleri Yönetme bölümünü inceleyin.

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 bir missingComponentTypes 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.

Düzeltme adresi örnekleri

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.

Not: Müşteriyle adresi onaylamaya veya geçerli olarak kabul etmeye karar verirken risk seviyenizi göz önünde bulundurun. Ayrıca, Address Validation API'ye yeniden istek göndermeniz durumunda, sonucunuzu belirtmek için provideValidationFeedback çağrısı yapabilirsiniz. Güncellenen adresleri işleme 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 dpvConfirmation ile ilgili ayrıntılar için ABD adreslerini işleme bölümüne bakın.
Adres yanıtı	subpremise değerine sahip missingComponentType alanı içerir. Not: Alan, subpremise dışında türler içeriyorsa işlem, adres düzeltme kategorisine girer. Adres türlerinin tam listesini Coğrafi Kodlama dokümanlarında bulabilirsiniz.

Adres örneklerini onaylama

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 dpvConfirmation ile ilgili ayrıntılar için ABD adreslerini işleme bölümüne bakın.

Kabul etme adresi örnekleri