ภาพรวม Address Validation API

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

เหตุผลที่ควรใช้ Address Validation API

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

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

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

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

1. ลูกค้าป้อนที่อยู่ – รูปภาพต่อไปนี้แสดงแบบฟอร์มพื้นฐานที่อนุญาตให้ลูกค้าป้อนที่อยู่ ซึ่งอาจเป็นส่วนหนึ่งของขั้นตอนการชําระเงิน
   

2. แอปส่งที่อยู่ไปยัง API – แอปพลิเคชันส่งที่อยู่นี้เป็นอินพุตไปยัง Address Validation API

3. API จะตรวจสอบและทำให้ที่อยู่เป็นมาตรฐาน - ในการตอบกลับ Address Validation API จะแสดงผลที่อยู่แบบสมบูรณ์ตามที่ API กำหนด หรือระบุตำแหน่งที่ขาดข้อมูล

4. ลูกค้าแก้ไขหรือยืนยันที่อยู่ตามที่แนะนำ - คุณแสดงข้อความแจ้งต่อไปนี้แก่ลูกค้าได้ โดยขึ้นอยู่กับสิ่งที่ API แสดง

   • แสดงที่อยู่ซึ่งแนะนำให้ลูกค้ายืนยัน
     

   • แจ้งให้ลูกค้าเพิ่มข้อมูลที่ขาดหายไป
     

   • แจ้งให้ผู้ใช้แก้ไขที่อยู่หาก API ตรวจสอบที่อยู่ป้อนเข้ามาไม่ได้เนื่องจากไม่มีข้อมูลหรือไม่ถูกต้อง
     

วิธีการทำงานของ Address Validation API

การตรวจสอบที่อยู่จะยอมรับคําขอ POST ที่มีที่อยู่ในรูปแบบของเนื้อความ JSON โดยระบบจะแยกที่อยู่ออกเป็นองค์ประกอบต่างๆ แล้วทำการตรวจสอบและการแก้ไขต่อไปนี้

• ถูกต้อง - ให้การตรวจสอบความถูกต้องระดับคอมโพเนนต์ รวมถึงพร็อพเพอร์ตี้ย่อย (หากมี)
• สมบูรณ์ - พยายามอนุมานองค์ประกอบที่อยู่ซึ่งขาดหายไปหรือไม่ถูกต้อง
• มีการจัดรูปแบบที่ดี - ล้างข้อมูลและกำหนดรูปแบบให้เป็นมาตรฐานสำหรับองค์ประกอบที่อยู่

ลองใช้เดโมเพื่อดูการทำงานของ Address Validation API

แหล่งข้อมูล

ตารางต่อไปนี้สรุปทรัพยากรที่มีผ่าน Address Validation API พร้อมกับข้อมูลที่แสดง โปรดดูรายละเอียดที่หัวข้อข้อมูลอ้างอิง Address Validation API

แหล่งข้อมูล	ข้อมูลที่แสดงผล
ระบุคอมโพเนนต์ในรูปแบบ JSON โปรดดูตรวจสอบความถูกต้องของที่อยู่	ที่อยู่ที่ได้รับการตรวจสอบและสมบูรณ์ (หากเป็นไปได้) สถานะการตรวจสอบขององค์ประกอบที่อยู่แต่ละรายการ ในกรณีที่มีให้บริการสำหรับที่อยู่ รหัสพิกัดภูมิศาสตร์ ความแม่นยำของที่อยู่ ข้อมูลบริการไปรษณีย์ (หากมี) โปรดดูหัวข้อทำความเข้าใจการตอบกลับการตรวจสอบ

วิธีใช้ Address Validation API

