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 ระยะสั้นที่ใช้แสดงผลรูปภาพได้

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/cloud-platform