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ı doğru şekilde kullanmak için mantığınızı nasıl oluşturabileceğinizi, API'den gelen diğer sinyalleri araştırmayı nasıl sağlayacağınızı ve müşterilerinizden ne zaman ve nasıl daha fazla bilgi isteyeceklerini öğrenebilirsiniz.

Genel olarak API yanıtı, sisteminizin bir adresi işlemesi gereken şu yöntemleri belirler:

• Düzelt: Adres düşük kaliteli. Daha fazla bilgi isteminde bulunmanız gerekir.
• Onayla: Adres yüksek kalitede ancak giriş adresinde değişiklik içeriyor. Onay isteyebilirsiniz.
• Kabul et: Adres yüksek kalitededir. Belirtilen adresi kabul edebilirsiniz.

Temel amacı

Bu belge, API yanıtını en iyi şekilde analiz etmek için sisteminizi değiştirmenize ve sağlanan adreslerle ilgili sonraki işlemleri belirlemenize 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.

Mantık, durumunuza bağlıdır. Daha fazla bilgi için Uygulama rehberini inceleyin. Bu mantığın, Genişletilmiş Bileşen Kitaplığı'ndaki açık kaynak uygulamamızı da kullanabilirsiniz.

İş akışına genel bakış

Aşağıdaki tabloda sisteminizde gerçekleştirilecek iki işlem özetlenmiştir:

1. Düzeltme, onaylama, kabul etme davranışına göre kullanılacak iş akışı.
2. Yanıtta kontrol edilecek ilk sinyaller. Burada açıklanan sinyaller verdict özelliğinden gelir ve kontrol edilmesi gereken tek sinyal değildir ancak adres kalitesi için başlangıç göstergelerini sunarlar. Her davranış türü, bu belgenin araştırmanız gerekebilecek diğer sinyalleri açıklayan bir bölüme karşılık gelir.

Sistem davranışınız
Adresi düzeltme	verdict yanıtı, sağlanması gereken önemli eksik bilgileri belirtiyor. Address Validation API'nin döndürdüğü adres teslimat kalitesinde olmayabilir. İş akışı Gerekirse adres bileşenlerini inceleyin. Müşteriden adres sorunlarını düzeltmesini isteyin. Güncel adres için doğrulama isteyin. (İsteğe bağlı) API'nin geri bildirim uç noktasına istek gönderin. Güncellenen adresleri işleme başlıklı makaleye göz atın. Adresle devam edin. Karar sinyalleri Aşağıdakilerden herhangi biri geçerlidir: validationGranularity şu değere ayarlandı: OTHER. Ayrıntı düzeyi değerlerine bakın. addressComplete false durumunda.
Adresi onaylayın	verdict yanıtı bir teslimat adresini belirtiyor ancak orijinal girişte değişiklikler yaptı: Yazımı düzeltilmiş veriler veya onaylanabilecek veriler için çıkarım yapmak. İş akışı Gerekli düzeltmeler: Gerekirse adres bileşenlerini inceleyin. Güncel adres için doğrulama isteyin. (İsteğe bağlı) API'nin geri bildirim uç noktasına istek gönderin. Güncellenen adresleri işleme başlıklı makaleye göz atın. Adresle devam edin. Düzeltme gerekmez: (İsteğe bağlı) API'nin geri bildirim uç noktasına istek gönderin. Güncellenen adresleri işleme başlıklı makaleye göz atın. Adresle devam edin. Karar sinyalleri Aşağıdakilerin tümü geçerlidir: validationGranularity, ROUTE veya daha iyi bir değer içeriyor. Ayrıntı düzeyi değerlerine bakın. addressComplete true durumunda. hasInferredComponents alanı true VEYA hasReplacedComponents alanı true.
Adresi kabul edin	Address Validation API yanıtı, mükemmel kalitede bir adres olduğunu gösteriyor. İş akışı Döndürülen adresle devam edin. Karar sinyalleri Aşağıdakilerin tümü geçerlidir: validationGranularity, PREMISE veya daha iyi bir değer içeriyor. Ayrıntı düzeyi değerlerine bakın. addressComplete true durumunda. Tahmin edilen veya değiştirilmiş bileşen yok.

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.

	Yönergeler	Ayrıntılar
Risk düzeyi	Düzeltme isteme ile adresi girildiği şekliyle kabul etme arasında denge kurarken durumunuza göre 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 adres onaylanmamış bir sokak numarası içeriyorsa bu numarayı yine de kabul edebilirsiniz. Öte yandan, işletme faaliyetleriniz daha fazla adres kesinliği gerektiriyorsa kullanıcınızı bu konuda bilgilendirebilirsiniz. Bu kategorilerden herhangi birinin kapsamına girebilecek bir örnek için Kabul edilen adres - örnekler başlıklı makaledeki ABD dışı onaylanmamış sokak numarası bölümüne göz atın.
Adresleri kabul et	Müşteri istemlere yanıt vermiyorsa sisteminizin orijinal girişi kabul etmesine izin vermek iyi bir uygulamadır.	Böyle durumlarda müşteri, yeni inşaat gibi sistemde bulunmayan bir adres girmiş olabilir.
Geri bildirim gönderme	Adres doğrulama isteğini yeniden gönderdiğinizde provideValidationFeedback uç noktasına da istek gönderebilirsiniz.	Bu, Google'ın nihai yanıtı nasıl ele aldığınızı bilmesini sağlar. Güncellenen adresleri işleme başlıklı makaleye göz atın.

