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