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

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

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

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

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

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

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

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

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

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

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

possibleNextAction แสดงตัวบ่งชี้เบื้องต้นว่าที่อยู่อาจนำส่งไม่ได้ คอมโพเนนต์อื่นๆ ที่ไฮไลต์ก็รองรับตัวเลือกนี้เช่นกัน คุณจึงค้นหา 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",
    "possibleNextAction": "FIX"
}

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

"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,
  "possibleNextAction": "ACCEPT"
}

คุณควรตรวจสอบการรวมความละเอียดของการตรวจสอบเพื่อหาค่าประมาณระดับสถานที่ตั้งเท่านั้น พร้อมกับคอมโพเนนต์ที่ยังไม่ยืนยัน การค้นหาพร็อพเพอร์ตี้ 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,
  "possibleNextAction": "CONFIRM_ADD_SUBPREMISES"
}

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

"missingComponentTypes": [
        "subpremise"
      ]

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

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