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

แหล่งข้อมูล ข้อมูลที่แสดงผล

ระบุคอมโพเนนต์ในรูปแบบ 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®)1 ดูแลระบบสนับสนุนความถูกต้องในการเข้ารหัส (CASS™) เพื่อสนับสนุนและรับรองผู้ให้บริการตรวจสอบที่อยู่ บริการที่ได้รับการรับรอง CASS™ เช่น Address Validation API ได้รับการยืนยันความสามารถในการกรอกข้อมูลที่ขาดหายไปจากที่อยู่ ปรับให้เป็นมาตรฐาน และอัปเดตเพื่อให้คุณได้รับข้อมูลที่ถูกต้องและเป็นปัจจุบันที่สุด

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

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

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

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