ข้อมูลอ้างอิงแบบย่อของ Address Validation API

Address Validation API จะยอมรับที่อยู่ ระบุองค์ประกอบและตรวจสอบความถูกต้องของที่อยู่ กำหนดมาตรฐานที่อยู่สำหรับการส่งจดหมาย และแสดงผลพิกัดละติจูด/ลองจิจูดที่รู้จักดีที่สุดสำหรับที่อยู่ดังกล่าว สำหรับที่อยู่ในสหรัฐอเมริกาและเปอร์โตริโก คุณสามารถเลือกเปิดใช้การประมวลผล USPS CASS ได้

Address Validation API: ข้อมูลสำคัญ

  • ผลิตภัณฑ์: Address Validation API
  • หมวดหมู่: สถานที่
  • แพลตฟอร์ม: บริการผ่านเว็บ (REST)
  • ทำงานใน: เซิร์ฟเวอร์ (โค้ดแบ็กเอนด์)
  • ระยะการเปิดตัว: GA
  • วงจร: ใช้งานอยู่
  • ภาพรวม: ภาพรวมของ Address Validation API
  • ภูมิภาคที่พร้อมให้บริการ: จำกัด ประเทศที่รองรับและคุณภาพของข้อมูลจะแตกต่างกันไปในแต่ละประเทศ และบางประเทศอยู่ในเวอร์ชันตัวอย่าง ระบบจะแสดงข้อมูลเมตาของที่พักอาศัยและอาคารพาณิชย์เฉพาะประเทศที่แจ้งไว้ในหน้าความครอบคลุมเท่านั้น ระบบ CASS ของ USPS รองรับเฉพาะในสหรัฐอเมริกาและเปอร์โตริโกเท่านั้น (รายละเอียดความครอบคลุม)

Address Validation API: กรณีที่ควรใช้

ใช้ Address Validation API ในกรณีต่อไปนี้

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

อย่าใช้ Address Validation API ในกรณีต่อไปนี้

  • คุณเพียงแค่ต้องแปลงที่อยู่เป็นละติจูด/ลองจิจูด และไม่จำเป็นต้องตรวจสอบองค์ประกอบที่อยู่แต่ละรายการ โปรดใช้ Geocoding API แทน
  • คุณต้องการรายละเอียดจุดหมายปลายทางที่เจาะจงมาก เช่น ทางเข้าอาคาร โครงร่างอาคาร หรือจุดนำทาง โปรดใช้ Geocoding API แทน

Address Validation API: การตั้งค่า

แพ็กเกจ Address Validation API อย่างเป็นทางการ

  • npm: @googlemaps/addressvalidation
  • pypi: google-maps-addressvalidation
  • ไปที่: cloud.google.com/go/maps

Address Validation API: ข้อผิดพลาดที่พบบ่อย

  • ปัญหา: พร็อพเพอร์ตี้ addressComplete จะถูกละเว้นจากคำตัดสินเมื่อมีค่าเป็น false ดังนั้นโค้ดที่คาดว่าจะมีช่องดังกล่าวอาจอ่านที่อยู่ที่ไม่สมบูรณ์ผิดพลาด วิธีแก้ไข: ถือว่าพร็อพเพอร์ตี้ addressComplete ที่ขาดหายไปเป็น false หรือตรวจสอบว่ามีพร็อพเพอร์ตี้หรือไม่ ดู /maps/documentation/address-validation/understand-response
  • ปัญหา: หากละเว้น regionCode ไว้ API จะอนุมานภูมิภาคจากที่อยู่ ซึ่งอาจให้ผลลัพธ์ที่แม่นยำน้อยกว่า วิธีแก้ไข: ระบุ regionCode ใน PostalAddress เมื่อทราบข้อมูล ดู /maps/documentation/address-validation/requests-validate-address
  • ปัญหา: ระบบไม่รับประกันว่าออบเจ็กต์ uspsData จะได้รับการป้อนข้อมูลอย่างครบถ้วนสำหรับที่อยู่ในสหรัฐอเมริกาที่ได้รับการตรวจสอบแล้วทุกรายการ วิธีแก้ไข: อย่าใช้ uspsData เป็นสัญญาณการตรวจสอบความถูกต้องเพียงอย่างเดียว แต่ให้ใช้คำตัดสินและคอมโพเนนต์ที่อยู่ด้วย ดู /maps/documentation/address-validation/handle-us-address
  • ปัญหา: ความคิดเห็นที่ส่งด้วย provideValidationFeedback ต้องอ้างอิง responseId จากการเรียก validateAddress ครั้งแรกในลำดับ ไม่ใช่ครั้งถัดมา วิธีแก้ไข: จัดเก็บ responseId จากการตอบกลับ validateAddress ครั้งแรก แล้วส่งในคำขอความคิดเห็น ดู /maps/documentation/address-validation/handle-updated-address

สิ่งที่คุณทำได้ด้วย Address Validation API

ดูคำแนะนำที่ลิงก์ไว้ด้านล่างสำหรับแต่ละงาน หรือเปรียบเทียบผลิตภัณฑ์ต่างๆ ในเครื่องมือสำรวจความสามารถ