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

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

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

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

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

เพิ่มขนาดรูปภาพแล้ว

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

เปลี่ยนเป็นข้อมูลอ้างอิงของรูปภาพ

สำหรับ Place Photo 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[] — การระบุแหล่งที่มาที่ต้องระบุ ช่องนี้จะมีอยู่เสมอ แต่อาจว่างเปล่า