ย้ายข้อมูลไปยังรูปภาพสถานที่ (ใหม่)

Places API รองรับรูปภาพสถานที่ (เดิม) หากคุณคุ้นเคยกับรูปภาพสถานที่ (เดิม) รูปภาพสถานที่ (ใหม่) จะมีการเปลี่ยนแปลงต่อไปนี้

  • รูปภาพสถานที่ (ใหม่) กำหนดให้คุณส่งชื่อทรัพยากรของรูปภาพซึ่งมีรหัสสถานที่ใน URL คำขอ แทนที่จะส่งเฉพาะการอ้างอิงรูปภาพ ดูข้อมูลเพิ่มเติมได้ที่การเปลี่ยนแปลงข้อมูลอ้างอิงรูปภาพ
  • Place Photo (ใหม่) รองรับทั้งคีย์ API และโทเค็น OAuth เป็นกลไกการตรวจสอบสิทธิ์

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

พารามิเตอร์ปัจจุบัน พารามิเตอร์ใหม่ หมายเหตุ
maxheight maxHeightPx คุณต้องระบุ maxHeightPx หรือ maxWidthPx หรือทั้ง 2 อย่าง
maxwidth maxWidthPx คุณต้องระบุ maxHeightPx หรือ maxWidthPx หรือทั้ง 2 อย่าง

เพิ่มขนาดรูปภาพ

รูปภาพสถานที่ (เดิม) รองรับรูปภาพขนาดสูงสุด 1,600 x 1,600 พิกเซล รูปภาพสถานที่ (ใหม่)รองรับขนาดสูงสุด 4800 x 4800 พิกเซล

การเปลี่ยนแปลงรูปภาพอ้างอิง

วางรูปภาพ (ใหม่) API กำหนดให้คุณส่งชื่อทรัพยากรของรูปภาพที่ขอ ซึ่งรวมถึงรหัสสถานที่และข้อมูลอ้างอิงรูปภาพในรูปแบบต่อไปนี้

https://places.googleapis.com/v1/places/PLACE_ID/photos/PHOTO_REFERENCE/media?maxWidthPx=400&key=API_KEY

การค้นหาในพื้นที่ใกล้เคียง (ใหม่) การค้นหาข้อความ (ใหม่) และรายละเอียดสถานที่ (ใหม่) ทั้งหมดจะแสดงผลอาร์เรย์ photos[] ในการตอบกลับที่รองรับรูปแบบนี้ องค์ประกอบ photos[] แต่ละรายการในการตอบกลับใหม่จะมีช่องต่อไปนี้

  • name — สตริงที่มีชื่อทรัพยากรของรูปภาพ สตริงนี้อยู่ในรูปแบบ

    places/PLACE_ID/photos/PHOTO_REFERENCE
  • heightPx — ความสูงสูงสุดของรูปภาพเป็นพิกเซล
  • widthPx — ความกว้างสูงสุดของรูปภาพเป็นพิกเซล
  • authorAttributions[] — การระบุแหล่งที่มาที่จำเป็น ช่องนี้จะแสดงอยู่เสมอ แต่อาจว่างเปล่า

เมื่อใช้ API ที่มีอยู่ คุณจะต้องส่งข้อมูลอ้างอิงรูปภาพในรูปแบบต่อไปนี้เท่านั้น 

https://maps.googleapis.com/maps/api/place/photo?photo_reference=PHOTO_REFERENCEmaxwidth=400&key=API_KEY

ค้นหาสถานที่ (เดิม) การค้นหาในพื้นที่ใกล้เคียง (เดิม) การค้นหาข้อความ (เดิม) และรายละเอียดสถานที่ (เดิม) ทั้งหมดจะแสดงผลอาร์เรย์ photos[] ในการตอบกลับที่รองรับรูปแบบนี้ องค์ประกอบ photo แต่ละรายการในการตอบกลับแบบเดิมจะมีช่องต่อไปนี้

  • photo_reference — สตริงที่ใช้ระบุรูปภาพเมื่อคุณส่งคำขอรูปภาพ
  • height — ความสูงสูงสุดของรูปภาพ
  • width — ความกว้างสูงสุดของรูปภาพ
  • html_attributions[] — การระบุแหล่งที่มาที่จำเป็น ช่องนี้จะแสดงอยู่เสมอ แต่อาจว่างเปล่า