Method: places.photos.getMedia

获取包含照片参考字符串的照片媒体。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
name

string

必需。照片媒体的资源名称，格式为：places/{placeId}/photos/{photo_reference}/media。

Place 对象的 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 重定向行为，并呈现文本格式（例如，对于 HTTP 使用情形，以 JSON 格式）的响应。如果未设置，系统将发出 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