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

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