รูปภาพสถานที่

เลือกแพลตฟอร์ม: Android iOS JavaScript บริการเว็บ

บริการ 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 and maxwidth properties accept an integer between 1 and 1600.

    You must specify either maxheight, or maxwidth, 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 ซึ่งระบุคำขอที่ไม่ถูกต้อง สาเหตุที่พบบ่อยที่สุดของคำขอที่ไม่ถูกต้อง ได้แก่