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

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

ตัวอย่างทั่วไป: ยืนยัน

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

การค้นหาคอมโพเนนต์ที่อยู่เผยให้เห็นพื้นที่ที่น่ากังวลต่อไปนี้

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

ตัวอย่างกรณีพิเศษ: ยืนยัน

ตัวอย่างต่อไปนี้แสดงกรณีพิเศษประเภทต่างๆ ดังนี้

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

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

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

ตัวอย่างเช่น ลูกค้าระบุที่อยู่ถนนที่ถูกต้องสำหรับร้านอาหาร McDonald's ในเมือง Springfield รัฐ Massachusetts แต่ลืมป้อนเมืองและระบุรหัสไปรษณีย์โดยไม่มีส่วนขยาย 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 ยังประเมินข้อมูลเพื่อดูการจัดรูปแบบที่ถูกต้องด้วย