ทำความเข้าใจคำตอบในการตรวจสอบความถูกต้องของที่อยู่พื้นฐาน

การตอบกลับจาก Address Validation API มีพร็อพเพอร์ตี้ระดับบนสุดต่อไปนี้

{
  // Address details determined by the API.
  "address": {},
  // Validation verdict.
  "verdict": {},
  // The geocode generated for the input address.
  "geocode": {},
  // Information indicating if the address is a business, residence, etc.
  "metadata": {},
  // Information about the address from the US Postal Service
  // ("US" and "PR" addresses only).
  "uspsData": {},
  // A unique identifier generated for every request to the API.
  "responseId": "ID"
}

พร็อพเพอร์ตี้ verdict

พร็อพเพอร์ตี้ verdict จะสรุปผลลัพธ์ของการตรวจสอบที่อยู่ และควรเป็นพร็อพเพอร์ตี้แรกที่ประเมินเมื่อสร้างตรรกะการตรวจสอบที่อยู่ พร็อพเพอร์ตี้นี้สามารถแสดงผลฟิลด์ต่างๆ ได้ โดยขึ้นอยู่กับคุณภาพของที่อยู่เอาต์พุต ตัวอย่างเช่น ตัวอย่างต่อไปนี้แสดงพร็อพเพอร์ตี้ verdict ของที่อยู่ที่มีคุณภาพดี ซึ่งจะแสดงผลช่องต่อไปนี้สำหรับคำขอนี้โดยเฉพาะ

"verdict": {
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "possibleNextAction": "ACCEPT",
  "addressComplete": true,
  "hasUnconfirmedComponents": false,
  "hasInferredComponents": true,
  "hasReplacedComponents": false
}

ส่วนต่อไปนี้จะสรุปช่องทั้งหมดในพร็อพเพอร์ตี้ verdict

ดูคำตัดสินในคู่มืออ้างอิง

รายละเอียดของที่อยู่

ความละเอียดของที่อยู่หมายถึงระดับรายละเอียดที่ใช้ในการระบุความเฉพาะเจาะจงของที่อยู่หรือรหัสพิกัดภูมิศาสตร์ ความเฉพาะเจาะจงของที่อยู่ในคำตอบ validationGranularity เป็นสัญญาณสำคัญที่บ่งบอกว่าที่อยู่ดังกล่าวสามารถนำส่งได้หรือไม่

พร็อพเพอร์ตี้ verdict จะแสดงสัญญาณความละเอียดต่อไปนี้

  • inputGranularity - อธิบายระดับรายละเอียดที่บันทึกจากที่อยู่ที่ส่งไปยัง Address Validation ใน Maps JavaScript API ระดับรายละเอียดที่อยู่ในคำขอจะมีผลต่อระดับรายละเอียดที่อยู่ในการตอบกลับการตรวจสอบความถูกต้อง ตัวอย่างเช่น โดยทั่วไปแล้วที่อยู่ที่มี inputGranularity ต่ำกว่าระดับ PREMISE จะไม่ส่งผลให้เกิด validationGranularity ไปยังระดับ PREMISE
  • validationGranularity — ระดับความละเอียดที่ Address Validation ใน Maps JavaScript API สามารถตรวจสอบที่อยู่ได้อย่างสมบูรณ์ ในกรณีส่วนใหญ่ ระดับความละเอียด PREMISE หรือ SUB_PREMISE บ่งชี้ถึงที่อยู่ที่มีคุณภาพซึ่งมีแนวโน้มที่จะนำส่งได้
  • geocodeGranularity — อธิบายระดับรายละเอียดของรหัสพิกัดภูมิศาสตร์ที่เชื่อมโยงกับที่อยู่ ตัวอย่างเช่น บันทึกของ Google อาจระบุว่ามีหมายเลขห้องพัก แต่ไม่ได้ระบุตำแหน่งที่แน่นอนของห้องพักนั้นภายในอาคารอพาร์ตเมนต์ขนาดใหญ่ ในกรณีนี้ validationGranularity คือ SUB_PREMISE แต่ geocodeGranularity คือ PREMISE
ดูความละเอียดในคู่มืออ้างอิง

ความสมบูรณ์ของที่อยู่

คำตัดสินจะแสดงผลพร็อพเพอร์ตี้ addressComplete เป็นสัญญาณสำหรับที่อยู่คุณภาพสูง ซึ่งหมายความว่าไม่มีองค์ประกอบที่ขาดหายไป ยังไม่ได้รับการแก้ไข หรือไม่คาดคิด ดังนี้

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

