หน้านี้ได้รับการแปลโดย Cloud Translation API

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

เอกสารนี้อธิบายสถานการณ์จริงหลายอย่างที่ 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,
  "possibleNextAction": "CONFIRM"
}

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

ตัวอย่างกรณีที่สุ่มเสี่ยงจะละเมิดนโยบาย: ยืนยัน

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

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

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

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

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

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

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

ผลการตัดสินสำหรับเมืองที่ไม่มี

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

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

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

ป้อนที่อยู่แล้ว	ภูมิภาค
59 Cherrydown Avenue, Chingford, London E4 8DT	สหราชอาณาจักร

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

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "unconfirmedComponents": true,
  "possibleNextAction": "ACCEPT"
}

นอกเหนือจากผลการวินิจฉัยที่มีคอมโพเนนต์ที่ยังไม่ได้รับการยืนยันแล้ว Address Validation API ยังแสดงที่อยู่ที่จัดรูปแบบต่อไปนี้ด้วย

"formattedAddress": "59 Cherrydown Avenue, London E4 8DT, UK",

การสแกนหาคอมโพเนนต์ที่ยังไม่ได้รับการยืนยันแสดงให้เห็นว่า API ได้นำ Chingford ออกจากที่อยู่ที่ส่งคืนแล้ว

{
  "componentName": {
    "text": "Chingford",
    "languageCode": "en"
  },
  "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",
   "possibleNextAction": "ACCEPT"
}

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

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

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