获取带有照片引用字符串的照片媒体。
HTTP 请求
GET https://places.googleapis.com/v1/{name=places/*/photos/*/media}
网址采用 gRPC 转码语法。
路径参数
参数 | |
---|---|
name |
必需。照片媒体的资源名称,格式为: 在 Place 对象的 |
查询参数
参数 | |
---|---|
maxWidthPx |
可选。指定所需的图像最大宽度(以像素为单位)。如果图片小于指定的值,则返回原始图片。如果图片在任一方向上变大,系统就会将其缩放至与两个尺寸中的较小者相匹配,但会受其原始宽高比限制。maxHeightPx 和 maxWidthPx 属性都接受 1 到 4800(包括 1 和 4800)之间的整数。如果值不在允许范围内,系统将返回 INVALID_STRING 错误。 至少需要指定 maxHeightPx 和 maxWidthPx 中的一个。如果 maxHeightPx 和 maxWidthPx 均未指定,则会返回 INVALID_STRING 错误。 |
maxHeightPx |
可选。指定所需的图像最大高度(以像素为单位)。如果图片小于指定的值,则返回原始图片。如果图片在任一方向上变大,系统就会将其缩放至与两个尺寸中的较小者相匹配,但会受其原始宽高比限制。maxHeightPx 和 maxWidthPx 属性都接受 1 到 4800(包括 1 和 4800)之间的整数。如果值不在允许范围内,系统将返回 INVALID_STRING 错误。 至少需要指定 maxHeightPx 和 maxWidthPx 中的一个。如果 maxHeightPx 和 maxWidthPx 均未指定,则会返回 INVALID_STRING 错误。 |
skipHttpRedirect |
可选。如果设置了此字段,则会跳过默认的 HTTP 重定向行为,并呈现文本格式(例如,对于 HTTP 用例,采用 JSON 格式)响应。如果未设置此政策,系统将发出 HTTP 重定向以将调用重定向到图片媒体。对于非 HTTP 请求,系统会忽略此选项。 |
请求正文
请求正文必须为空。
响应正文
来自 Places API 的照片媒体。
如果成功,响应正文将包含结构如下的数据:
JSON 表示法 |
---|
{ "name": string, "photoUri": string } |
字段 | |
---|---|
name |
照片媒体的资源名称,格式为: |
photoUri |
可用于渲染照片的短期 URI。 |