街景请求和响应

街景图像请求是一个采用以下格式的 HTTP 网址：

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

系统会使用相关请求的参数指定图像。根据 网址，所有参数均使用和号字符 (&) 分隔。 下面列出了允许的参数及其可能的值。

必需参数

采用以下任一方式：

  • location 可以是文本字符串（例如 Chagrin Falls, OH） 或经纬度坐标对 (40.457375,-80.009353)， 并且应进行网址编码。因此， 如“City Hall, New York, NY” 到“City+Hall,New+York,NY”然后再发送请求 Street View Static API 用于贴靠距离最近的全景照片 位置。当您提供地址文本字符串时，API 可能会使用 其他相机位置，以便更好地显示指定的位置。 如果您提供经纬度坐标，API 在半径 50 米的范围内搜索离该位置最近的照片。 由于街景图像会定期刷新，并且照片可能 位置每次都略有差异，就有可能 更新图像时，您的 location 可能会贴靠到其他全景图片。

或者：

  • pano 是特定的全景图片 ID。全景图片可能会随时间改变 ID，因此 请勿保存此 ID而应改为保存地点地址或 纬度和经度坐标，以便您可以刷新全景图片 ID。对于 详情请参阅刷新已删除的全景图片 ID。

以及：

  • size 用于指定图像的输出大小（以像素为单位）。大小指定为 {width}x{height} - 例如 size=600x400 用于返回一张宽 600 像素、高 400 像素的图片。
  • key 可用于在 Google Cloud 控制台、 并确保 Google 可以在必要时就应用的相关事宜与您联系。 如需了解详情，请参阅获取密钥和签名。

刷新已删除的全景图片 ID

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

  1. 保存您过去使用的地点地址或经纬度坐标 获取全景图片 ID，以便在需要时刷新。

  2. 当您检测到全景图片 ID 发生更改时，使用原始位置 地址或经纬度坐标，以再次搜索离 并获取新的全景 ID。

。

可选参数

  • signature（推荐）是使用数字签名 以验证使用您的 API 密钥生成请求的所有网站是否都已获得授权 。不包含数字签名的请求可能会失败。 如需了解详情，请参阅获取密钥和签名。

    注意：对于已采用 Google Maps Platform 专业版方案的客户，Digital 需要签名。详细了解 用于验证 专业版方案客户。

  • heading 表示 打开相机。接受的值介于 0 到 360 之间 （这两个值都表示北方，90 表示东方， 180 南）。如果您未指定标题，那么值将 使相机朝向指定的 location（从距离最近的照片 。
  • fov（默认值为 90） 确定图片的水平视野（以度为单位）， 且允许的最大值为 120。 处理大小固定的视口时，就像处理 设置大小，视野本质上表示缩放，数字较小 表示更高的缩放级别。


    广阔视野的屏幕截图，显示了水族箱内的天花板、墙壁、地板和水箱窗口。 特写视野屏幕截图，其中显示了水族箱内街景照片的放大细节。
    （左：fov=120；右：fov=20）

  • pitch（默认值为 0） 指定镜头相对于街景的向上或向下角度 。该角度通常（但并不总）是水平的。正值 将相机向上倾斜（90 度表示垂直向上）； 负值表示相机向下倾斜（其中 -90 表示 ）。
  • radius（默认值为 50） 用于设置半径（以米为单位指定），在该半径范围内搜索全景图片； 以指定的纬度和经度为中心。有效值为非负数 整数。
  • return_error_code 指示 API 是否应返回 在找不到图片时返回错误代码 (404 NOT FOUND)，或响应对 请求无效 (400 BAD REQUEST)。有效值为 true 和 false。如果设置为 true，则系统会显示错误消息 来代替通用的灰色图片。这样，您就无需 请另外发起调用，检查图片是否可用。
  • source（默认值为 default） 将街景搜索范围限制为选定来源。有效值包括：
    • default 使用默认街景来源； 搜索不限于特定来源。
    • outdoor，仅搜索室外全景图片。室内 集合未包含在搜索结果中。请注意，室外全景图片可能不存在 。另请注意，搜索 以便可以确定是在室内还是室外。例如： 不返回 PhotoSphere，因为照片是未知的（室内还是室外）。

这是一个示例请求。

https://maps.googleapis.com/maps/api/streetview?size=600x300&location=46.414382,10.013988&heading=151.78&pitch=-0.76&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
一张街道观景点照片的屏幕截图，其中显示了电气化铁轨。

无图像可用

对于无法获取街景图像的地点，请使用 Street View Static API 用于返回灰色的通用图片，其中附有文本“Sorry, we have no images 如以下示例中所示：

在指定位置没有可用的图像时显示的一般图片的屏幕截图。背景是浅棕色的，并且显示了“抱歉，此处没有任何图像”的文字。
图：没有适用于 指定位置。
。

仅显示有效图片

为了避免显示通用图片，并确保您的网页 仅显示有效的 Street View Static API 图像，请遵循这些 建议：

  • 将 return_error_code 参数设置为 true。 这会导致 Street View Static API 返回 404 NOT FOUND 而不是常规灰色图片，则会发生此错误， 指定位置。
  • 请求街景图片元数据 以确定指定位置是否有可用图像， 以及发送请求等操作