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

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

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

คำขอ Place 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.

  • 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 ซึ่งแสดงในการตอบกลับคำขอค้นหาสถานที่ (เดิม) การค้นหาใกล้เคียง (เดิม) การค้นหาข้อความ (เดิม) หรือรายละเอียดสถานที่ (เดิม) การตอบกลับคำขอเหล่านี้จะมีฟิลด์ photos[] หากสถานที่มีเนื้อหารูปภาพที่เกี่ยวข้อง

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

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

เอลิเมนต์ photo แต่ละรายการจะมีช่องต่อไปนี้

  • photo_reference — สตริงที่ใช้ระบุรูปภาพเมื่อคุณส่งคำขอ Place Photos (เดิม)
  • 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

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

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

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

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

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