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

เลือกแพลตฟอร์ม: 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 คุณต้องใส่การระบุแหล่งที่มาเพิ่มเติมในแอปพลิเคชันของคุณด้วยทุกที่ที่แสดงรูปภาพ

ตัวอย่างอาร์เรย์ photos[] จะแสดงที่ด้านล่าง

...
"photos" : [
   {
      "html_attributions" : [],
      "height" : 853,
      "width" : 1280,
      "photo_reference" : "AUacShh3_Dd8yvV2JZMtNjjbbSbFhSv-0VmUN-uasQ2Oj00XB63irPTks0-A_1rMNfdTunoOVZfVOExRRBNrupUf8TY4Kw5iQNQgf2rwcaM8hXNQg7KDyvMR5B-HzoCE1mwy2ba9yxvmtiJrdV-xBgO8c5iJL65BCd0slyI1"
   }
...

ตัวอย่างรูปภาพสถานที่

ตัวอย่างคำขอแสดงอยู่ด้านล่าง คำขอนี้จะแสดงรูปภาพที่นำมาอ้างอิงและปรับขนาดให้กว้างไม่เกิน 400 พิกเซล

https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=AUacShh3_Dd8yvV2JZMtNjjbbSbFhSv-0VmUN-uasQ2Oj00XB63irPTks0-A_1rMNfdTunoOVZfVOExRRBNrupUf8TY4Kw5iQNQgf2rwcaM8hXNQg7KDyvMR5B-HzoCE1mwy2ba9yxvmtiJrdV-xBgO8c5iJL65BCd0slyI1&key=YOUR_API_KEY

การตอบกลับด้วยรูปภาพ

การตอบกลับคำขอรูปภาพสถานที่ที่สำเร็จจะเป็นรูปภาพ ประเภทของรูปภาพนั้นจะขึ้นอยู่กับประเภทของรูปภาพที่ส่งในตอนแรก

หากคำขอของคุณเกินโควต้าที่มีอยู่ เซิร์ฟเวอร์จะแสดงสถานะ HTTP 403 และแสดงรูปภาพด้านล่างเพื่อระบุว่ามีการใช้งานเกินโควต้าแล้ว

รูปภาพเกินโควต้า

หากเซิร์ฟเวอร์ไม่เข้าใจคำขอของคุณ เซิร์ฟเวอร์จะแสดงสถานะ HTTP 400 ซึ่งระบุคำขอที่ไม่ถูกต้อง สาเหตุที่พบบ่อยที่สุดสำหรับ คำขอที่ไม่ถูกต้อง ได้แก่

  • การอ้างอิงรูปภาพที่ส่งไม่ได้ระบุอย่างถูกต้อง
  • คำขอไม่มีพารามิเตอร์ maxwidth หรือ maxheight
  • ตั้งค่าพารามิเตอร์ maxwidth หรือ maxheight เป็น null