关于腾讯位置服务不再支持HTTP方式调用的公告
为保证数据传输安全,提高安全性,腾讯位置服务 - 街景静态图API将不再支持HTTP方式调用。
请开发者尽快调整,将现有通过HTTP方式调用的切换成 HTTPS 调用,以避免受到影响。 平台将于 2018年9月30日 停止对HTTP方式调用的支持。

请求URL

街景静态图API和地图静态图API类似,是通过构造一个HTTP协议的URL调用获取一张街景的静态图片。形式如下:

https://apis.map.qq.com/ws/streetview/v1/image?parameters

参数说明

参数 必填 说明 示例
size 街景图片大小,宽x高,单位像素。宽度值不超过960px,高度值不超过640px。 size=138x187
location Location和pano必填一项,两者同时出现取pano值。 坐标或者地点名称,用于确定截图场景位置 location=中国技术交易大厦 或者 location=39.12,116.83
pano 街景的场景ID,用于确定截图场景位置 pano=10011022120723095812200
heading 偏航角,与正北方向夹角,顺时针一周为360度,取值范围[0,360] 默认值:0 正北:heading=0,正东:heading=90, 正南:heading=180,正西:heading=270
pitch 俯仰角,街景相机抬头或低头的角度,平视时为0,低头为(0,20],抬头为[-90,0) 默认值:0 pitch=0
key 开发者密钥,申请密钥 key=OB4BZ-D4W3U-7BVVO-4PJWW-6TKDJ-WPB77

location

若指定该参数为地名,服务将根据地名进行地址解析得到坐标,查询距离坐标所在位置最近的场景点,如果查到则返回街景图片。注意,若参数取值含中文,调用前需要进行URL编码。

若指定该参数为坐标,则服务直接查询距离坐标所在位置最近的场景点,如果查到则返回街景图片。

pano

指定有效的pano参数,可以唯一确定一个场景点,返回该场景点的街景截图。适用于需要准确指定场景点。

注意:指定location参数,会有查不到场景点的情况,因而得不到街景图片。如果要确保能返回图片,则请使用pano参数,关于pano参数的获取,请参考街景场景信息查询

示例


示例调用结果