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

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

หมายเหตุ: ตัวอย่างด้านล่างเป็นเพียงตัวอย่างบางส่วน

ตัวอย่างที่พบบ่อย: ยืนยัน

ตัวอย่างต่อไปนี้แสดงกรณีของพื้นที่มหานครที่มีชื่อถนนคล้ายกัน สมมติว่าผู้ใช้ต้องการป้อนที่อยู่ของ Google Building D ใน Kirkland, WA, United States แต่ป้อนซีแอตเทิลแทนเคิร์กแลนด์

ป้อนที่อยู่แล้ว	ภูมิภาค
อาคาร D, 451 7th Avenue South, Seattle, WA 98033	สหรัฐอเมริกา

ผลการตรวจสอบข้อมูลทดแทน

ตัวอย่างด้านล่างจะเน้นสัญญาณที่สําคัญจากการตอบกลับ

{
  "inputGranularity": "SUB_PREMISE",
  "validationGranularity": "PREMISE_PROXIMITY",
  "geocodeGranularity": "PREMISE_PROXIMITY",
  "addressComplete": true,
  "hasUnconfirmedComponents": true
  "hasReplacedComponents": true
}

PREMISE_PROXIMITY บ่งบอกถึงการประมาณที่อยู่ระดับอาคาร แต่จะไม่ละเอียดเท่ากับ SUB_PREMISE ซึ่งเป็นความละเอียดที่ระบุไว้ในอินพุต การตอบกลับยังมีทั้งคอมโพเนนต์ที่ยืนยันและไม่ยืนยันด้วย ดังนั้นการรวมกันนี้จึงจัดอยู่ในหมวดหมู่ยืนยัน

การค้นหาองค์ประกอบที่อยู่แสดงให้เห็นถึงประเด็นที่น่ากังวลดังต่อไปนี้

{
  "componentName": {
    "text": "451",
  },
  "componentType": "street_number",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE",
}
...
{
  "componentName": {
    "text": "98104",
  },
  "componentType": "postal_code",
  "confirmationLevel": "CONFIRMED",
  "replaced": true
}
...
{
  "componentName": {
    "text": "Building D",
    "language_code": "en"
  },
  "componentType": "subpremise",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE",
}
.......

    "unconfirmedComponentTypes": [
      "street_number",
      "subpremise"
    ]

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

เคล็ดลับ: ตรวจสอบที่อยู่ที่ใช้ในเดโมที่ถูกต้องโดยใช้ 451 7th Avenue South, Kirkland, WA 98033 เพื่อดูการตอบกลับสำหรับที่อยู่ที่ต้องการใช้ตั้งแต่แรก

การดำเนินการ: ยืนยันข้อมูลที่อยู่ที่ลูกค้าป้อน

ตัวอย่างกรณีที่สุ่มเสี่ยงจะละเมิดนโยบาย: ยืนยัน

ตัวอย่างต่อไปนี้แสดงประเภทของเคสขอบต่อไปนี้

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

ข้อมูลอนุมานเล็กน้อยที่ยืนยันแล้ว

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

• เมือง
• รัฐ
• รหัสไปรษณีย์
• ประเทศ

ตัวอย่างเช่น ลูกค้าระบุที่อยู่ซึ่งถูกต้องของร้านอาหาร McDonald's ในสปริงฟิลด์ รัฐแมสซาชูเซตส์ แต่ลืมป้อนเมืองและระบุรหัสไปรษณีย์ที่ไม่มีส่วนขยาย 4 หลัก

ป้อนที่อยู่แล้ว	ภูมิภาค
1402 Allen St, MA 01118	สหรัฐอเมริกา

คำตัดสินสำหรับเมืองที่ขาดหายไป

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "addressComplete": true,
  "hasInferredComponents": true
}

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

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

{
  "componentName": {
    "text": "Springfield",
    "languageCode": "en"
  },
  "componentType": "locality",
  "confirmationLevel": "CONFIRMED",
  "inferred": true
},
{
  "componentName": {
    "text": "1806"
  },
  "componentType": "postal_code_suffix",
  "confirmationLevel": "CONFIRMED",
  "inferred": true
}

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

องค์ประกอบที่อยู่ที่ไม่คาดคิด ไม่ได้ยืนยัน

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

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

ป้อนที่อยู่แล้ว	ภูมิภาค
1 Rue Grenache, la caritat 2, 34630 Saint-Thibéry	ฝรั่งเศส

คำตัดสินสำหรับองค์ประกอบที่อยู่ที่ไม่คาดคิดไม่ได้รับการยืนยัน

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "unconfirmedComponents": true
}

นอกเหนือจากผลการตรวจสอบที่มีองค์ประกอบที่ยังไม่ได้ยืนยันแล้ว Address Validation API จะแสดงผลที่อยู่ที่มีการจัดรูปแบบดังต่อไปนี้

"formattedAddress": "1 Rue Grenache, 34630 Saint-Thibéry, France",

การสแกนหาคอมโพเนนต์ที่ยังไม่ยืนยันแสดงให้เห็นว่า API นำ la caritat 2 ออกจากที่อยู่ที่ได้รับ

{
  "componentName": {
    "text": "la caritat 2",
    "languageCode": "fr"
  },
  "componentType": "sublocality_level_1",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE",
  "unexpected": true
}

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

องค์ประกอบที่อยู่ที่ไม่คาดคิดซึ่งได้รับการยืนยันแล้ว

ตัวอย่างนี้แสดงการรวมเขตของสหราชอาณาจักรไว้ในที่อยู่ในที่อยู่ที่ระบุ ซึ่งเป็นแนวทางปฏิบัติทั่วไป อย่างไรก็ตาม นี่เป็นข้อกำหนดที่ไม่ได้กำหนดโดยหน่วยงานไปรษณีย์ของสหราชอาณาจักรและโดยทั่วไปแล้วจะไม่สนใจ โปรดดูที่ postoffice.co.uk และวิธีจ่าหน้าซองจดหมายในสหราชอาณาจักรและระหว่างประเทศ

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

ป้อนที่อยู่แล้ว	ภูมิภาค
33 Dunalley St, Cheltenham, Gloucestershire, GL50 4AP	สหราชอาณาจักร

คำตัดสินสำหรับองค์ประกอบที่อยู่ที่ไม่คาดคิดซึ่งได้รับการยืนยันแล้ว

{
   "inputGranularity": "PREMISE",
   "validationGranularity": "PREMISE",
   "geocodeGranularity": "PREMISE"
}

ในกรณีนี้ address_complete จะประเมินเป็นเท็จ และการวิเคราะห์คอมโพเนนต์ที่อยู่จะแสดง Flag ที่ไม่คาดคิด

{
  "componentName": {
    "text": "Gloucestershire",
    "languageCode": "en"
  },
  "componentType": "administrative_area_level_2",
  "confirmationLevel": "CONFIRMED",
  "unexpected": true
}

คอมโพเนนต์นี้มีทั้งที่ไม่คาดหมายและได้รับการยืนยัน ซึ่งหมายความว่า

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

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

การดําเนินการ: สําหรับสถานการณ์นี้ การดําเนินการที่แนะนําคือไม่ต้องสนใจสัญญาณนี้และยอมรับที่อยู่