เมื่อที่อยู่มีองค์ประกอบที่ขาดหายไป ยังไม่ได้รับการแก้ไข หรือไม่คาดคิด ระบบจะตั้งค่าช่องเป็น false

ดู addressComplete ในส่วนคำตัดสินและที่อยู่ในคู่มืออ้างอิง

คุณภาพของที่อยู่

ช่องที่เป็นไปได้จำนวนหนึ่งจะระบุปัญหาเกี่ยวกับองค์ประกอบของที่อยู่หรือการปรับเปลี่ยนองค์ประกอบเหล่านั้น เช่น องค์ประกอบของที่อยู่ที่อนุมานหรือขาดหายไป ตัวอย่างเช่น พร็อพเพอร์ตี้ verdict ต่อไปนี้ระบุที่อยู่ที่มีองค์ประกอบที่ไม่ได้รับการยืนยันและไม่มีช่อง addressComplete

"verdict": {
    "inputGranularity": "PREMISE",
    "validationGranularity": "OTHER",
    "geocodeGranularity": "OTHER",
    "hasUnconfirmedComponents": true,
    "hasInferredComponents": true
}
ดูคำตัดสินในคู่มืออ้างอิง

การดำเนินการถัดไปที่เป็นไปได้

ช่องคำตัดสิน possibleNextAction จะแสดงข้อมูลสรุปเชิงตีความของการตอบกลับจาก API ซึ่งมีไว้เพื่อช่วยกำหนดการดำเนินการที่อาจเกิดขึ้นในภายหลัง ช่องนี้ได้มาจากช่องอื่นๆ ในการตอบกลับจาก API และไม่ควรถือเป็นการรับประกันความถูกต้องหรือความสามารถในการนำส่งของที่อยู่

พร็อพเพอร์ตี้ address และ addressComponent

พร็อพเพอร์ตี้ address จะจัดรูปแบบที่อยู่ที่ประมวลผลแล้วซึ่งระบุไว้ในคำขอ พร้อมกับข้อมูลสรุประดับคอมโพเนนต์ของที่อยู่ ซึ่งรวมถึงส่วนที่สะกดผิดของที่อยู่ ส่วนที่ไม่ถูกต้องที่ถูกแทนที่ และส่วนที่ขาดหายไปซึ่งอนุมานได้

ดู Address ในคู่มืออ้างอิง

พร็อพเพอร์ตี้ addressComponent เป็นคอมโพเนนต์ย่อยของ address ซึ่งแสดงรายการองค์ประกอบหรือคอมโพเนนต์ของที่อยู่ที่ Address Validation ใน Maps JavaScript API ประมวลผลอย่างละเอียด API จะระบุช่องคอมโพเนนต์แต่ละช่องตามชื่อ ประเภท และระดับการยืนยัน

ดู addressComponent ในคู่มืออ้างอิง

พร็อพเพอร์ตี้ geocode

พร็อพเพอร์ตี้ geocode บ่งชี้ตำแหน่งที่เข้ารหัสพิกัดภูมิศาสตร์ซึ่งเชื่อมโยงกับที่อยู่ที่ป้อน พร็อพเพอร์ตี้นี้จะให้รายละเอียดเกี่ยวกับสถานที่ตั้ง เช่น รหัสสถานที่

ดู Geocode ในคู่มืออ้างอิง

พร็อพเพอร์ตี้ metadata

พร็อพเพอร์ตี้นี้อาจไม่ได้รับการป้อนข้อมูลสำหรับทุกที่อยู่ที่ประมวลผลโดย Address Validation ใน Maps JavaScript API แต่จะระบุว่าที่อยู่เป็นประเภทที่พักอาศัย ธุรกิจ หรือตู้ ปณ.

ดูความครอบคลุมของ Address Validation API และข้อมูลอ้างอิงสำหรับ Address metadata

พร็อพเพอร์ตี้ uspsData

พร็อพเพอร์ตี้นี้ให้ข้อมูลที่เป็นประโยชน์สำหรับที่อยู่ทางไปรษณีย์ในสหรัฐอเมริกา อย่างไรก็ตาม เราไม่รับประกันว่าระบบจะป้อนข้อมูลทั้งหมดสำหรับทุกที่อยู่ที่บริการตรวจสอบ ด้วยเหตุนี้ คุณจึงไม่ควรใช้พร็อพเพอร์ตี้นี้เป็นวิธีเดียวในการตรวจสอบที่อยู่ แต่ควรตรวจสอบ verdict และ address ด้วย

ดูจัดการที่อยู่ในสหรัฐอเมริกาและข้อมูลอ้างอิงสำหรับ USPSData