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

ไม่บังคับ ระบุความกว้างสูงสุดที่ต้องการของรูปภาพในหน่วยพิกเซล หากรูปภาพมีขนาดเล็กกว่าค่าที่ระบุ ระบบจะแสดงผลรูปภาพต้นฉบับ หากรูปภาพมีขนาดใหญ่กว่าในมิติใดมิติหนึ่ง ระบบจะปรับขนาดให้ตรงกับมิติที่เล็กกว่าใน 2 มิตินั้น โดยจำกัดไว้ที่สัดส่วนภาพเดิม ทั้งพร็อพเพอร์ตี้ maxHeightPx และ maxWidthPx ยอมรับจำนวนเต็มระหว่าง 1 ถึง 4800 โดยรวม หากค่าไม่อยู่ในช่วงที่อนุญาต ระบบจะแสดงข้อผิดพลาด INVALID_ARGUMENT

ต้องระบุ maxHeightPx หรือ maxWidthPx อย่างน้อย 1 รายการ หากไม่ได้ระบุทั้ง maxHeightPx และ maxWidthPx ระบบจะแสดงข้อผิดพลาด INVALID_ARGUMENT
maxHeightPx

integer

ไม่บังคับ ระบุความสูงสูงสุดที่ต้องการของรูปภาพเป็นพิกเซล หากรูปภาพมีขนาดเล็กกว่าค่าที่ระบุ ระบบจะแสดงผลรูปภาพต้นฉบับ หากรูปภาพมีขนาดใหญ่กว่าในมิติใดมิติหนึ่ง ระบบจะปรับขนาดให้ตรงกับมิติที่เล็กกว่าใน 2 มิตินั้น โดยจำกัดไว้ที่สัดส่วนภาพเดิม ทั้งพร็อพเพอร์ตี้ maxHeightPx และ maxWidthPx ยอมรับจำนวนเต็มระหว่าง 1 ถึง 4800 โดยรวม หากค่าไม่อยู่ในช่วงที่อนุญาต ระบบจะแสดงข้อผิดพลาด INVALID_ARGUMENT

ต้องระบุ maxHeightPx หรือ maxWidthPx อย่างน้อย 1 รายการ หากไม่ได้ระบุทั้ง maxHeightPx และ maxWidthPx ระบบจะแสดงข้อผิดพลาด INVALID_ARGUMENT
skipHttpRedirect

boolean

ไม่บังคับ หากตั้งค่าไว้ ให้ข้ามลักษณะการทำงานของการเปลี่ยนเส้นทาง HTTP เริ่มต้นและแสดงการตอบกลับในรูปแบบข้อความ (เช่น ในรูปแบบ JSON สำหรับกรณีการใช้งาน 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/maps-platform.places.getphotomedia
  • https://www.googleapis.com/auth/maps-platform.places
  • https://www.googleapis.com/auth/cloud-platform