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