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