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

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

ตัวอย่างทั่วไป: accept

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

ป้อนที่อยู่แล้ว ภูมิภาค
76 Buckingham Palace Road, London SW1W 9TQ สหราชอาณาจักร

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

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

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

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

  • 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"
}