Method: places.photos.getMedia

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

คำขอ 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 ที่มีระยะเวลาสั้นๆ ที่ใช้แสดงภาพได้