Places API รองรับรายละเอียดสถานที่ที่มีอยู่ หากคุณคุ้นเคยกับ Places API ที่มีอยู่ รายละเอียดสถานที่เวอร์ชันใหม่จะมีการเปลี่ยนแปลงต่อไปนี้
- ต้องทำการมาสก์ฟิลด์ คุณต้องระบุช่องที่ต้องการให้แสดงในการตอบกลับ ไม่มีรายการเริ่มต้นของฟิลด์ที่แสดงผล หากคุณละเว้นรายการนี้ เมธอดจะแสดงข้อผิดพลาด ดูข้อมูลเพิ่มเติมได้ที่FieldMask
- รายละเอียดสถานที่แบบใหม่รองรับทั้งคีย์ API และโทเค็น OAuth เป็นกลไกการตรวจสอบสิทธิ์
- เฉพาะ JSON เท่านั้นที่รองรับรูปแบบการตอบกลับในรายละเอียดสถานที่แบบใหม่
- รูปแบบการตอบกลับ JSON สำหรับ 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 ของคำตอบ