关于腾讯位置服务不再支持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参数的获取,请参考街景场景信息查询。