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