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

การตอบกลับของ 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

ดู 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
ดู Granularity ในคู่มืออ้างอิง

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

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

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

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

ดู addressComplete ในส่วน Verdict และ Address ในคู่มืออ้างอิง

คุณภาพของแอดเดรส

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

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

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

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

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

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

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

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

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

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

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

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

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

metadata

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

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

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

uspsData

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

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