รูปภาพสถานที่ (เดิม)

นักพัฒนาซอฟต์แวร์ในเขตเศรษฐกิจยุโรป (EEA)

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

คำขอรูปภาพสถานที่ (เดิม)

คำขอรูปภาพสถานที่ (เดิม) คือ 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[] หากสถานที่นั้นมีเนื้อหาภาพถ่ายที่เกี่ยวข้อง

หมายเหตุ: จำนวนรูปภาพที่แสดงจะแตกต่างกันไปตามคำขอ

  • คำขอ Find Place (เดิม), Nearby Search (เดิม) หรือ Text Search (เดิม) จะแสดงองค์ประกอบ photo อย่างน้อย 1 รายการในอาร์เรย์
  • คำขอรายละเอียดสถานที่ (เดิม) จะแสดงผลองค์ประกอบ photo สูงสุด 10 รายการ

องค์ประกอบ photo แต่ละรายการมีฟิลด์ต่อไปนี้

  • photo_reference - สตริงที่ใช้ระบุรูปภาพเมื่อคุณ ส่งคำขอ Place Photos (เดิม)
  • height — ความสูงสูงสุดของรูปภาพ
  • width — ความกว้างสูงสุดของรูปภาพ
  • html_attributions[] — มีการระบุแหล่งที่มาที่จำเป็น ฟิลด์นี้จะแสดงเสมอ แต่ก็อาจว่างเปล่าได้

รูปภาพที่ Place Photos (เดิม) แสดงจะมาจากแหล่งที่มาต่างๆ ซึ่งรวมถึงเจ้าของธุรกิจและรูปภาพที่ผู้ใช้ร่วมกัน ในกรณีส่วนใหญ่ คุณสามารถใช้รูปภาพเหล่านี้ได้โดยไม่ต้องระบุแหล่งที่มา หรือจะมีข้อกำหนดในการระบุแหล่งที่มาเป็นส่วนหนึ่งของรูปภาพ อย่างไรก็ตาม หากองค์ประกอบ 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"
       }]
    ...

ตัวอย่าง Place Photos (เดิม)

ตัวอย่างคำขอแสดงอยู่ด้านล่าง คำขอนี้จะแสดงรูปภาพที่อ้างอิง โดยปรับขนาดให้มีความกว้างไม่เกิน 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 ซึ่งบ่งชี้ว่าคำขอไม่ถูกต้อง สาเหตุที่พบบ่อยที่สุดที่ทำให้เกิด คำขอที่ไม่ถูกต้องมีดังนี้