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

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

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

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

คำขอรูปภาพสถานที่ (เดิม) คือ 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.

การอ้างอิงรูปภาพ

คำขอทั้งหมดไปยัง Place Photos (เดิม) ต้องมี photo_reference, ซึ่งส่งคืนในการตอบกลับคำขอ Find Place (เดิม), Nearby Search (เดิม), Text Search (เดิม) หรือ Place Details (เดิม) การตอบกลับคำขอเหล่านี้จะมีฟิลด์ 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"
       }]
    ...

ตัวอย่างรูปภาพสถานที่ (เดิม)

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

https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=ATJ83zhSSAtkh5LTozXMhBghqubeOxnZWUV2m7Hv2tQaIzKQJgvZk9yCaEjBW0r0Zx1oJ9RF1G7oeM34sQQMOv8s2zA0sgGBiyBgvdyMxeVByRgHUXmv-rkJ2wyvNv17jyTSySm_-_6R2B0v4eKX257HOxvXlx_TSwp2NrICKrZM2d5d2P4q&key=YOUR_API_KEY

การตอบกลับรูปภาพสถานที่ (เดิม)

การตอบกลับคำขอ Place Photos (เดิม) ที่สำเร็จคือรูปภาพ ประเภท ของรูปภาพจะขึ้นอยู่กับประเภทของรูปภาพที่ส่งมาในตอนแรก

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

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

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

  • ไม่ได้ระบุข้อมูลอ้างอิงรูปภาพที่ส่งมาอย่างถูกต้อง
  • คำขอไม่มีพารามิเตอร์ maxwidth หรือ maxheight
  • มีการตั้งค่าสำหรับพารามิเตอร์ maxwidth หรือ maxheight เป็น null
  • photo_reference หมดอายุแล้ว หาก photo_reference หมดอายุ ให้ส่งคำขอไปยัง Place Details (เดิม) Find Place (เดิม) Nearby Search (เดิม) หรือ Text Search (เดิม) เพื่อรับค่า photo_reference ที่อัปเดต