สร้างตรรกะการตรวจสอบ

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

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

สัญญาณ 2 อย่างนี้เป็นตัวบ่งชี้ที่ดีที่สุดว่าที่อยู่มีปัญหา

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

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

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

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

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

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

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

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

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

ตรรกะของคุณจะระบุคอมโพเนนต์ที่บริการแจ้งว่าไม่เหมาะสมเพื่อพิจารณาว่า 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. สัญญาณที่อยู่ของสหรัฐอเมริกา

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

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