1	ลองใช้เดโม	ดูตัวอย่างที่มีรูปแบบที่อยู่ต่างๆ ทั้งรูปแบบที่ถูกต้องและไม่ถูกต้อง การแสดงตัวอย่างเป็นวิธีที่มีประโยชน์ในการสำรวจทั้งค่าที่แสดงผลจากบริการ รวมถึงการตอบกลับ API ในรูปแบบ JSON
2	ตรวจสอบความครอบคลุม	ตรวจสอบรายละเอียดการครอบคลุมเพื่อดูประเทศและภูมิภาคที่ Address Validation API รองรับ
3	ตั้งค่า	เริ่มต้นด้วยตั้งค่าโปรเจ็กต์ Google Cloud แล้วทําตามวิธีการที่ระบุไว้
4	ขอการยืนยันที่อยู่	เริ่มต้นด้วยที่อยู่พื้นฐาน จากนั้นคุณสามารถเปิดใช้ CASS (สำหรับที่อยู่ของสหรัฐอเมริกาและเปอร์โตริโกเท่านั้น) เพื่อให้แม่นยำยิ่งขึ้น โปรดดูขอการยืนยันที่อยู่
5	ประมวลผลการตอบกลับ	การตอบกลับของ Address Validation API มีพร็อพเพอร์ตี้ 2 รายการ ซึ่งคุณใช้แต่ละรายการในลักษณะที่แตกต่างกัน โปรดดูทําความเข้าใจคําตอบพื้นฐาน
6	ปรับปรุงความแม่นยำของการตรวจสอบ	คุณช่วยเพิ่มความแม่นยำของที่อยู่ได้โดยแสดงความคิดเห็นเกี่ยวกับคำตอบของ Address Validation API ดูจัดการที่อยู่ที่ได้รับการอัปเดต

ไลบรารีของไคลเอ็นต์ที่ใช้ได้

ดูรายการไลบรารีของไคลเอ็นต์ที่ใช้ได้สำหรับ Address Validation API ได้ในส่วนไลบรารีของไคลเอ็นต์

เกี่ยวกับ CASS™

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

ระบบจะไม่เปิดใช้ CASS โดยค่าเริ่มต้นและรองรับเฉพาะภูมิภาค "สหรัฐอเมริกา" และ "เปอร์โตริโก" เท่านั้น หากต้องการเปิดใช้ CASS ให้ตั้งค่า enableUspsCass เป็น true เป็นส่วนหนึ่งของคำขอการตรวจสอบ ดูข้อมูลเพิ่มเติมได้ที่ตรวจสอบที่อยู่

USPS จะประเมินคำขอที่อยู่ซึ่งสร้างขึ้นโดยอัตโนมัติตามข้อกำหนดในการใช้บริการของ USPS หาก USPS ระบุว่าที่อยู่สำหรับป้อนข้อมูลสร้างขึ้นโดยมนุษย์ Google จะต้องหยุดตรวจสอบที่อยู่สำหรับลูกค้าและต้องรายงานข้อมูลติดต่อของลูกค้า (ชื่อและที่อยู่) ที่อยู่สำหรับป้อนข้อมูลที่เกี่ยวข้อง และข้อมูลการใช้งานที่รวบรวมไว้ให้ USPS การใช้ API หมายความว่าคุณให้ความยินยอมข้อกำหนดเฉพาะบริการเหล่านี้

ขั้นตอนถัดไป

• อ่านคำถามที่พบบ่อย: ไปที่คำถามที่พบบ่อย
• ตรวจสอบพื้นที่ให้บริการ: ไปที่รายละเอียดการครอบคลุมประเทศและภูมิภาค
• ประมวลผลที่อยู่จำนวนมาก: ไปที่ใช้ Address Validation API เพื่อประมวลผลที่อยู่จำนวนมาก

---

1. Google Maps Platform เป็นผู้ได้รับอนุญาตแบบไม่ผูกขาดจาก United States Postal Service® เครื่องหมายการค้าต่อไปนี้เป็นของ United States Postal Service® และใช้โดยได้รับอนุญาต ได้แก่ United States Postal Service®, CASS™, CASS Certified™ ↩