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: การตั้งค่า
- บริการที่ต้องเปิดใช้:
addressvalidation.googleapis.com - การตรวจสอบสิทธิ์: คีย์ API, OAuth 2.0, บัญชีบริการ
- เริ่มต้นใช้งาน: ตั้งค่า Address Validation API
- ข้อมูลอ้างอิง: เอกสารอ้างอิง Address Validation API
- ราคา: การใช้งานและการเรียกเก็บเงินของ Address Validation API
- นโยบาย: นโยบาย Address Validation 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
ดูคำแนะนำที่ลิงก์ไว้ด้านล่างสำหรับแต่ละงาน หรือเปรียบเทียบผลิตภัณฑ์ต่างๆ ในเครื่องมือสำรวจความสามารถ
- แสดงผลที่อยู่ที่ตรวจสอบแล้วสำหรับที่อยู่หรือที่อยู่บางส่วนที่ระบุ
- แสดงพิกัดละติจูด/ลองจิจูดสำหรับที่อยู่ที่ตรวจสอบแล้ว
- แสดงผลตัวระบุสถานที่ของ Google สำหรับที่อยู่ที่ตรวจสอบแล้ว
- ใช้การรับรอง Coding Accuracy Support System (CASS) ของ United States Postal Service (USPS) เพื่อตรวจสอบความถูกต้องของที่อยู่
- แสดงข้อมูลว่าที่อยู่ที่ตรวจสอบแล้วเป็นธุรกิจ ที่พักอาศัย หรือตู้ ปณ.
- แสดงข้อมูลเมตาการนำส่งของไปรษณีย์สหรัฐอเมริกา (USPS) สำหรับที่อยู่ที่ตรวจสอบแล้ว
- แสดงผลที่อยู่ที่ตรวจสอบแล้วเป็นเวอร์ชันภาษาอังกฤษ ตัวอย่าง
- แสดงผล Plus Code สำหรับที่อยู่ที่ตรวจสอบแล้ว