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

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

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

ตัวอย่างต่อไปนี้แสดงกรณีของเขตเมืองที่มีชื่อถนนคล้ายกัน สมมติว่าผู้ใช้ต้องการป้อนที่อยู่ของ Google Building D ในเคิร์กแลนด์ รัฐวอชิงตัน สหรัฐอเมริกา แต่ป้อนชื่อเมืองเป็น Seattle แทน Kirkland โดยไม่ตั้งใจ

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

ตัวอย่างกรณีที่เป็นปัญหาที่สุด: ยืนยัน

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

การอนุมานเล็กน้อยที่ได้รับการยืนยัน

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

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

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

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

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

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

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

จากตัวอย่างข้างต้น การสแกนคอมโพเนนต์ที่อยู่ทั้งหมดแสดงให้เห็นว่าคอมโพเนนต์ทุกรายการได้รับการยืนยัน ซึ่งหมายความว่าตรงกับข้อมูลที่ 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
}

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

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

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

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

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

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

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

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

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