บริการรูปภาพสถานที่ซึ่งเป็นส่วนหนึ่งของ Places API เป็น API แบบอ่านอย่างเดียวที่ช่วยให้คุณสามารถเพิ่มเนื้อหารูปภาพคุณภาพสูงลงในแอปพลิเคชันของคุณได้ บริการรูปภาพสถานที่ช่วยให้คุณเข้าถึงภาพถ่าย นับล้านที่เก็บไว้ในฐานข้อมูลสถานที่ เมื่อคุณรับข้อมูลสถานที่โดยใช้คําขอรายละเอียดสถานที่ ข้อมูลอ้างอิงรูปภาพจะถูกส่งคืนสําหรับเนื้อหาภาพถ่ายที่เกี่ยวข้อง คําขอสถานที่ การค้นหาสถานที่ใกล้เคียง และการค้นหาข้อความจะแสดงการอ้างอิงรูปภาพเดียวต่อ 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.
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
มากที่สุดในอาร์เรย์ - คําขอรายละเอียดสถานที่จะแสดงองค์ประกอบ
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