Method: photos.batchGet

获取指定 Photo 批次的元数据。

请注意,如果 photos.batchGet 失败,则表示缺少关键字段或存在身份验证错误。即使 photos.batchGet 成功,批次中的个别照片也可能会失败。这些失败情况在 BatchGetPhotosResponse.results 中的每个 PhotoResponse.status 中指定。如需了解每张照片可能发生的具体失败情况,请参阅 photo.get

HTTP 请求

GET https://streetviewpublish.googleapis.com/v1/photos:batchGet

网址采用 gRPC 转码语法。

查询参数

参数
photoIds[]

string

必需。Photos 的 ID。对于 HTTP GET 请求,网址查询参数应为 photoIds=<id1>&photoIds=<id2>&...

view

enum (PhotoView)

必需。指定是否应在照片响应中返回照片字节的下载网址。

languageCode

string

可选。BCP-47 语言代码,例如“en-US”或“sr-Latn”。如需了解详情,请参阅 http://www.unicode.org/reports/tr35/#Unicode_locale_identifier。如果未指定 languageCode,系统会使用用户的 Google 服务语言偏好设置。

请求正文

请求正文必须为空。

响应正文

对批量获取 Photos 的响应。

如果成功,响应正文将包含结构如下的数据:

JSON 表示法
{
  "results": [
    {
      object (PhotoResponse)
    }
  ]
}
字段
results[]

object (PhotoResponse)

所请求的每个 Photo 的结果列表,与 photos.batchGet 中的请求顺序相同。

授权范围

需要以下 OAuth 范围:

  • https://www.googleapis.com/auth/streetviewpublish

如需了解详情,请参阅 OAuth 2.0 概览