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

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

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

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

ป้อนที่อยู่แล้ว ภูมิภาค
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"
    ]

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

ตัวอย่างกรณีสุดโต่ง: ยืนยัน

ตัวอย่างต่อไปนี้แสดงให้เห็นถึงประเภทกรณีขอบต่อไปนี้

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

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

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

ตัวอย่างเช่น ลูกค้าระบุที่อยู่ถนนที่ถูกต้องสำหรับร้านอาหาร 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
}

คอมโพเนนต์ที่อยู่ที่ไม่คาดคิดซึ่งได้รับการยืนยัน

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

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