บริการ 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
คุณต้องใส่การระบุแหล่งที่มาเพิ่มเติมในแอปพลิเคชันของคุณด้วยทุกที่ที่แสดงรูปภาพ
ตัวอย่างอาร์เรย์ photos[]
จะแสดงที่ด้านล่าง
...
"photos" : [
{
"html_attributions" : [],
"height" : 853,
"width" : 1280,
"photo_reference" : "AUacShh3_Dd8yvV2JZMtNjjbbSbFhSv-0VmUN-uasQ2Oj00XB63irPTks0-A_1rMNfdTunoOVZfVOExRRBNrupUf8TY4Kw5iQNQgf2rwcaM8hXNQg7KDyvMR5B-HzoCE1mwy2ba9yxvmtiJrdV-xBgO8c5iJL65BCd0slyI1"
}
...
ตัวอย่างรูปภาพสถานที่
ตัวอย่างคำขอแสดงอยู่ด้านล่าง คำขอนี้จะแสดงรูปภาพที่นำมาอ้างอิงและปรับขนาดให้กว้างไม่เกิน 400 พิกเซล
https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=AUacShh3_Dd8yvV2JZMtNjjbbSbFhSv-0VmUN-uasQ2Oj00XB63irPTks0-A_1rMNfdTunoOVZfVOExRRBNrupUf8TY4Kw5iQNQgf2rwcaM8hXNQg7KDyvMR5B-HzoCE1mwy2ba9yxvmtiJrdV-xBgO8c5iJL65BCd0slyI1 &key=YOUR_API_KEY
การตอบกลับด้วยรูปภาพ
การตอบกลับคำขอรูปภาพสถานที่ที่สำเร็จจะเป็นรูปภาพ ประเภทของรูปภาพนั้นจะขึ้นอยู่กับประเภทของรูปภาพที่ส่งในตอนแรก
หากคำขอของคุณเกินโควต้าที่มีอยู่ เซิร์ฟเวอร์จะแสดงสถานะ HTTP 403 และแสดงรูปภาพด้านล่างเพื่อระบุว่ามีการใช้งานเกินโควต้าแล้ว
หากเซิร์ฟเวอร์ไม่เข้าใจคำขอของคุณ เซิร์ฟเวอร์จะแสดงสถานะ HTTP 400 ซึ่งระบุคำขอที่ไม่ถูกต้อง สาเหตุที่พบบ่อยที่สุดสำหรับ คำขอที่ไม่ถูกต้อง ได้แก่
- การอ้างอิงรูปภาพที่ส่งไม่ได้ระบุอย่างถูกต้อง
- คำขอไม่มีพารามิเตอร์
maxwidth
หรือmaxheight
- ตั้งค่าพารามิเตอร์
maxwidth
หรือmaxheight
เป็นnull