เอกสารนี้อธิบายสถานการณ์จริงหลายๆ สถานการณ์ ซึ่ง 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"
}