Demoyu deneyin. Bu belgenin geri kalanında, yukarıda açıklanan düzeltmeyi anlamanıza, onaylamanıza ve kabul etmenize yardımcı olacak çeşitli örnekler kullanılmaktadır. Bu örneklerden sonuçları, Address Validation API demosuna girerek inceleyebilirsiniz.

Adres düzeltme

Sonuçlar adresin teslim edilemez olduğunu açıkça belirttiğinde adresi düzeltin. Ardından, sisteminiz müşteriden gerekli bilgileri vermesini isteyebilir ve ardından teslimat adresi almak için iş akışınızı yeniden gönderirsiniz.

Not: Aynı adres için Address Validation API'ye gönderilen istekleri tekrarladığınızda sonucunuzu belirtmek için provideValidationFeedback numaralı telefonu arayabilirsiniz. ABD Adreslerini İşleme başlıklı makaleyi inceleyin.

Sinyalleri düzeltin

Address Validation API, bir adresin düzeltilmesi gerekip gerekmediğini size bildirmek için çeşitli sinyaller 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 oluştuğu ve nasıl düzeltileceği hakkında daha fazla bilgi edinmek için adres bileşeni sinyallerini incelemelidir.
• Son işlenmiş address nesnesi bir missingComponentTypes alanı döndürdüğünde sisteminizin bu bileşeni kontrol etmesi gerekir. Eksik bileşenler, bir adresin de eksik ve teslim edilemez olmasına 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 muhtemelen yanlıştır.
Çözümlenmemiş bileşen	unresolvedToken, girişin geçerli bir adres olarak tanınmayan kısmıdır.

3. ABD adres sinyalleri

Yalnızca ABD'deki adresler için geçerli olan belirli alanlar, adresin teslim edilebilir olmadığı ve düzeltilmesi gerektiği konusunda faydalı bir sinyal sağlar. Düzeltme gerektiren bir adres için aşağıdakileri görürsünüz:

dpvConfirmation	N, D veya boş.

dpvConfirmation hakkında ayrıntılı bilgi için ABD'deki adresleri işleme bölümüne bakın.

Adres sorunlarını giderme ile ilgili örnekler

Adresi onaylayın

Kararda Address Validation API'nin doğrulanmış bir adres oluşturmak için adres bileşenlerinde tahminde bulunulduğu veya değişiklik yaptığı belirtiliyorsa adresi onaylarsınız. Bu gibi durumlarda teslimat adresiniz vardır ancak nihai adresin müşterinin istediği adres olduğuna daha fazla güvenmeyi tercih edersiniz.

Müşteriye doğru istemi sağlamak amacıyla mantığınız, hizmet tarafından işaretlenen bileşenleri tanımlar ve inferred, replaced ya da spellCorrected gibi bileşene hangi işlemin uygulanacağını belirler veya API'yi işaretler. Referansta AddressComponent'a bakın.

Not: Adresi müşteriyle onaylama veya geçerli olarak kabul etme konusunda karar verirken risk düzeyinizi göz önünde bulundurun. Ayrıca Address Validation API'ye yeniden istekler gönderirseniz sonucunuzu belirtmek için provideValidationFeedback numaralı telefonu çağırabilirsiniz. Güncellenen adresleri işleme bölümüne bakın.

Sinyalleri onaylama

Address Validation API, bir adresin onaylanması gerekip gerekmediğini size bildirmek için çeşitli sinyaller sağlar.

1. Doğrulama Ayrıntı Düzeyi

ROUTE veya daha yüksek bir validationGranularity değeri kabul edilir ancak PREMISE veya SUBPREMISE, daha güçlü bir yayınlama sinyali sağlar.

2. Diğer sinyaller

Müşteriyle adres girişini onaylama kararı verilirken kararda hangi bileşenlerin araştırılacağına karar verilmesi için şu bilgiler de sağlanır:

Tahmin edilen veriler	hasInferredComponents alanı true olduğunda API'nin diğer adres bileşenlerinden topladığı bilgileri doldurduğunu bilirsiniz.
Değiştirilen veriler	hasReplacedComponents alanı true olduğunda API, girilen verileri adresi geçerli olduğu kabul edilen 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 olan 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'deki adresleri işleme başlıklı makaleye göz atın.
Adres yanıtı	subpremise değerine sahip missingComponentType alanını 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 belgelerinde bulabilirsiniz.

Adres örneklerini onaylama

Adres kabul etme

Verilen karar, adresin teslimat yapılabileceğine ve satışa dönük süreçte başka müşteri etkileşimine gerek olmadan kullanılabildiğine dair büyük ölçüde güven verdiğinde adresi kabul edersiniz.

Sinyalleri kabul et

Address Validation API, bir adresin onaylanması gerekip gerekmediğini size bildirmek için çeşitli sinyaller sağlar.

1. Doğrulama Ayrıntı Düzeyi

PREMISE değeri veya daha iyi bir validationGranularity değeri kabul edilir ancak bazı durumlarda ROUTE yine de teslimat adresini belirtir.

2. Diğer sinyaller

Yüksek kaliteli bir adres kararında ayrıca 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, bu adrese teslim edilebilen yüksek kaliteli bir adres belirtir. Kabul edilebilir bir ABD adresi için aşağıdaki bilgileri görmeniz gerekir:

dpvConfirmation	Y dpvConfirmation ile ilgili ayrıntılar için ABD'deki adresleri işleme başlıklı makaleye göz atın.

Kabul edilen adres örnekleri