บทนำ
Places API รองรับ รายละเอียดสถานที่ (เดิม) หากคุณคุ้นเคยกับ Places API (เดิม) รายละเอียดสถานที่ (ใหม่) จะมีการเปลี่ยนแปลงดังนี้
- ต้องใช้ฟิลด์มาสก์ คุณต้องระบุฟิลด์ที่ต้องการให้แสดงผล ในการตอบกลับ ไม่มีรายการฟิลด์เริ่มต้นที่จะแสดงผล หากไม่ระบุ รายการนี้ เมธอดจะแสดงข้อผิดพลาด ดูข้อมูลเพิ่มเติมได้ที่ FieldMask.
- รายละเอียดสถานที่ (ใหม่) รองรับทั้ง คีย์ API และ OAuth เป็นกลไกการตรวจสอบสิทธิ์
- รายละเอียดสถานที่ (ใหม่) รองรับเฉพาะ JSON เป็นรูปแบบการตอบกลับ
- รูปแบบการตอบกลับ JSON สำหรับ Places API (ใหม่) เปลี่ยนไปจากรูปแบบของ API เดิม ดูรายละเอียดเพิ่มเติมได้ที่ ย้ายข้อมูลการตอบกลับของ Places API
ตารางต่อไปนี้แสดงรายการพารามิเตอร์ในรายละเอียดสถานที่ (เดิม) ที่มีการเปลี่ยนชื่อหรือแก้ไขสำหรับรายละเอียดสถานที่ (ใหม่) หรือพารามิเตอร์ที่ไม่รองรับอีกต่อไป
| พารามิเตอร์ปัจจุบัน | พารามิเตอร์ใหม่ | หมายเหตุ |
|---|---|---|
place_id |
places/PLACE_ID |
สตริง places/PLACE_ID เรียกอีกอย่างว่า
ชื่อทรัพยากรของสถานที่ ในการตอบกลับจากคำขอรายละเอียดสถานที่ (ใหม่), การค้นหาในบริเวณใกล้เคียง (ใหม่) และการค้นหาข้อความ (ใหม่) สตริงนี้จะอยู่ในฟิลด์ name ของการตอบกลับ
รหัสสถานที่แบบสแตนด์อโลนจะอยู่ในฟิลด์ id ของการตอบกลับ |
language |
languageCode |
|
region |
regionCode |
ตัวอย่างคำขอ
ตัวอย่างคำขอ GET ต่อไปนี้ใช้รายละเอียดสถานที่ (เดิม) ในตัวอย่างนี้ คุณขอการตอบกลับ JSON ที่มีข้อมูลเกี่ยวกับรหัสสถานที่และส่งพารามิเตอร์ทั้งหมดเป็นพารามิเตอร์ URL ตัวอย่างนี้ยังใช้ fields เพื่อให้การตอบกลับมีเฉพาะชื่อที่แสดงและที่อยู่ที่จัดรูปแบบแล้วของสถานที่
curl -L -X GET \ 'https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJj61dQgK6j4AR4GeTYWZsKWw&fields=name%2Cformatted_address&key=API_KEY'
เมื่อใช้รายละเอียดสถานที่ (ใหม่) คุณจะส่งคำขอ GET และส่งพารามิเตอร์ทั้งหมดในพารามิเตอร์ URL และส่วนหัวโดยเป็นส่วนหนึ่งของคำขอ ตัวอย่างนี้ยังใช้ฟิลด์มาสก์เพื่อให้การตอบกลับมีเฉพาะชื่อที่แสดงและที่อยู่ที่จัดรูปแบบแล้วของสถานที่
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: displayName,formattedAddress" \ https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw
สตริง places/PLACE_ID เรียกอีกอย่างว่าชื่อทรัพยากรของสถานที่
ในการตอบกลับจากคำขอรายละเอียดสถานที่ (ใหม่), การค้นหาในบริเวณใกล้เคียง (ใหม่) และการค้นหาข้อความ (ใหม่) สตริงนี้จะอยู่ในฟิลด์ name ของการตอบกลับ รหัสสถานที่แบบสแตนด์อโลนจะอยู่ในฟิลด์ id ของการตอบกลับ