สร้างตรรกะการตรวจสอบความถูกต้อง

เอกสารนี้อธิบายกระบวนการสร้างระบบตรวจสอบที่อยู่เพื่อจัดการการตอบกลับที่หลากหลายจาก Address Validation API ซึ่งจะอธิบายวิธีสร้างตรรกะเพื่อใช้คำตอบอย่างถูกต้อง วิธีตรวจสอบสัญญาณอื่นๆ จาก API และวิธีและเวลาที่ควรแจ้งให้ลูกค้าขอข้อมูลเพิ่มเติม

โดยทั่วไปแล้ว การตอบกลับของ API จะกําหนดวิธีที่ระบบควรจัดการที่อยู่ ดังนี้

• แก้ไข - ที่อยู่มีคุณภาพต่ำ คุณควรแจ้งขอข้อมูลเพิ่มเติม
• ยืนยัน - ที่อยู่มีคุณภาพสูง แต่มีการเปลี่ยนแปลงจากที่อยู่ที่คุณป้อน คุณอาจได้รับข้อความแจ้งให้ยืนยัน
• ยอมรับ - ที่อยู่มีคุณภาพสูง คุณสามารถยอมรับที่อยู่ที่ให้ไว้

จุดประสงค์หลัก

เอกสารนี้จะช่วยคุณแก้ไขระบบเพื่อวิเคราะห์การตอบกลับของ API ให้ได้ดีที่สุด และกำหนดการดำเนินการถัดไปกับที่อยู่ที่ให้ไว้ รหัสจำลองต่อไปนี้แสดงขั้นตอนที่เป็นไปได้

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.

ตรรกะที่ใช้จะขึ้นอยู่กับสถานการณ์ของคุณ ดูรายละเอียดเพิ่มเติมได้ในคําแนะนําการติดตั้งใช้งาน นอกจากนี้ คุณยังใช้การใช้งานแบบโอเพนซอร์สของตรรกะนี้ได้ ซึ่งอยู่ในไลบรารีคอมโพเนนต์แบบขยาย

ภาพรวมของเวิร์กโฟลว์

ตารางด้านล่างแสดงข้อมูลสรุปการดำเนินการ 2 รายการสำหรับระบบของคุณ

1. เวิร์กโฟลว์ที่จะใช้ตามลักษณะการแก้ไข ยืนยัน และยอมรับ
2. สัญญาณแรกที่จะตรวจสอบจากการตอบกลับ สัญญาณที่อธิบายไว้ที่นี่มาจากพร็อพเพอร์ตี้ verdict และไม่ใช่สัญญาณเดียวที่ต้องตรวจสอบ แต่เป็นตัวบ่งชี้เริ่มต้นเกี่ยวกับคุณภาพที่อยู่ ลักษณะการทำงานแต่ละประเภทจะสอดคล้องกับหัวข้อในเอกสารนี้ ซึ่งจะอธิบายสัญญาณเพิ่มเติมที่คุณอาจต้องตรวจสอบด้วย

ลักษณะการทํางานของระบบ
แก้ไขที่อยู่	การตอบกลับจาก verdict จะระบุข้อมูลสำคัญซึ่งขาดหายไปและควรระบุ ที่อยู่ที่ได้รับจาก Address Validation API อาจไม่ใช่คุณภาพที่นำไปใช้งานได้ ขั้นตอนการทำงาน ตรวจสอบองค์ประกอบที่อยู่หากจําเป็น แจ้งให้ลูกค้าแก้ไขปัญหา ขอรับการตรวจสอบที่อยู่ที่ได้รับการอัปเดต (ไม่บังคับ) ส่งคําขอไปยังปลายทางความคิดเห็นสําหรับ API ดูจัดการที่อยู่ที่ได้รับการอัปเดต ดำเนินการต่อโดยใช้ที่อยู่ สัญญาณคำตัดสิน ข้อใดข้อหนึ่งต่อไปนี้ ตั้งค่าvalidationGranularityเป็น OTHER ดูค่าความละเอียด addressComplete คือ false
ยืนยันที่อยู่	การตอบกลับจาก verdict ระบุที่อยู่ของไฟล์นำส่ง แต่ได้ทำการเปลี่ยนแปลงอินพุตเดิม: การอนุมานข้อมูลที่แก้ไขตัวสะกดแล้วหรือข้อมูลที่ยืนยันได้ ขั้นตอนการทำงาน การแก้ไขที่จำเป็น ตรวจสอบองค์ประกอบที่อยู่หากจําเป็น ส่งคำขอตรวจสอบที่อยู่ที่อัปเดตแล้ว (ไม่บังคับ) ส่งคําขอไปยังปลายทางความคิดเห็นสําหรับ API ดูจัดการที่อยู่ที่ได้รับการอัปเดต ดำเนินการต่อโดยใช้ที่อยู่ ไม่ต้องแก้ไข (ไม่บังคับ) ส่งคำขอไปยังปลายทางความคิดเห็นสำหรับ API ดูจัดการที่อยู่ที่ได้รับการอัปเดต ดำเนินการต่อโดยใช้ที่อยู่ สัญญาณคำตัดสิน ทุกข้อต่อไปนี้มีผลบังคับใช้ validationGranularity มี ROUTE หรือดีกว่า ดูค่าความละเอียด addressComplete คือ true ช่อง hasInferredComponents มีค่าเป็น true หรือ hasReplacedComponents ช่องคือ true
ยอมรับที่อยู่	การตอบกลับ Address Validation API ระบุว่าเป็นที่อยู่ที่มีคุณภาพดีมาก ขั้นตอนการทำงาน ดำเนินการต่อด้วยที่อยู่สำหรับคืนสินค้า สัญญาณคำตัดสิน ทุกข้อต่อไปนี้มีผลบังคับใช้ validationGranularity มี PREMISE หรือดีกว่า ดูค่าความละเอียด addressComplete คือ true ไม่มีคอมโพเนนต์ที่สรุปหรือแทนที่

