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

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

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

ที่อยู่ที่ป้อน ภูมิภาค
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 ซึ่งบ่งชี้ว่าไม่มีสถานที่ย่อยด้วย