บทนำ
Places API รองรับรูปภาพสถานที่ (เดิม) หากคุณคุ้นเคยกับรูปภาพสถานที่ (เดิม) รูปภาพสถานที่ (ใหม่) จะมีการเปลี่ยนแปลงต่อไปนี้
- Place Photos (ใหม่) กำหนดให้คุณส่งชื่อทรัพยากรของรูปภาพ ซึ่งรวมถึงรหัสสถานที่ใน URL คำขอ แทนที่จะส่งเฉพาะข้อมูลอ้างอิงรูปภาพ ดูข้อมูลเพิ่มเติมได้ที่การเปลี่ยนแปลงการอ้างอิงรูปภาพ
- Place Photos (ใหม่) รองรับทั้งคีย์ API และโทเค็น OAuth เป็นกลไกการตรวจสอบสิทธิ์
ตารางต่อไปนี้แสดงพารามิเตอร์ใน Place Photos (เดิม) ที่เปลี่ยนชื่อหรือแก้ไขสำหรับ Place Photos (ใหม่) หรือพารามิเตอร์ที่ไม่รองรับอีกต่อไป
| พารามิเตอร์ปัจจุบัน | พารามิเตอร์ใหม่ | หมายเหตุ |
|---|---|---|
maxheight |
maxHeightPx |
คุณต้องระบุ maxHeightPx, maxWidthPx หรือทั้ง 2 อย่าง |
maxwidth |
maxWidthPx |
คุณต้องระบุ maxHeightPx, maxWidthPx หรือทั้ง 2 อย่าง |
ขนาดรูปภาพที่เพิ่มขึ้น
Place Photos (เดิม) รองรับขนาดรูปภาพสูงสุด 1600 x 1600 พิกเซล รูปภาพของสถานที่ (ใหม่) รองรับขนาดสูงสุด 4,800 x 4,800 พิกเซล
เปลี่ยนเป็นรูปภาพอ้างอิง
Place Photos (ใหม่) 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[]— การระบุแหล่งที่มาที่จำเป็น ช่องนี้จะแสดงอยู่เสมอ แต่อาจว่างเปล่า