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

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

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

ตัวเลือก USPS CASSTM

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

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

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

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

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

ลองใช้งาน

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

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

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

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

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

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

---

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