แก้ไขที่อยู่ - ตัวอย่าง

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

หมายเหตุ: ตัวอย่างนี้เป็นเพียงตัวอย่างเท่านั้น แต่ไม่ครบถ้วนสมบูรณ์

ตัวอย่างทั่วไป: แก้ไข

ส่วนนี้จะอธิบายถึงตัวอย่างทั่วไปที่ Address Validation API ให้สัญญาณตอบกลับที่ระบุข้อมูลที่อยู่ที่มีคุณภาพต่ำกว่า

ไม่มีเมืองและรหัสไปรษณีย์

ตัวอย่างนี้แสดงรายการที่มีเฉพาะที่อยู่ โดยไม่มีเมืองหรือรหัสไปรษณีย์

ป้อนที่อยู่แล้ว	ภูมิภาค
21 45 40th Street	สหรัฐอเมริกา

คำตัดสินเกี่ยวกับเมืองและรหัสไปรษณีย์ที่ขาดหายไป

ตัวอย่างด้านล่างเน้นสัญญาณที่สำคัญจากคำตอบ

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "OTHER",
  "geocodeGranularity": "OTHER",
  "hasUnconfirmedComponents": true
}

สัญญาณเหล่านี้จะระบุที่อยู่ที่นำส่งไม่ได้ คุณจึงค้นหา addressComponents เพื่อดูข้อมูลเพิ่มเติมได้ดังนี้

{
  "componentName": {
    "text": "21",
    "languageCode": "en"
  },
  "componentType": "street_number",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
},
{
  "componentName": {
    "text": "45 40th street",
    "languageCode": "en"
  },
  "componentType": "route",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
},
{
  "componentName": {
    "text": "United States",
    "languageCode": "en"
  },
  "componentType": "country",
  "confirmationLevel": "CONFIRMED"
}

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

การดำเนินการ: สำหรับที่อยู่นี้ การดำเนินการที่แนะนำคือข้อความแจ้งผู้ใช้เกี่ยวกับข้อมูลที่ขาดหายไป

ไม่มีเลขที่ถนน

ตัวอย่างนี้แสดงหมายเลขถนนที่ขาดหายไป

ป้อนที่อยู่แล้ว	ภูมิภาค
ถนนบักกิงแฮมพาเลซ, SW1W 9TQ ลอนดอน	สหราชอาณาจักร

คำตัดสินเรื่องเลขที่ถนนขาดหายไป

{
    "inputGranularity": "PREMISE_PROXIMITY",
    "validationGranularity": "ROUTE",
    "geocodeGranularity": "ROUTE"
}

validationGranularity คือ ROUTE ซึ่งบ่งบอกว่าตรงกับถนน แต่มีข้อมูลไม่เพียงพอที่จะไปถึงสถานที่ นอกจากนี้ ไม่มีพร็อพเพอร์ตี้ addressComplete จากผลการตัดสินด้วย ดังนั้นจึงเป็น false การค้นหาเพิ่มเติมของออบเจ็กต์ address จะแสดงประเภทคอมโพเนนต์ที่ขาดหายไป

"missingComponentTypes": [
        "street_number"
      ]

การดำเนินการ: ในกรณีนี้ การดำเนินการที่แนะนำคือแจ้งให้ผู้ใช้ทราบข้อมูลที่ขาดหายไป

ตัวอย่างกรณีขอบ: แก้ไข

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

หมายเลขถนนที่ไม่ได้รับการยืนยัน

ในสถานการณ์นี้ Address Validation API จะยืนยันหมายเลขถนนที่ระบุไม่ได้ แต่ระบุว่าที่อยู่นั้นสมบูรณ์

ป้อนที่อยู่แล้ว	ภูมิภาค
84 ถนนเพลินจิต กรุงเทพฯ	สหราชอาณาจักร

คำตัดสินสำหรับหมายเลขถนนที่ไม่ได้รับการยืนยัน

ตัวอย่างด้านล่างเน้นถึงสัญญาณที่สำคัญ

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE_PROXIMITY",
  "geocodeGranularity": "PREMISE_PROXIMITY",
  "addressComplete" : true,
  "hasUnconfirmedComponents": true
}

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

{
  "componentName": {
    "text": "84",
    "languageCode": "en"
  },
  "componentType": "street_number",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
}

ในที่นี้ confirmation_level ของ street_number ตั้งค่าเป็น UNCONFIRMED_BUT_PLAUSIBLE ยังไม่ยืนยันหมายความว่าบริการไม่ตรงกับเลขที่ 84 ในชุดข้อมูล และเป็นไปได้หมายความว่าข้อมูลคอมโพเนนต์อาจยังใช้งานได้อยู่

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

ไม่มีสถานที่ตั้งย่อย

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

หมายเหตุ: ในบางประเทศ Address Validation API ไม่สามารถตรวจหาสถานที่ตั้งย่อยที่ขาดหายไปได้ ในขณะที่ในสหรัฐอเมริกา ที่อยู่ SUB_PREMISE ที่ขาดหายไปบ่งชี้ที่อยู่ที่นำส่งไม่ได้

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

ป้อนที่อยู่แล้ว	ภูมิภาค
1 ด็อกเตอร์ คาร์ลตัน บี กู๊ดเล็ตต์เพลส, ซานฟรานซิสโก, แคลิฟอร์เนีย 94102	สหรัฐอเมริกา

คำตัดสินสำหรับสถานที่ตั้งย่อยที่ขาดหายไป

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

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

}

คำค้นหา address จะแสดงข้อมูลต่อไปนี้

"missingComponentTypes": [
        "subpremise"
      ]

หลังจากที่สอบถามเพิ่มเติม ข้อมูล USPS จะให้รหัส dpvConfirmation ของ D ซึ่งบ่งชี้ถึงสถานที่ตั้งย่อยที่ขาดหายไป

การดำเนินการ: สำหรับที่อยู่นี้ การดำเนินการที่แนะนำคือข้อความแจ้งผู้ใช้เกี่ยวกับข้อมูลที่ขาดหายไป