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

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

หมายเหตุ: ตัวอย่างด้านล่างเป็นเพียงตัวอย่างบางส่วน

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

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

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

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

ป้อนที่อยู่แล้ว	ภูมิภาค
21 45 40th street	USA

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

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

{
  "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 โดยละเว้นข้อมูลสำคัญบางอย่าง เช่น สถานที่ตั้งและรหัสไปรษณีย์

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

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

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

ป้อนที่อยู่แล้ว	ภูมิภาค
Buckingham Palace Road, SW1W 9TQ London	สหราชอาณาจักร

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

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

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

"missingComponentTypes": [
        "street_number"
      ]

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

ตัวอย่างกรณีสุดโต่ง: แก้ไข

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

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

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

ป้อนที่อยู่แล้ว	ภูมิภาค
84 Buckingham Palace Road, SW1W 9TQ, London	สหราชอาณาจักร

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

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

{
  "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 Doctor Carlton B Goodlett Place, San Francisco, CA 94102	USA

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

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

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

}

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

"missingComponentTypes": [
        "subpremise"
      ]

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

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