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

ส่งคำขอการตรวจสอบที่อยู่โดยส่งคำขอ POST ไปยังปลายทางใดปลายทางหนึ่งต่อไปนี้

• validateAddress (REST)
• ValidateAddress (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 — ต้องระบุ อาร์เรย์ที่มีที่อยู่ที่อธิบายโครงสร้าง ระดับล่างของที่อยู่

ตัวเลือก USPS CASS™

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

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

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

ลองใช้งาน

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

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

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

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

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