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

ส่งคำขอตรวจสอบที่อยู่โดยการส่งคำขอ 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"]
  },
}

ลองใช้งาน

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

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

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

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

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

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

ตัวเลือก USPS CASSTM

The United States Postal Service® (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 หรือหากต้องการตรวจสอบที่อยู่นอกสหรัฐอเมริกาและภาคประชาสัมพันธ์

ลองใช้เลย

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

1. (ไม่บังคับ) ขยายแสดงพารามิเตอร์มาตรฐาน และตั้งค่าพารามิเตอร์ fields เป็นฟิลด์มาสก์

2. (ไม่บังคับ) แก้ไขเนื้อหาคำขอ

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

4. ในแผง API Explorer ให้เลือกไอคอนขยาย เพื่อขยายหน้าต่าง API Explorer

---

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