ภาพรวม Address Validation API

นักพัฒนาซอฟต์แวร์ในเขตเศรษฐกิจยุโรป (EEA)

หากที่อยู่สำหรับการเรียกเก็บเงินของคุณอยู่ในเขตเศรษฐกิจยุโรป ตั้งแต่วันที่ 8 กรกฎาคม 2025 เป็นต้นไป ข้อกำหนดในการให้บริการของ Google Maps Platform ใน EEA จะมีผลบังคับใช้กับการใช้บริการของคุณ ฟังก์ชันการทำงานจะแตกต่างกันไปตามภูมิภาค ดูข้อมูลเพิ่มเติม

บทนำ

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

เหตุใดจึงต้องใช้ Address Validation API

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

ข้อควรพิจารณาอื่นๆ

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

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

Geocoding API v4 เปิดตัวเมธอด SearchDestinations ซึ่งแสดงผลพิกัดสำหรับทางเข้าอาคาร จุดนำทาง และโครงร่างอาคาร ดูรายละเอียดเพิ่มเติมได้ที่ส่วนค้นหา จุดหมาย ของ Geocoding API v4

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

ลองใช้เวอร์ชันเดโม

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

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

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

   

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

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

   

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

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

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

แหล่งข้อมูล

ตารางต่อไปนี้สรุปทรัพยากรที่พร้อมใช้งานผ่าน Address Validation API พร้อมกับข้อมูลที่ 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™

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

CASS ไม่ได้เปิดใช้โดยค่าเริ่มต้นและรองรับเฉพาะภูมิภาค "US" และ "PR" หากต้องการเปิดใช้ 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™ ↩