เอกสารนี้อธิบายสถานการณ์จริงหลายอย่างที่ Address Validation API ให้สัญญาณการตอบกลับที่รับประกันลักษณะการทำงานแบบยอมรับ จากระบบของคุณ ดูภาพรวมเวิร์กโฟลว์ ในใช้การตอบกลับการตรวจสอบเพื่อดูบริบท
ตัวอย่างที่พบบ่อย: ยอมรับ
สถานการณ์นี้แสดงที่อยู่ที่ระบบจะยอมรับ ที่อยู่ที่ลูกค้าป้อน
ป้อนที่อยู่แล้ว | ภูมิภาค |
---|---|
76 Buckingham Palace Road, London SW1W 9TQ | สหราชอาณาจักร |
คำตัดสินสำหรับที่อยู่ที่ยอมรับได้
ตัวอย่างด้านล่างไฮไลต์สัญญาณสำคัญ
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"addressComplete": true
}
นอกจากนี้ verdict
ยังระบุสิ่งต่อไปนี้ด้วย
- เหลืออีก
hasUnconfirmedComponents
จากfalse
- เหลืออีก
hasInferredComponents
จากfalse
- เหลืออีก
hasReplacedComponents
จากfalse
เมื่อรวมกันแล้ว สัญญาณเหล่านี้จะบ่งบอกถึงที่อยู่ที่มีคุณภาพสูง
ตัวอย่างกรณีสุดโต่ง: ยอมรับ
ตัวอย่างต่อไปนี้ครอบคลุมสถานการณ์ที่
verdict
บ่งชี้ปัญหาด้านคุณภาพของที่อยู่ที่ควรตรวจสอบเพิ่มเติม ตัวอย่างเหล่านี้ยังแสดงให้เห็นว่าตรรกะของคุณสามารถเดินทางจากผลการตัดสินไปยัง
คอมโพเนนต์ที่อยู่เพื่อรับภาพที่สมบูรณ์ยิ่งขึ้นเพื่อปรับปรุงตรรกะของระบบ
หมายเลขถนนที่ยังไม่ได้รับการยืนยันนอกสหรัฐอเมริกา
ตัวอย่างนี้แสดงการ��้อนที่อยู่ของอิตาลีที่มีคอมโพเนนต์ที่อยู่ทั้งหมด
พร้อมทั้งไม่มีคอมโพเนนต์ที่อนุมานหรือแทนที่ อย่างไรก็ตาม
validationGranularity
คือ ROUTE
ป้อนที่อยู่แล้ว | ภูมิภาค |
---|---|
Via Fonte Grugnale, 14 unit 2, 66054 Vasto CH, Italia | IT |
คำตัดสินสำหรับหมายเลขถนนที่ยังไม่ได้รับการยืนยัน
{
"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 Carson Dr, Sunnyvale, CA 94086 | สหรัฐอเมริกา |
ข้อมูล 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, Palm Beach Gardens, FL 33418-1703 | สหรัฐอเมริกา |
ผลการตัดสินสำหรับที่อยู่ที่ยืนยันแล้วซึ่งมีข้อมูล 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"
}