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

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

validationGranularityPREMISE หรือดีกว่านั้นเป็นที่ยอมรับได้ แต่ในบางกรณี ROUTE ยังคงระบุที่อยู่ที่นำส่งได้

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

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

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

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

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

ตัวอย่างแอดเดรส