ส่งคําขอตรวจสอบที่อยู่

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

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

ส่งคำขอ Address Validation โดยส่งคำขอ POST ไปยังปลายทางใดปลายทางหนึ่งต่อไปนี้

• validateAddress (REST)
• ValidateAddress (gRPC)

หมายเหตุ: เอกสารประกอบนี้ใช้ REST สำหรับตัวอย่าง แต่วิธีการจะคล้ายกับ gRPC

คำขอของคุณควรส่งเนื้อหาคำขอ JSON ไปยังคำขอที่กำหนดที่อยู่ที่จะตรวจสอบด้วย เนื้อหาของคำขอต่อไปนี้มี 1 ช่องและ 3 ช่องย่อย

curl -X POST -d '{
  "address": {
    "regionCode": "US",
    "locality": "Mountain View",
    "addressLines": ["1600 Amphitheatre Pkwy"]
  }
}' \
-H 'Content-Type: application/json' \
"https://addressvalidation.googleapis.com/v1:validateAddress?key=API_KEY"

นอกจากนี้ คุณยังละเว้น locality และระบุเป็นองค์ประกอบในอาร์เรย์ addressLines ได้ด้วย ดังนี้

{
  "address": {
    "regionCode": "US",
    "addressLines": ["1600 Amphitheatre Pkwy", "Mountain View, CA, 94043"]
  },
}

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

ลองใช้งาน

ช่องคำขอที่อยู่

เนื้อหาของคำขอประกอบด้วยช่องเดียว ดังนี้

• address — ช่องประเภท PostalAddress ซึ่งต้องมีรายการอย่างน้อย 1 รายการใน addressLines

เมื่อส่งฟิลด์ address ไปยัง Address Validation API คุณจะต้องระบุเพียงฟิลด์เดียวเท่านั้น นั่นคือ addressLines อย่างไรก็ตาม คำขอที่อยู่แบบง่ายที่สุดควรมีช่องย่อยต่อไปนี้

• regionCode — แนะนำ ฟิลด์นี้เป็นฟิลด์ตัวเลือก แต่หากละเว้น Address Validation API จะอนุมานภูมิภาคจากที่อยู่ อย่างไรก็ตาม เพื่อผลลัพธ์ที่ดีที่สุด ให้ใส่ regionCode หากทราบ ดูรายชื่อภูมิภาคที่รองรับได้ที่ภูมิภาคที่รองรับ
• addressLines — ต้องระบุ อาร์เรย์ที่มีที่อยู่ซึ่งอธิบายโครงสร้างที่ต่ำกว่าของที่อยู่

ดู PostalAddress ในคู่มืออ้างอิง

ตัวเลือก USPS CASS™

United States Postal Service® (USPS®)¹ มี Coding Accuracy Support System (CASS™) เพื่อสนับสนุนและรับรองผู้ให้บริการ Address Validation

หมายเหตุ: Address Validation API ได้รับการยืนยันว่าเป็นบริการที่ผ่านการรับรอง CASS-Certified™ ซึ่งหมายความว่าบริการนี้ได้รับการยืนยันแล้วว่าสามารถกรอกข้อมูลที่อยู่ที่ขาดหายไป ปรับให้เป็นมาตรฐาน และอัปเดตเป็นที่อยู่ล่าสุดและถูกต้องที่สุด

สำหรับภูมิภาคสหรัฐอเมริกาและเปอร์โตริโกเท่านั้น คุณสามารถเปิดใช้การประมวลผล CASS ได้โดยตั้งค่า enableUspsCass เป็น true ในเนื้อหาคำขอ เพื่อให้ได้ผลลัพธ์ที่ดีที่สุดเมื่อใช้ CASS โปรดระบุที่อยู่ซึ่งมีชื่อถนนและหมายเลขถนน พร้อมด้วยเมือง รัฐ และรหัสไปรษณีย์ ดังนี้

{
  "address": {
    "regionCode": "US",
    "locality": "Mountain View",
    "administrativeArea": "CA",
    "postalCode": "94043",
    "addressLines": ["1600 Amphitheatre Pkwy"]
  },
  "enableUspsCass": true
}

หมายเหตุ: หากคุณไม่ต้องการการประมวลผล CASS หรือหากคุณกำลังตรวจสอบที่อยู่นอกภูมิภาคสหรัฐอเมริกาและเปอร์โตริโก Google ไม่แนะนำให้เปิดใช้ฟีเจอร์นี้

ลองใช้งาน

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

1. เลือกไอคอน API api ทางด้านขวาของหน้า

2. แก้ไขพารามิเตอร์คำขอ (ไม่บังคับ)

3. เลือกปุ่มดำเนินการ ในกล่องโต้ตอบ ให้เลือกบัญชีที่ต้องการใช้เพื่อส่งคำขอ

4. ในแผงโปรแกรมสำรวจ API ให้เลือกไอคอนเต็มหน้าจอ fullscreen เพื่อขยายหน้าต่างโปรแกรมสำรวจ API

---

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