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

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

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

ส่วนนี้จะอธิบายตัวอย่างทั่วไปที่ 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 เพิ่มเติมเผยให้เห็นประเภทคอมโพเนนต์ที่ขาดหายไป ดังนี้

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

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

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