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

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

บริการรูปภาพสถานที่ซึ่งเป็นส่วนหนึ่งของ Places API คือ API แบบอ่านอย่างเดียวที่ช่วยให้คุณสามารถเพิ่มเนื้อหาภาพถ่ายคุณภาพสูงลงในแอปพลิเคชันของคุณ บริการรูปภาพสถานที่ทำให้คุณสามารถเข้าถึงรูปภาพนับล้าน ที่เก็บอยู่ในฐานข้อมูลสถานที่ เมื่อคุณได้รับข้อมูลสถานที่โดยใช้คำขอรายละเอียดสถานที่ รูปภาพจะถูกแสดงการอ้างอิงเป็นรูปภาพสำหรับเนื้อหาภาพถ่ายที่เกี่ยวข้อง คำขอค้นหาสถานที่ การค้นหาใกล้เคียง และการค้นหาข้อความยังแสดงการอ้างอิงรูปภาพรายการเดียวต่อสถานที่ด้วย หากเกี่ยวข้อง เมื่อใช้บริการรูปภาพ คุณสามารถเข้าถึงรูปภาพที่อ้างอิงและปรับขนาดรูปภาพเป็นขนาดที่เหมาะสมที่สุดสำหรับแอปพลิเคชันของคุณ

คำขอรูปภาพเกี่ยวกับสถานที่

คำขอรูปภาพสถานที่คือ URL แบบ HTTP ของแบบฟอร์มต่อไปนี้

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 ซึ่งแสดงเป็นคำขอที่ไม่ถูกต้อง สาเหตุที่พบบ่อยที่สุด ของคำขอที่ไม่ถูกต้อง ได้แก่