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

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

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

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

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

ตัวอย่างกรณี Edge: ยืนยัน

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

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

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

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

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

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

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

คำตัดสินกรณีเมืองสูญหาย

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

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

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

คอมโพเนนต์ที่อยู่ที่ไม่คาดคิดซึ่ง IS ยืนยันแล้ว

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

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

ป้อนที่อยู่แล้ว	ภูมิภาค
33 Dunalley St, Cheltenham, กลอสเตอร์เชอร์, 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
}

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