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

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

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

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

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

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

รูปภาพสถานที่ที่มีอยู่รองรับรูปภาพ ขนาดไม่เกิน 1600 x 1600 พิกเซล รูปภาพสถานที่ (ใหม่) รองรับขนาดได้ถึง 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[] — การระบุแหล่งที่มาที่ต้องระบุ ช่องนี้จะมีอยู่ตลอดเวลา แต่อาจว่างเปล่า