此页面由 Cloud Translation API 翻译。

街景图像元数据

简介

Street View Static API 元数据请求提供有关街景全景图的数据。可以利用元数据来了解给定位置是否有可用的街景图片，以及通过编程方式获取经纬度坐标、全景图 ID、照片拍摄日期以及图像的版权信息。可通过获取这些元数据自定义应用内的出错时行为。

Street View Static API 元数据请求是免费的。请求元数据时不消耗任何配额。只有在您使用 Street View Static API 加载图片时，才会消耗配额。

发出街景图像元数据请求时，全景图像的精确度为 50 米。

访问图像元数据

街景图像元数据请求是一个 HTTP 网址，其格式如下：

https://maps.googleapis.com/maps/api/streetview/metadata?parameters

依照网址的标准，所有参数都使用“与”符号 (&) 分隔。

元数据请求的必需参数

元数据请求接受的网址参数与 Street View Static API 图像请求相同，但只有下列参数是必需参数：

采用以下任一方式：

location - 可以是文本字符串（例如 Chagrin Falls, OH），也可以是经纬度坐标对（40.457375,-80.009353），以英文逗号分隔。

或者：

pano - 具体的全景图 ID。全景图的 ID 可能会随时间而变化，因此请勿保留此 ID。请改为保存位置地址或纬度和经度坐标，以便刷新全景图片 ID。如需了解详情，请参阅刷新已删除的全景图 ID。

以及：

key 和 signature - 必须提供 API 密钥才能对请求进行身份验证。在某些情况下，还必须提供数字签名，并且始终建议提供。如需了解详情，请参阅获取密钥和签名。

仅包含必需参数的元数据请求如下所示：

https://maps.googleapis.com/maps/api/streetview/metadata?location=&key=YOUR_API_KEY&signature=

或如下所示：

https://maps.googleapis.com/maps/api/streetview/metadata?pano=&key=YOUR_API_KEY&signature=

刷新已删除的全景图 ID

如果您尝试检索全景图片 ID 并收到 ZERO_RESULTS 或无值，则表示全景图片 ID 已被删除，需要刷新。

保存您用于获取全景图 ID 的位置地址或纬度和经度坐标，以便您在需要时进行刷新。
如果您检测到全景图 ID 已更改，请使用原始位置地址或纬度和经度坐标重新搜索距离该位置最近的全景图，并获取新的全景图 ID。

元数据请求的可选参数

您可以在元数据请求中添加以下参数：size、heading、fov 和 pitch。请注意，这些参数不影响有关全景图的数据，或找到的是哪个全景图。为了更方便地构建与特定图像请求有关的元数据请求，API 允许加入的参数与图像请求相同，但对于元数据请求，API 会忽略可选参数及其值。如需了解如何使用这些参数，请参阅 Street View Static API 开发者指南。

响应格式

元数据响应只以 JSON 格式返回。

示例

示例 1：找到全景图

下列网址成功请求了同一全景图的元数据和图像。

元数据请求和响应

https://maps.googleapis.com/maps/api/streetview/metadata?size=600x300&location=eiffel%20tower,%20paris,%20france&heading=-45&pitch=42&fov=110&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

{
   "copyright" : "© 2017 Google",
   "date" : "2016-05",
   "location" : {
      "lat" : 48.85783227207914,
      "lng" : 2.295226175151347
   },
   "pano_id" : "tu510ie_z4ptBZYo2BGEJg",
   "status" : "OK"
}

图像请求和响应，其中预计缺少图片。

https://maps.googleapis.com/maps/api/streetview?size=600x300&location=eiffel%20tower,%20paris,%20france&heading=-45&pitch=42&fov=110&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

示例 2：找不到全景图

下列网址请求的元数据和图像所对应全景图在指定位置或其附近无法找到。

元数据请求和响应

https://maps.googleapis.com/maps/api/streetview/metadata?size=600x300&location=78.648401,14.194336&fov=90&heading=235&pitch=10&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

{
   "status" : "ZERO_RESULTS"
}

图像请求和响应

https://maps.googleapis.com/maps/api/streetview?size=600x300&location=78.648401,14.194336&fov=90&heading=235&pitch=10&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

状态代码

元数据响应对象中的 status 字段包含了请求的状态，还可能包含调试信息，这些信息可帮助您查明街景请求不起作用的原因。status 字段可能包含以下值：

状态	说明
`"OK"`	表示未出现错误；找到了全景图并返回了元数据。
`"ZERO_RESULTS"`	表示在提供的位置附近找不到全景图。如果您提供的全景图 ID 不存在或无效，就可能会出现这种情况。请参阅 [刷新已删除的全景图 ID](#refresh-pano)。
`"NOT_FOUND"`	表示找不到 `location` 参数中提供的地址字符串。如果提供的地址不存在，就可能会出现这种情况。
`"OVER_QUERY_LIMIT"`	表示您已超出了该 API 的每日配额或每秒配额。
`"REQUEST_DENIED"`	表示系统已拒绝您的请求。如果您未授权请求，或者未在包含 API 密钥的 Google Cloud 控制台项目中激活 Street View Static API，就可能会出现此消息。
`"INVALID_REQUEST"`	一般表示缺少查询参数（地址、纬度和经度坐标或组件）。
`"UNKNOWN_ERROR"`	表示因服务器出错而无法处理该请求。此问题通常是暂时性的。如果您再试一次，该请求可能会成功。