ส่งคำขอตรวจสอบที่อยู่โดยการส่งคำขอ 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
— แนะนำ ช่องนี้เป็นช่องที่ไม่บังคับ แต่หากไม่ระบุ ระบบก็จะอนุมานภูมิภาคจากที่อยู่ อย่างไรก็ตาม ให้ใส่regionCode
เพื่อผลลัพธ์ที่ดีที่สุด โปรดดูรายชื่อภูมิภาคที่รองรับในภูมิภาคที่รองรับaddressLines
— ต้องระบุ อาร์เรย์ที่มีที่อยู่ที่อธิบายโครงสร้างด้านล่างของที่อยู่
โปรดดู PostalAddress ในคู่มืออ้างอิง |
ตัวเลือก USPS CASSTM
The United States Postal Service® (USPS®)1 มีระบบสนับสนุนความถูกต้องของการเขียนโค้ด (CASSTM) เพื่อรองรับและรับรองผู้ให้บริการตรวจสอบที่อยู่
สำหรับภูมิภาคสหรัฐอเมริกาและการประชาสัมพันธ์เท่านั้น คุณจะเปิดใช้การประมวลผล CASS ได้โดยการตั้งค่า enableUspsCass
เป็น true
ในเนื้อหาคำขอ เพื่อผลลัพธ์ที่ดีที่สุดเมื่อใช้ CASS ให้ระบุที่อยู่ที่มีถนนและเลขที่ถนน พร้อมด้วยเมือง รัฐ และรหัสไปรษณีย์
{
"address": {
"regionCode": "US",
"locality": "Mountain View",
"administrativeArea": "CA",
"postalCode": "94043",
"addressLines": ["1600 Amphitheatre Pkwy"]
},
"enableUspsCass": true
}
ลองใช้เลย
โปรแกรมสำรวจ API ให้คุณสร้างคำขอตัวอย่างเพื่อทำความคุ้นเคยกับ API และตัวเลือก API
เลือกไอคอน API ทางด้านขวาของหน้า
(ไม่บังคับ) ขยายแสดงพารามิเตอร์มาตรฐาน และตั้งค่าพารามิเตอร์
fields
เป็นฟิลด์มาสก์(ไม่บังคับ) แก้ไขเนื้อหาคำขอ
เลือกปุ่มดำเนินการ ในกล่องโต้ตอบ ให้เลือกบัญชี ที่คุณต้องการใช้ส่งคำขอ
ในแผง API Explorer ให้เลือกไอคอนขยาย เพื่อขยายหน้าต่าง API Explorer
-
Google Maps Platform เป็นผู้รับอนุญาตแบบไม่เฉพาะตัวของสหรัฐอเมริกา Postal Service® เครื่องหมายการค้าต่อไปนี้เป็นของ United States Postal Service® และได้รับอนุญาตแล้ว: United States Postal Service®, CASSTM, CASS CertifiedTM ↩