หลักเกณฑ์การใช้งาน

เมื่อออกแบบวิธีที่ระบบจะตอบสนองต่อสัญญาณจาก Address Validation API คำแนะนำต่อไปนี้จะช่วยคุณสร้างรูปแบบการตอบสนองที่มีประสิทธิภาพมากขึ้น อย่างไรก็ตาม ข้อมูลเหล่านี้เป็นเพียงคําแนะนําเท่านั้น ดังนั้นโปรดทราบว่าการใช้งานควรเหมาะกับรูปแบบธุรกิจของคุณ

	คำแนะนำ	รายละเอียด
ระดับความเสี่ยง	พิจารณาระดับความยืดหยุ่นสำหรับสถานการณ์ของคุณเมื่อต้องหาจุดสมดุลระหว่างการแจ้งให้แก้ไขกับการยอมรับที่อยู่ตามที่ป้อน	Address Validation API จะแสดงสัญญาณต่างๆ ที่คุณใช้ร่วมกับระดับความเสี่ยงเพื่อเพิ่มประสิทธิภาพกระบวนการตรวจสอบได้ เช่น หากที่อยู่มีหมายเลขถนนที่ไม่ได้รับการยืนยัน คุณจะยังคงยอมรับที่อยู่นั้นได้ ในทางกลับกัน หากการดําเนินธุรกิจของคุณต้องใช้ที่อยู่ที่มีความแม่นยํามากขึ้น คุณอาจแจ้งให้ผู้ใช้ทราบ ดูตัวอย่างที่อาจจัดอยู่ในหมวดหมู่ใดหมวดหมู่หนึ่งได้ที่หมายเลขถนนที่ไม่ได้รับการยืนยันซึ่งไม่ใช่ของสหรัฐอเมริกาในที่อยู่ที่เรายอมรับ - ตัวอย่าง
ยอมรับที่อยู่	คุณควรอนุญาตให้ระบบยอมรับข้อมูลที่ป้อนครั้งแรกหากลูกค้าไม่ตอบกลับข้อความแจ้ง	ในกรณีเหล่านี้ ลูกค้าอาจป้อนที่อยู่ที่ไม่ได้อยู่ในระบบ เช่น ที่อยู่ของอาคารที่สร้างใหม่
แสดงความคิดเห็น	เมื่อส่งคำขอตรวจสอบที่อยู่อีกครั้ง คุณจะส่งคำขอไปยังปลายทาง provideValidationFeedback ได้ด้วย	ซึ่งจะช่วยให้ Google ทราบว่าคุณจัดการกับคำตอบสุดท้ายอย่างไร ดูจัดการที่อยู่ที่ได้รับการอัปเดต

ลองใช้เวอร์ชันสาธิต ส่วนที่เหลือของเอกสารนี้จะแสดงตัวอย่างต่างๆ เพื่อช่วยให้คุณเข้าใจกระบวนการแก้ไข ยืนยัน และยอมรับตามที่อธิบายไว้ข้างต้น คุณสามารถดูผลลัพธ์จากตัวอย่างเหล่านี้ได้โดยป้อนตัวอย่างในการสาธิต Address Validation API

แก้ไขที่อยู่

