ยอมรับที่อยู่ - ตัวอย่าง

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

ตัวอย่างทั่วไป: ยอมรับ

สถานการณ์นี้แสดงที่อยู่ซึ่งระบบของคุณจะยอมรับที่อยู่ที่ลูกค้าป้อน

ป้อนที่อยู่ ภูมิภาค
76 ถนนบักกิงแฮมพาเลส ลอนดอน SW1W 9TQ สหราชอาณาจักร

คำตัดสินสำหรับที่อยู่ที่ยอมรับได้

ตัวอย่างด้านล่างไฮไลต์สัญญาณที่สำคัญ

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "addressComplete": true
}

นอกจากนี้ การตอบกลับจะระบุข้อมูลต่อไปนี้

  • hasUnconfirmedComponents ยังคงเป็น false
  • hasInferredComponents ยังคงเป็น false
  • hasReplacedComponents ยังคงเป็น false

เมื่อนำมารวมกัน สัญญาณเหล่านี้จะบ่งบอกถึงที่อยู่ที่มีคุณภาพสูง

ตัวอย่างกรณีสุดโต่ง: ยอมรับ

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

หมายเลขถนนที่ไม่ใช่ของสหรัฐอเมริกา

ตัวอย่างนี้แสดงรายการที่อยู่ในอิตาลีที่มีองค์ประกอบของที่อยู่ทั้งหมด โดยที่ไม่มีส่วนประกอบที่อนุมานหรือแทนที่ อย่างไรก็ตาม validationGranularity คือ ROUTE

ป้อนที่อยู่ ภูมิภาค
ถนน Via Fonte Grooknale, 14 หน่วย 2, 66054 VASTo CH, Italia ไอที

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

{
  "inputGranularity": "SUB_PREMISE",
  "validationGranularity": "ROUTE",
  "geocodeGranularity": "ROUTE",
  "addressComplete": true,
  "hasUnconfirmedComponents": true
}

การตรวจสอบเพิ่มเติมเกี่ยวกับคอมโพเนนต์ที่อยู่เผยให้เห็นว่าหมายเลขถนนคือ UNCONFIRMED_BUT_PLAUSIBLE

{
   "text": "14",
   "componentType": "street_number",
   "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
}

หมายเลขถนนในสหรัฐอเมริกาที่ยังไม่ยืนยัน

ตัวอย่างนี้แสดงรายการที่อยู่ในสหรัฐอเมริกาที่มีองค์ประกอบของที่อยู่ทั้งหมด โดยไม่มีองค์ประกอบที่อนุมานหรือแทนที่ อย่างไรก็ตาม validationGranularity คือ PREMISE_PROXIMITY

ป้อนที่อยู่ ภูมิภาค
975 คาร์สัน Dr, ซันนีเวล, แคลิฟอร์เนีย 94086 US

ข้อมูล USPS สำหรับหมายเลขถนนที่ยังไม่ได้ยืนยัน

{
   "firstAddressLine": "975 CARSON DR",
   "cityStateZipAddressLine": "SUNNYVALE CA 94086",
   "city": "SUNNYVALE",
   "state": "CA",
   "zipCode": "94086"
   "dpvConfirmation": "N",
   "dpvFootnote": "AAM3",
   "carrierRoute": "C031",
   "carrierRouteIndicator": "D",
   "postOfficeCity": "SUNNYVALE",
   "postOfficeState": "CA",
   "fipsCountyCode": "085",
   "county": "SANTA CLARA",
}

ข้อมูล USPS ไม่สมบูรณ์สำหรับที่อยู่ที่ยืนยันแล้ว

ตัวอย่างนี้แสดงรายการที่อยู่ในสหรัฐอเมริกาซึ่งมีองค์ประกอบของที่อยู่ทั้งหมดได้รับการยืนยัน โดยไม่มีองค์ประกอบที่อนุมานหรือแทนที่แล้ว และ validationGranularity เป็น PREMISE อย่างไรก็ตาม uspsData ไม่ได้ป้อนข้อมูลครบถ้วน และไม่มีค่า dpvConfirmation

ป้อนที่อยู่ ภูมิภาค
155 ถนน Via Condado Way, ปาล์มบีชการ์เด้น, ฟลอริดา 33418-1703 US

คำตัดสินสำหรับที่อยู่ที่ยืนยันแล้วที่มีข้อมูล USPS ไม่สมบูรณ์

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "addressComplete": true,
}

ข้อมูล USPS สำหรับที่อยู่ที่ยืนยันแล้วที่มีข้อมูล USPS ไม่สมบูรณ์

{
  "standardizedAddress": {
    "firstAddressLine": "155 VIA CONDADO WAY",
    "cityStateZipAddressLine": "PALM BEACH GARDENS",
    "city": "PALM BEACH GARDENS",
    "state": "FL",
    "zipCode": "33418"
  },
  "carrierRoute": "H018",
  "postOfficeCity": "PALM BEACH GARDENS",
  "postOfficeState": "FL"
}