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

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

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

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

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

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