ย้ายไปที่รายละเอียดสถานที่ (ใหม่)

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 ของคำตอบ