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

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

ลองใช้งาน

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

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

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

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

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

ตัวเลือก USPS CASSTM

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

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

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

ลองใช้งาน

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

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

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

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

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

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