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

นักพัฒนาซอฟต์แวร์ในเขตเศรษฐกิจยุโรป (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 ระบุความสูงสูงสุดที่ต้องการของรูปภาพในหน่วยพิกเซล หากรูปภาพมีขนาดเล็กกว่าค่าที่ระบุ ระบบจะแสดงรูปภาพต้นฉบับ หากรูปภาพมีขนาดใหญ่กว่าในมิติใดมิติหนึ่ง ระบบจะปรับขนาดให้ ตรงกับมิติที่เล็กกว่า โดยจำกัดอัตราส่วนกว้างยาวเดิม

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

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