ภาพรวม 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

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

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 พร้อมกับข้อมูลที่ส่งคืน โปรดดูรายละเอียดที่ข้อมูลอ้างอิงของ 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 เพื่อประมวลผลที่อยู่จำนวนมาก