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

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

• ตรวจสอบที่อยู่ (REST)
• ตรวจสอบที่อยู่ (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=YOUR_API_KEY"

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

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

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

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

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

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

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

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

ตัวเลือก USPS CASSTM

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

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

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

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

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

---

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