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

จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
เลือกแพลตฟอร์ม: Android iOS JavaScript บริการเว็บ

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

คําขอรูปภาพสถานที่

คําขอรูปภาพสถานที่คือ 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 มากที่สุด 1 รายการในอาร์เรย์
  • คําขอรายละเอียดสถานที่จะแสดงผลองค์ประกอบ 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