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

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

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

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

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

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

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