ภาพรวม Address Validation API

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

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

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

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

สิ่งที่คุณทำได้ด้วย 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 พร้อมกับข้อมูลที่แสดงผล โปรดดูรายละเอียดที่เฉพาะเจาะจงที่หัวข้อข้อมูลอ้างอิงสำหรับ 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 ได้ที่ไลบรารีของไคลเอ็นต์

เกี่ยวกับ CASSTM

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

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

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

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

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