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

Places API สนับสนุนรายละเอียดสถานที่ที่มีอยู่ หากคุณคุ้นเคยกับ Places API ที่มีอยู่แล้ว รายละเอียดสถานที่เวอร์ชันใหม่จะทำการเปลี่ยนแปลงต่อไปนี้

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

ตารางต่อไปนี้แสดงพารามิเตอร์ในรายละเอียดสถานที่ที่มีอยู่ซึ่งมีการเปลี่ยนชื่อหรือแก้ไขสำหรับรายละเอียดสถานที่ใหม่ หรือพารามิเตอร์ที่ไม่ได้รับการสนับสนุนอีกต่อไป

พารามิเตอร์ปัจจุบัน พารามิเตอร์ใหม่ Notes
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 ของการตอบกลับ