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