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

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

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

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

ส่วนนี้จะอธิบายตัวอย่างทั่วไปที่ 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 จึงไม่ปรากฏในการตรวจสอบผลการตรวจสอบด้วยตนเอง

หมายเหตุ: ในบางประเทศ 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 ซึ่งบ่งบอกถึงสถานที่ย่อยที่ขาดหายไปเช่นกัน

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