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

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

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

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

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

เอกสารนี้จะช่วยคุณแก้ไขระบบเพื่อวิเคราะห์การตอบกลับของ 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 และไม่ใช่สัญญาณเพียงอย่างเดียวที่จะตรวจสอบ แต่เป็นตัวบ่งชี้เบื้องต้นเกี่ยวกับคุณภาพของที่อยู่ ลักษณะการทำงานแต่ละประเภทจะสอดคล้องกับส่วนในเอกสารนี้ซึ่งอธิบายสัญญาณเพิ่มเติมที่คุณอาจต้องตรวจสอบด้วย

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

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

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

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

แก้ไขสัญญาณ

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

1. รายละเอียดการตรวจสอบความถูกต้อง

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

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

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

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

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

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

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

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

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

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

1. รายละเอียดการตรวจสอบความถูกต้อง

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

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

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

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

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

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

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