ภาพรวม Address Validation API

ภาพรวมการตรวจสอบที่อยู่

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

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

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

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

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

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

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

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

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

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

    • แสดงที่อยู่ที่แนะนําให้ลูกค้ายืนยัน
      ขอให้ลูกค้ายืนยันที่อยู่ตามที่กำหนดโดย 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

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

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

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

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


  1. Google Maps Platform เป็นผู้รับอนุญาตแบบไม่เฉพาะตัวของไปรษณีย์สหรัฐอเมริกา Postal Service® เครื่องหมายการค้าต่อไปนี้เป็นของ สหรัฐอเมริกา Postal Service® และได้รับอนุญาตแล้ว: United States Postal Service®, CASSTM, CASS CertifiedTM.