一切就绪!

着手开发前,请先阅读我们的开发者文档

激活 Google Street View Image API

为帮助您起步,我们将引导您在 Google Developers Console 中先完成几项任务:

  1. 创建或选择项目
  2. 激活 Google Street View Image API
  3. 创建相应密钥
继续

Google Street View Image API

简介

Google Street View Image API 允许您无需使用 JavaScript 便可将静态(非交互式)街景全景图或缩略图嵌入您的网页。视口使用通过标准 HTTP 请求发送的 URL 参数定义,以静态图像形式返回。

https://maps.googleapis.com/maps/api/streetview?size=400x400&location=40.720032,-73.988354
&fov=90&heading=235&pitch=10
&key=YOUR_API_KEY

URL 参数

街景图像请求是一个 HTTP 网址,其格式如下:

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

图像使用请求参数指定。依照 URL 的标准,所有参数都使用“与”字符 (&) 分隔。下面列出了允许的参数及其可能的值。

必填参数

二者择一:

  • location,可以是文本字符串(如 Chagrin Falls, OH),或纬度/经度值 (40.457375,-80.009353)。Google Street View Image API 将对应在离该位置最近处拍摄的全景图。如果提供了地址文本字符串,API 可以利用其他摄像头位置改善指定位置的显示。如果提供了纬度/经度,API 会在半径 50 米范围内查找最接近该位置的照片。由于街景图像会定期更新,并且可能每次拍摄照片的位置都略有差异,因此可能出现图像更新后您的 location 对应于不同全景图的情况。

或者:

  • pano 是具体的全景图 ID。这些值通常很稳定。

以及:

  • size,以像素表示图像的输出尺寸。尺寸指定为 {width}x{height} 格式 - 例如,size=600x400 返回宽 600 像素、高 400 像素的图像。
  • key,可通过它在 Google API Console 中监控您的应用的 API 使用情况,获取大量的每日免费配额,并确保 Google 可以在必要时就应用的相关事宜与您联系。如需了解详细信息,请参阅获取密钥和签名

    注:Google Maps APIs Premium Plan 客户可以在 Street View 请求中使用 API 密钥和数字签名,或者有效的客户端 ID 和数字签名。获取有关 Premium Plan 客户身份验证参数的更多信息。

    “之前”已有 Google Maps APIs for Work 许可证的客户必须在其请求中附带有效的 clientsignature 参数而不是 key。如需了解详细信息,请参阅“获取密钥和签名”页面的客户端 ID 和签名部分。

可选参数

  • signature推荐项)是一种数字签名,用于验证任何使用您的 API 密钥生成请求的网站都获得了相应授权。注:如果启用收费,则必须提供数字签名。如果超过地图加载的每日免费限额,当天剩余时间内的额外地图加载将被收取费用。不包含数字签名的可收费地图加载将会失败。如需了解详细信息,请参阅获取密钥和签名

    注:对于 Google Maps APIs Premium Plan 客户,必须提供数字签名。获取有关 Premium Plan 客户身份验证参数的更多信息。

  • heading 表示摄像头的罗盘航向。可接受值的范围是 0360(两个值都表示北方,90 表示东方,180 表示南方)。如果未指定航向,将自动计算一个值,该值以拍摄最接近位置照片之处为中心,将摄像头导向指定 location
  • fov默认值为 90)决定图像的水平视野。视野以度数表示,允许的最大值为 120。在处理固定尺寸视口时,与处理固定尺寸街景图像时一样,视野本质上也表示缩放比例,数字越小,表示缩放比例越大。



    (左侧:fov=120;右侧:fov=20

  • pitch默认值为 0)指定摄像头相对于街景车辆的向上或向下角度。该值通常(但并不总是)水平间距。正值将使摄像头呈向上角度(90 度表示垂直向上);而负值将使摄像头呈向下角度(-90 度表示垂直向下)。

请求示例如下所示。

https://maps.googleapis.com/maps/api/streetview?size=600x300&location=46.414382,10.013988&heading=151.78&pitch=-0.76&key=YOUR_API_KEY

无图像可用

对于无街景图像可用的位置,Google Street View Image API 会返回一幅灰色普通图像,并显示文本“Sorry, we have no imagery here”。

指定位置无可用图像时显示的普通图像
图:指定位置无可用图像时显示的普通图像。

为避免这种情况,可通过请求街景图像元数据来确定指定位置是否有可用图像以及有关该图像的其他数据。

更多信息

如需了解有关使用 Google Street View Image API 或其他 Google Maps API 产品的详细信息,请务必参阅 Maps API 支持页面

发送以下问题的反馈:

此网页
Google Street View Image API
需要帮助?请访问我们的支持页面