Method: places.photos.getMedia

• คำขอ HTTP
• พารามิเตอร์เส้นทาง
• พารามิเตอร์การค้นหา
• เนื้อความของคำขอ
• เนื้อหาการตอบกลับ
  • การแสดง JSON

รับสื่อรูปภาพที่มีสตริงการอ้างอิงรูปภาพ

คำขอ HTTP

GET https://places.googleapis.com/v1/{name=places/*/photos/*/media}

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
name	string ต้องระบุ ชื่อทรัพยากรของสื่อรูปภาพในรูปแบบ: places/{placeId}/photos/{photo_reference}/media ชื่อทรัพยากรของรูปภาพที่แสดงผลในช่อง photos.name ของออบเจ็กต์สถานที่จะมีรูปแบบเป็น places/{placeId}/photos/{photo_reference} คุณต้องเพิ่ม /media ต่อท้ายทรัพยากรรูปภาพเพื่อรับชื่อทรัพยากรสื่อรูปภาพ

พารามิเตอร์การค้นหา

พารามิเตอร์
maxWidthPx	integer ไม่บังคับ ระบุความกว้างสูงสุดที่ต้องการของรูปภาพเป็นพิกเซล หากรูปภาพมีขนาดเล็กกว่าค่าที่ระบุ ระบบจะแสดงผลรูปภาพต้นฉบับ หากรูปภาพมีขนาดใหญ่กว่าในมิติข้อมูลใดมิติข้อมูลหนึ่ง ระบบจะปรับขนาดรูปภาพให้ตรงกับมิติข้อมูลขนาดเล็กกว่าโดยจำกัดไว้ที่อัตราส่วนภาพเดิม ทั้งพร็อพเพอร์ตี้ maxHeightPx และ maxWidthPx ยอมรับจำนวนเต็มระหว่าง 1 ถึง 4800 (รวม) หากค่าไม่ได้อยู่ในช่วงที่ได้รับอนุญาต ระบบจะแสดงข้อผิดพลาด INVALID_ARGUMENT ต้องระบุ maxHeightPx หรือ maxWidthPx อย่างน้อย 1 รายการ หากไม่ได้ระบุ maxHeightPx หรือ maxWidthPx ระบบจะแสดงข้อผิดพลาด INVALID_ARGUMENT
maxHeightPx	integer ไม่บังคับ ระบุความสูงสูงสุดที่ต้องการเป็นพิกเซลของรูปภาพ หากรูปภาพมีขนาดเล็กกว่าค่าที่ระบุ ระบบจะแสดงผลรูปภาพต้นฉบับ หากรูปภาพมีขนาดใหญ่ขึ้นในมิติใดมิติหนึ่ง จะมีการปรับขนาดให้ตรงกับขนาดที่เล็กลงโดยจำกัดไว้ที่สัดส่วนภาพเดิม ทั้งพร็อพเพอร์ตี้ maxHeightPx และ maxWidthPx ยอมรับจำนวนเต็มระหว่าง 1 ถึง 4800 (รวม) หากค่าไม่ได้อยู่ในช่วงที่ได้รับอนุญาต ระบบจะแสดงข้อผิดพลาด INVALID_ARGUMENT ต้องระบุ maxHeightPx หรือ maxWidthPx อย่างน้อย 1 รายการ หากไม่ได้ระบุ maxHeightPx หรือ maxWidthPx ระบบจะแสดงข้อผิดพลาด INVALID_ARGUMENT
skipHttpRedirect	boolean ไม่บังคับ หากตั้งค่าไว้ ระบบจะข้ามลักษณะการเปลี่ยนเส้นทาง HTTP เริ่มต้นและแสดงผลคำตอบในรูปแบบข้อความ (เช่น ในรูปแบบ JSON สำหรับ Use Case ของ HTTP) หากไม่ได้ตั้งค่า ระบบจะออกการเปลี่ยนเส้นทาง HTTP เพื่อเปลี่ยนเส้นทางการเรียกไปยังสื่อรูปภาพ ระบบจะละเว้นตัวเลือกนี้สำหรับคำขอที่ไม่ใช่ HTTP

เนื้อหาของคำขอ

เนื้อหาของคำขอต้องว่างเปล่า

เนื้อหาการตอบกลับ

สื่อรูปภาพจาก Places API

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON
{ "name": string, "photoUri": string }

ช่อง
name	string ชื่อทรัพยากรของสื่อรูปภาพในรูปแบบ: places/{placeId}/photos/{photo_reference}/media
photoUri	string URI ที่มีระยะเวลาสั้นๆ ที่ใช้แสดงภาพได้