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

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

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

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

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

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

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

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

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

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

เมื่อรวมกับข้อมูลที่ยืนยันแล้วในระดับที่ละเอียดยิ่งขึ้น 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
}

ไม่ได้ยืนยันคอมโพเนนต์ที่อยู่ที่ไม่คาดคิด

สถานการณ์นี้แสดงให้เห็นถึงความสำคัญของการตรวจสอบเมื่อคอมโพเนนต์ไม่ได้รับการยืนยัน หากคอมโพเนนต์ที่อยู่ไม่เป็นไปตามที่คาดหมาย 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 จะประเมินค่าเป็น false และการวิเคราะห์คอมโพเนนต์ที่อยู่จะแสดง Flag ที่ไม่คาดคิด

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

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