บริการรูปภาพรูปภาพซึ่งเป็นส่วนหนึ่งของ Places API เป็น API แบบอ่านอย่างเดียวที่ให้คุณเพิ่มเนื้อหารูปภาพคุณภาพสูงลงในแอปพลิเคชันได้ บริการรูปภาพสถานที่ช่วยให้คุณเข้าถึงรูปภาพหลายล้านภาพที่จัดเก็บไว้ในฐานข้อมูลสถานที่ เมื่อคุณได้รับข้อมูลสถานที่โดยใช้คําขอรายละเอียดสถานที่ ระบบจะส่งข้อมูลอ้างอิงรูปภาพสําหรับเนื้อหาภาพถ่ายที่เกี่ยวข้อง คําขอสถานที่ การค้นหาใกล้เคียง และการค้นหาข้อความจะแสดงการอ้างอิงรูปภาพเดียวต่อสถานที่ด้วย หากเกี่ยวข้อง เมื่อใช้บริการ Photos คุณจะสามารถเข้าถึงรูปภาพที่อ้างอิงและปรับขนาดรูปภาพให้เหมาะสมกับขนาดของแอปพลิเคชัน
คําขอรูปภาพสถานที่
คําขอรูปภาพสถานที่คือ 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.
Optional parameters
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. Both the
maxheight
andmaxwidth
properties accept an integer between1
and1600
.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
.
Generated from the OpenAPI specification. Edit Report bug
การอ้างอิงรูปภาพ
คําขอทั้งหมดที่ส่งไปยังบริการรูปภาพสถานที่ต้องมี photoreference
ที่แสดงผลในการตอบกลับคําขอค้นหาสถานที่ การค้นหาสถานที่ใกล้ๆ การค้นหาข้อความ หรือรายละเอียดสถานที่ การตอบกลับคําขอเหล่านี้จะมีช่อง photos[]
หากสถานที่มีเนื้อหาถ่ายภาพที่เกี่ยวข้อง
หมายเหตุ: จํานวนรูปภาพที่แสดงจะแตกต่างกันไปตามคําขอ
- คําขอ "สถานที่" "การค้นหาใกล้เคียง" หรือ "การค้นหาข้อความ" จะแสดงผลองค์ประกอบ
photo
มากที่สุด 1 รายการในอาร์เรย์ - คําขอรายละเอียดสถานที่จะแสดงผลองค์ประกอบ
photo
มากถึง 10 รายการ
เอลิเมนต์ photo
แต่ละรายการจะมีช่องต่อไปนี้
photo_reference
- สตริงที่ใช้ในการระบุรูปภาพเมื่อคุณส่งคําขอรูปภาพheight
— ความสูงของรูปภาพสูงสุดwidth
— ความกว้างของรูปภาพสูงสุดhtml_attributions[]
— ที่มีการระบุแหล่งที่มาที่จําเป็น ช่องนี้จะปรากฏเสมอ แต่อาจว่างเปล่า
รูปภาพที่มาจากบริการรูปภาพมีแหล่งที่มาจากหลายแหล่ง รวมถึงเจ้าของธุรกิจและรูปภาพที่ผู้ใช้ให้ไว้ ในกรณีส่วนใหญ่ คุณใช้รูปภาพเหล่านี้ได้โดยไม่ต้องระบุแหล่งที่มาหรือใส่การระบุแหล่งที่มาที่จําเป็นลงในรูปภาพ อย่างไรก็ตาม หากองค์ประกอบ photo
ที่แสดงผลมีค่าในช่อง html_attributions
คุณต้องใส่การระบุแหล่งที่มาเพิ่มเติมในแอปพลิเคชันได้ทุกที่ที่แสดงรูปภาพ
ตัวอย่างอาร์เรย์ photos[]
จะแสดงอยู่ด้านล่าง
...
"photos" : [
{
"html_attributions" : [],
"height" : 853,
"width" : 1280,
"photo_reference" : "CnRvAAAAwMpdHeWlXl-lH0vp7lez4znKPIWSWvgvZFISdKx45AwJVP1Qp37YOrH7sqHMJ8C-vBDC546decipPHchJhHZL94RcTUfPa1jWzo-rSHaTlbNtjh-N68RkcToUCuY9v2HNpo5mziqkir37WU8FJEqVBIQ4k938TI3e7bf8xq-uwDZcxoUbO_ZJzPxremiQurAYzCTwRhE_V0"
}
...
ตัวอย่างรูปภาพสถานที่
ตัวอย่างคําขอแสดงอยู่ด้านล่าง คําขอนี้จะแสดงผลรูปภาพที่อ้างอิงโดยปรับขนาดให้กว้างไม่เกิน 400 พิกเซล
https://maps.googleapis.com/maps/api/place/photo ?maxwidth=400 &photo_reference=Aap_uEA7vb0DDYVJWEaX3O-AtYp77AaswQKSGtDaimt3gt7QCNpdjp1BkdM6acJ96xTec3tsV_ZJNL_JP-lqsVxydG3nh739RE_hepOOL05tfJh2_ranjMadb3VoBYFvF0ma6S24qZ6QJUuV6sSRrhCskSBP5C1myCzsebztMfGvm7ij3gZT &key=YOUR_API_KEY
การตอบกลับรูปภาพสถานที่
การตอบกลับคําขอรูปภาพสถานที่ที่สําเร็จจะเป็นรูปภาพ ประเภทของ รูปภาพจะขึ้นอยู่กับประเภทรูปภาพที่ส่งในตอนแรก
หากคําขอเกินโควต้าที่พร้อมใช้งาน เซิร์ฟเวอร์จะส่งคืนสถานะ HTTP 403 และรูปภาพด้านล่างเพื่อระบุว่าโควต้าเกินโควต้าแล้ว
หากเซิร์ฟเวอร์ไม่เข้าใจคําขอ เซิร์ฟเวอร์จะส่งคืนสถานะ HTTP 400 ซึ่งระบุคําขอที่ไม่ถูกต้อง สาเหตุที่พบบ่อยที่สุดของคําขอที่ไม่ถูกต้องมีดังนี้
- ไม่ได้ระบุการอ้างอิงรูปภาพที่ส่งอย่างถูกต้อง
- คําขอไม่มีพารามิเตอร์
maxwidth
หรือmaxheight
- ตั้งค่าพารามิเตอร์
maxwidth
หรือmaxheight
เป็นnull