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

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

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

คำขอ Place Photos (เดิม)

คำขอ Place Photos (เดิม) คือ HTTP URL ในรูปแบบต่อไปนี้

https://maps.googleapis.com/maps/api/place/photo?parameters

ต้องใช้พารามิเตอร์บางอย่างเพื่อเริ่มคำขอค้นหา พารามิเตอร์ทั้งหมดจะแยกกันโดยใช้อักขระแอมเพอร์แซนด์ (&) ตามมาตรฐานใน URL รายการพารามิเตอร์และค่าที่เป็นไปได้จะแสดงอยู่ด้านล่าง

พารามิเตอร์ที่จำเป็น

photo_reference

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

maxheight หรือ maxwidth

maxheight ระบุความสูงสูงสุดที่ต้องการของรูปภาพในหน่วยพิกเซล หากรูปภาพมีขนาดเล็กกว่าค่าที่ระบุ ระบบจะแสดงรูปภาพต้นฉบับ หากรูปภาพมีขนาดใหญ่กว่าในด้านใดด้านหนึ่ง ระบบจะปรับขนาดให้ตรงกับด้านที่เล็กกว่าจากทั้ง 2 ด้าน โดยจำกัดตามสัดส่วนภาพเดิม

maxwidth ระบุความกว้างสูงสุดที่ต้องการของรูปภาพในหน่วยพิกเซล หากรูปภาพมีขนาดเล็กกว่าค่าที่ระบุ ระบบจะแสดงรูปภาพต้นฉบับ หากรูปภาพมีขนาดใหญ่กว่าในด้านใดด้านหนึ่ง ระบบจะปรับขนาดให้ตรงกับด้านที่เล็กกว่าจากทั้ง 2 ด้าน โดยจำกัดตามสัดส่วนภาพเดิม

ทั้งพร็อพเพอร์ตี้ maxheight และ maxwidth ยอมรับจำนวนเต็มระหว่าง 1 ถึง 1600

คุณต้องระบุ maxheight หรือ maxwidth หรือทั้ง 2 อย่าง

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

คำขอทั้งหมดไปยัง Place Photos (เดิม) ต้องมี photo_reference ซึ่งแสดงในการตอบกลับคำขอค้นหาสถานที่ (เดิม), การค้นหาในบริเวณใกล้เคียง (เดิม), การค้นหาข้อความ (เดิม) หรือรายละเอียดสถานที่ (เดิม) การตอบกลับคำขอเหล่านี้จะมีฟิลด์ photos[] หากสถานที่นั้นมีเนื้อหาภาพถ่ายที่เกี่ยวข้อง

  • คำขอค้นหาสถานที่ (เดิม), การค้นหาในบริเวณใกล้เคียง (เดิม) หรือการค้นหาข้อความ (เดิม) จะแสดงผลองค์ประกอบ 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

การตอบกลับของ Place Photos (เดิม)

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

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

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

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