แก้ไขที่อยู่เมื่อผลการค้นหาระบุว่าที่อยู่นั้นไม่สามารถนำส่งได้อย่างชัดเจน จากนั้นระบบจะแจ้งให้ลูกค้าระบุข้อมูลที่จำเป็น จากนั้นคุณก็ออกเวิร์กโฟลว์อีกครั้งเพื่อรับที่อยู่สำหรับส่งไฟล์

หมายเหตุ: เมื่อส่งคำขอไปยัง Address Validation API สำหรับที่อยู่เดียวกันซ้ำแล้วซ้ำเล่า คุณสามารถเรียกใช้ provideValidationFeedback เพื่อระบุผลลัพธ์ ดูหัวข้อจัดการที่อยู่ของสหรัฐอเมริกา

แก้ไขสัญญาณ

Address Validation API มีสัญญาณหลายรายการที่จะแจ้งให้คุณทราบว่าควรแก้ไขที่อยู่หรือไม่

1. รายละเอียดการตรวจสอบและคอมโพเนนต์ที่ขาดหายไป

สัญญาณ 2 รายการต่อไปนี้เป็นสัญญาณที่บ่งบอกถึงที่อยู่ที่เป็นปัญหาได้ดีที่สุด

• เมื่อใดก็ตามที่ช่อง validationGranularity เป็น OTHER ระบบควรตรวจสอบสัญญาณขององค์ประกอบที่อยู่เพื่อดูข้อมูลเพิ่มเติมเกี่ยวกับจุดที่เกิดข้อผิดพลาดและวิธีแก้ไข
• เมื่อใดก็ตามที่ออบเจ็กต์ address ที่ประมวลผลแล้วแสดงผลฟิลด์ missingComponentTypes ระบบควรตรวจสอบคอมโพเนนต์นั้น คอมโพเนนต์ที่หายไปจะทำให้ที่อยู่ไม่สมบูรณ์และนำส่งไม่ได้ด้วย

2. สัญญาณอื่นๆ

Address Validation API ยังมีสัญญาณอื่นๆ เพื่อช่วยวินิจฉัยปัญหาที่เฉพาะเจาะจงด้วย

คอมโพเนนต์ที่น่าสงสัย	เมื่อลิสต์ระดับการยืนยันของคอมโพเนนต์เป็น UNCOMFIRMED_AND_SUSPICIOUS แสดงว่าคอมโพเนนต์นั้นไม่ถูกต้อง
คอมโพเนนต์ที่ยังไม่ได้รับการแก้ไข	unresolvedTokenเป็นส่วนหนึ่งของอินพุตที่ไม่ได้รับการยอมรับว่าเป็นส่วนที่ถูกต้องของที่อยู่

3. สัญญาณที่อยู่ของสหรัฐอเมริกา

ช่องบางช่องที่ใช้ได้กับที่อยู่ในสหรัฐอเมริกาเท่านั้นจะให้สัญญาณที่เป็นประโยชน์ว่าที่อยู่นั้นไม่สามารถนำส่งได้และควรได้รับการแก้ไข สำหรับที่อยู่ที่ต้องแก้ไข คุณควรเห็นข้อมูลต่อไปนี้

dpvConfirmation	N, D หรือว่างเปล่า

โปรดดูรายละเอียดเกี่ยวกับ dpvConfirmation ที่หัวข้อจัดการที่อยู่ของสหรัฐอเมริกา

แก้ไขตัวอย่างที่อยู่

ยืนยันที่อยู่

คุณยืนยันที่อยู่ได้เมื่อผลการตรวจสอบระบุว่า Address Validation API อนุมานหรือทําการเปลี่ยนแปลงองค์ประกอบที่อยู่เพื่อสร้างที่อยู่ที่ได้รับการตรวจสอบแล้ว ในกรณีเหล่านี้ คุณมีที่อยู่สำหรับจัดส่ง แต่ต้องการความมั่นใจมากขึ้นว่าที่อยู่ที่ได้นั้นเป็นที่อยู่ที่ต้องการของลูกค้า

ตรรกะของคุณจะระบุคอมโพเนนต์ที่บริการแจ้งว่าไม่เหมาะสมเพื่อพิจารณาการดำเนินการหรือ Flag ที่ API ใช้กับคอมโพเนนต์ เช่น inferred, replaced หรือ spellCorrected เพื่อให้ลูกค้าได้รับข้อความแจ้งที่ถูกต้อง ดู AddressComponent ในข้อมูลอ้างอิง

