Method: places.photos.getMedia

获取带有照片引用字符串的照片媒体。

HTTP 请求

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

网址采用 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 之一。如果未指定 maxHeightPx 和 maxWidthPx,系统会返回 INVALID_ARGUMENT 错误。

maxHeightPx

integer

可选。指定图像的所需最大高度(以像素为单位)。如果图片小于指定的值,则返回原始图片。如果图像任何一个维度过大,它将按照其原始纵横比缩小至匹配两个尺寸中的较小者。maxHeightPx 和 maxWidthPx 属性均接受介于 1 到 4800 之间的整数(包括这两个数值)。如果值不在允许范围内,则会返回 INVALID_ARGUMENT 错误。

需要至少指定 maxHeightPx 或 maxWidthPx 之一。如果未指定 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。