บริการ Place Photo ซึ่งเป็นส่วนหนึ่งของ Places API เป็น API แบบอ่านอย่างเดียวที่ช่วยให้คุณสามารถเพิ่มเนื้อหาภาพถ่ายคุณภาพสูงลงในแอปพลิเคชันของคุณ บริการ Place Photo ช่วยให้คุณเข้าถึงรูปภาพนับล้านที่เก็บอยู่ในฐานข้อมูล Places เมื่อคุณได้รับข้อมูลสถานที่โดยใช้คำขอรายละเอียดสถานที่ จะมีการอ้างอิงรูปภาพสำหรับเนื้อหาภาพถ่ายที่เกี่ยวข้องกลับมา คำขอ "ค้นหาสถานที่ การค้นหาใกล้เคียง และการค้นหาข้อความ" ยังแสดงการอ้างอิงรูปภาพ 1 รูปต่อสถานที่ด้วยหากข้อมูลมีความเกี่ยวข้อง เมื่อใช้บริการรูปภาพ คุณจะสามารถเข้าถึงรูปภาพที่อ้างอิงและปรับขนาดรูปภาพให้เป็นขนาดที่เหมาะสมที่สุดสำหรับแอปพลิเคชันของคุณ
คำขอรูปภาพสถานที่
คำขอรูปภาพสถานที่คือ HTTP URL ในรูปแบบต่อไปนี้
https://maps.googleapis.com/maps/api/place/photo?parameters
ต้องมีพารามิเตอร์บางรายการเพื่อเริ่มคำขอการค้นหา เช่นเดียวกับมาตรฐานใน URL พารามิเตอร์ทั้งหมดจะถูกคั่นด้วยอักขระเครื่องหมายแอมเพอร์แซนด์ (&
) ดูรายละเอียดของพารามิเตอร์และค่าที่เป็นไปได้ด้านล่าง
Required parameters
photo_reference
A string identifier that uniquely identifies a photo. Photo references are returned from either a Place Search or Place Details request.
maxheight or maxwidth
maxheight
specifies the maximum desired height, in pixels, of the image. If the image is smaller than the values specified, the original image will be returned. If the image is larger in either dimension, it will be scaled to match the smaller of the two dimensions, restricted to its original aspect ratio.maxwidth
specifies the maximum desired width, in pixels, of the image. If the image is smaller than the values specified, the original image will be returned. If the image is larger in either dimension, it will be scaled to match the smaller of the two dimensions, restricted to its original aspect ratio.Both the
maxheight
andmaxwidth
properties accept an integer between1
and1600
.You must specify either
maxheight
, ormaxwidth
, or both.
ข้อมูลอ้างอิงรูปภาพ
คำขอทั้งหมดที่ส่งไปยังบริการรูปภาพสถานที่ต้องมี photo_reference
ซึ่งส่งคืนในการตอบสนองต่อคำขอ "ค้นหาสถานที่" "การค้นหาใกล้เคียง" "การค้นหาข้อความ" หรือ "รายละเอียดสถานที่" การตอบกลับคำขอเหล่านี้จะมีช่อง photos[]
หากสถานที่นั้นมีเนื้อหาภาพถ่ายที่เกี่ยวข้อง
หมายเหตุ: จำนวนรูปภาพที่แสดงผลจะแตกต่างกันไปตามคำขอ
- คำขอ "ค้นหาสถานที่" "การค้นหาใกล้เคียง" หรือ "ค้นหาข้อความ" จะแสดงผลองค์ประกอบ
photo
ไม่เกิน 1 รายการในอาร์เรย์ - คำขอรายละเอียดสถานที่จะแสดงผลองค์ประกอบ
photo
สูงสุด 10 รายการ
องค์ประกอบ photo
แต่ละรายการจะมีช่องต่อไปนี้
photo_reference
— สตริงที่ใช้ระบุรูปภาพเมื่อคุณ ส่งคำขอรูปภาพheight
— ความสูงสูงสุดของรูปภาพwidth
— ความกว้างสูงสุดของรูปภาพhtml_attributions[]
— มีการระบุแหล่งที่มาที่ต้องระบุ ช่องนี้จะปรากฏเสมอ แต่อาจว่างเปล่า
รูปภาพที่ส่งโดยบริการรูปภาพจะมาจากสถานที่หลายแห่ง ซึ่งรวมถึงเจ้าของธุรกิจและรูปภาพที่ผู้ใช้ส่งมา ในกรณีส่วนใหญ่ รูปภาพเหล่านี้จะใช้ได้โดยไม่ต้องแสดงที่มา หรือจะมีการระบุแหล่งที่มาที่จำเป็นรวมอยู่ในรูปภาพด้วย อย่างไรก็ตาม หากองค์ประกอบ photo
ที่แสดงผลมีค่าในช่อง html_attributions
คุณต้องใส่การระบุแหล่งที่มาเพิ่มเติมในแอปพลิเคชันด้วยทุกที่ที่แสดงรูปภาพ
ตัวอย่างต่อไปนี้แสดงคำขอรายละเอียดสถานที่
curl "https://maps.googleapis.com/maps/api/place/details/json?placeid=ChIJcUElzOzMQQwRLuV30nMUEUM&key=YOUR_API_KEY"
ตัวอย่างอาร์เรย์ photos[]
ในการตอบกลับจะแสดงอยู่ด้านล่าง
...
"photos" : [
{
"html_attributions" : [],
"height" : 853,
"width" : 1280,
"photo_reference" : "ATJ83zhSSAtkh5LTozXMhBghqubeOxnZWUV2m7Hv2tQaIzKQJgvZk9yCaEjBW0r0Zx1oJ9RF1G7oeM34sQQMOv8s2zA0sgGBiyBgvdyMxeVByRgHUXmv-rkJ2wyvNv17jyTSySm_-_6R2B0v4eKX257HOxvXlx_TSwp2NrICKrZM2d5d2P4q"
}
...
ตัวอย่างรูปภาพสถานที่
ตัวอย่างคำขอแสดงอยู่ด้านล่าง คำขอนี้จะแสดงผลรูปภาพที่อ้างอิงและปรับขนาดให้กว้างที่สุด 400 พิกเซล
https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=ATJ83zhSSAtkh5LTozXMhBghqubeOxnZWUV2m7Hv2tQaIzKQJgvZk9yCaEjBW0r0Zx1oJ9RF1G7oeM34sQQMOv8s2zA0sgGBiyBgvdyMxeVByRgHUXmv-rkJ2wyvNv17jyTSySm_-_6R2B0v4eKX257HOxvXlx_TSwp2NrICKrZM2d5d2P4q &key=YOUR_API_KEY
ตอบกลับด้วยรูปภาพ
การตอบกลับคำขอรูปภาพสถานที่ที่สำเร็จจะเป็นรูปภาพ ประเภทรูปภาพจะขึ้นอยู่กับประเภทของรูปภาพที่ส่งในตอนแรก
หากคำขอของคุณเกินโควต้าที่มีอยู่ เซิร์ฟเวอร์จะแสดงสถานะ HTTP 403 และแสดงรูปภาพด้านล่างเพื่อระบุว่าเกินโควต้าแล้ว
หากเซิร์ฟเวอร์ไม่เข้าใจคำขอของคุณ เซิร์ฟเวอร์จะแสดงสถานะ HTTP 400 ซึ่งระบุคำขอที่ไม่ถูกต้อง สาเหตุที่พบบ่อยที่สุดของคำขอที่ไม่ถูกต้อง ได้แก่
- มีการระบุรูปภาพอ้างอิงที่ส่งมาไม่ถูกต้อง
- คำขอไม่มีพารามิเตอร์
maxwidth
หรือmaxheight
- ตั้งค่าพารามิเตอร์
maxwidth
หรือmaxheight
เป็นnull
photo_reference
หมดอายุแล้ว หากphoto_reference
หมดอายุ ให้ส่งคำขอไปยังรายละเอียดสถานที่ ค้นหาสถานที่ การค้นหาใกล้เคียง หรือค้นหาข้อความ เพื่อรับค่าphoto_reference
ที่อัปเดตแล้ว