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

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

บริการรูปภาพสถานที่ซึ่งเป็นส่วนหนึ่งของ 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 and maxwidth properties accept an integer between 1 and 1600.

  • 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.

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