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

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 พิกเซล

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

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