หมายเหตุ: พิจารณาระดับความเสี่ยงเมื่อตัดสินใจว่าจะยืนยันที่อยู่กับลูกค้าหรือยอมรับว่าถูกต้อง นอกจากนี้ หากคุณออกคําขอไปยัง Address Validation API อีกครั้ง โปรดเรียกใช้ provideValidationFeedback เพื่อแจ้งผลลัพธ์ ดูหัวข้อจัดการที่อยู่ที่มีการอัปเดต

ยืนยันสัญญาณ

Address Validation API มีสัญญาณหลายรายการที่จะแจ้งให้คุณทราบว่าควรยืนยันที่อยู่หรือไม่

1. รายละเอียดการตรวจสอบ

ระบบยอมรับ validationGranularity ที่มีค่าเท่ากับ ROUTE หรือดีกว่า แต่ PREMISE หรือ SUBPREMISE จะให้สัญญาณของความสามารถในการแสดงโฆษณามากกว่า

2. สัญญาณอื่นๆ

เมื่อตัดสินใจที่จะยืนยันการป้อนที่อยู่กับลูกค้า ผลการตัดสินจะระบุข้อมูลต่อไปนี้ด้วยเพื่อพิจารณาว่าต้องตรวจสอบองค์ประกอบใด

ข้อมูลที่อนุมาน	เมื่อฟิลด์ hasInferredComponents เป็น true แสดงว่า API เติมข้อมูลที่รวบรวมจากคอมโพเนนต์ที่อยู่อื่นๆ แล้ว
ข้อมูลที่แทนที่	เมื่อฟิลด์ hasReplacedComponents เป็น true แสดงว่า API ได้แทนที่ข้อมูลที่ป้อนด้วยข้อมูลที่เห็นว่าทำให้ที่อยู่ถูกต้อง

3. สัญญาณที่อยู่ของสหรัฐอเมริกา

ช่องบางช่องที่ใช้ได้กับที่อยู่ในสหรัฐอเมริกาเท่านั้นบ่งชี้ว่าตรรกะของคุณควรยืนยันรายละเอียดกับลูกค้า ตรงตามข้อใดข้อหนึ่งต่อไปนี้

dpvConfirmation	S ดูรายละเอียดเกี่ยวกับ dpvConfirmation ได้ที่จัดการที่อยู่ในสหรัฐอเมริกา
ที่อยู่ตอบกลับ	มีช่อง missingComponentType ที่มีค่าเป็น subpremise หมายเหตุ: หากช่องมีประเภทอื่นที่ไม่ใช่ subpremise การดำเนินการจะอยู่ในหมวดหมู่แก้ไขที่อยู่ ดูรายการประเภทที่อยู่ทั้งหมดในเอกสารประกอบการแปลงที่อยู่เป็นพิกัดภูมิศาสตร์

ตัวอย่างการยืนยันที่อยู่

ยอมรับที่อยู่

คุณยอมรับที่อยู่เมื่อผลการตัดสินมีความมั่นใจในระดับสูงว่าที่อยู่นั้นส่งได้และนำไปใช้ได้โดยไม่ต้องมีการโต้ตอบกับลูกค้าเพิ่มเติมในกระบวนการดาวน์สตรีม

ยอมรับสัญญาณ

Address Validation API มีสัญญาณหลายรายการที่จะแจ้งให้คุณทราบว่าควรยืนยันที่อยู่หรือไม่

1. รายละเอียดการตรวจสอบ

validationGranularity ของ PREMISE ขึ้นไปถือว่ายอมรับได้ แต่ในบางกรณี ROUTE จะยังคงระบุที่อยู่สำหรับนำส่ง

2. สัญญาณอื่นๆ

ผลการตัดสินสำหรับที่อยู่คุณภาพสูงควรระบุข้อมูลต่อไปนี้ด้วย

• ไม่มีข้อมูลที่แทนที่ ในกรณีนี้คือ hasReplacedComponents: FALSE
• ไม่มีคอมโพเนนต์ที่อิงตามข้อมูลที่มีอยู่ ในกรณีนี้คือ hasInferredComponents: FALSE

3. สัญญาณที่อยู่ของสหรัฐอเมริกา

ฟิลด์บางฟิลด์ที่ใช้ได้กับที่อยู่ในสหรัฐอเมริกาเท่านั้นจะระบุที่อยู่คุณภาพสูงที่สามารถนำส่งได้ สำหรับที่อยู่ในสหรัฐอเมริกาที่ยอมรับได้ คุณควรเห็นข้อความต่อไปนี้

dpvConfirmation	Y ดูรายละเอียดเกี่ยวกับ dpvConfirmation ได้ที่จัดการที่อยู่ในสหรัฐอเมริกา

ตัวอย่างที่อยู่สำหรับยอมรับ