百度地图全景静态图API可轻松实现将全景地图以图片形式嵌入到开发者的应用中。
开发者只需要设置图片尺寸、经纬度坐标等参数,发送HTTP请求访问百度地图全景静态图服务,便可在PC浏览器、手机浏览器、移动APP或者车机显示屏中以图片形式展示全景图。
注:本服务属于高级权限,需付费开通,您可以联系我们开通15天试用并了解更多信息。
以下为奎科科技大厦周边点全景图请求示例:
https://api.map.baidu.com/panorama/v2?ak=您的密钥&width=512&height=256&location=116.313393,40.04778&fov=180//GET请求
使用场景
使用全景静态图接口,可获取图片形式的全景图,并支持将图片嵌入到PC浏览器、手机浏览器、移动APP、车机显示屏等多种场景的应用中。
服务参数列表
https://api.map.baidu.com/panorama/v2 //GET请求
组成说明:
域名:api.map.baidu.com
服务名:panorama
版本号:v2
ak: 使用前请先申请密钥,申请密钥时,请选择ak的应用类型为 “for server”。
服务参数说明
参数名 | 必选 | 默认值 | 描述 |
---|---|---|---|
ak | 是 | 无 | 用户的访问密钥。只支持浏览器端ak和Android/IOS SDK的ak,服务端ak不支持sn校验方式。 |
mcode | 否 | 无 | 安全码。若为Android/IOS SDK的ak, 该参数必需。 |
width | 否 | 400 | 图片宽度,范围[10,1024] |
height | 否 | 300 | 图片高度,范围[10,512] |
location | 是 | 无 | 全景位置点坐标。坐标格式:lng<经度>,lat<纬度>,例如116.313393,40.047783。 |
coordtype | 否 | bd09ll | 全景位置点的坐标类型,目前支持bd09ll(百度坐标),wgs84ll(GPS坐标)和gcj02(google,高德,soso坐标)。 |
poiid | 是 | 无 | poi的id,该属性通常通过place api接口获取,poiid与panoid、location一起设置全景的显示场景,优先级为:poiid>panoid>location。其中根据poiid获取的全景视角最佳。 |
panoid | 是 | 无 | 全景图id,panoid与poiid、location一起设置全景的显示场景,优先级为:poiid>panoid>location。 |
heading | 否 | 0 | 水平视角,范围[0,360] |
pitch | 否 | 0 | 垂直视角,范围[0,90]。 |
fov | 否 | 90 | 水平方向范围,范围[10,360],fov=360即可显示整幅全景图 |
返回码说明
状态码 | 含义 |
---|---|
0 | 正常 |
507 | coordtype赋值错误,目前只支持bd09ll,wgs84ll |
509 | ak为必选参数,没有加ak时返回错误。其他ak验证码,请 查看 |
508 | 请求ak验证服务失败 |
302 | 坐标的格式不对,经纬度应该以逗号分隔 |
303 | 百度经纬度坐标转换为百度墨卡托坐标错误 |
304 | wgs84经纬度坐标转换为百度墨卡托坐标错误 |
402 | 请求坐标转panoid服务,返回错误,可能是该点没有panoid |
401 | 请求坐标转panoid服务失败 |
403 | 没有panoid 和 location 参数 |
404 | 根据poi id获取pano id服务请求失败 |
405 | 根据poi id获取pano id服务返回无效的pano id |
501 | 超出了width的范围 |
502 | 超出了height的范围 |
503 | 超出了heading 的范围 |
506 | 超出了fov的范围 |
601 | 请求街景服务失败 |
查看更多控制服务返回码定义
WGS84:为一种大地坐标系,也是目前广泛使用的全球卫星定位系统使用的坐标系。
GCJ02:是由中国国家测绘局制订的地理信息系统的坐标系统。由WGS84坐标系经加密后的坐标系。
BD09:为百度坐标系,在GCJ02坐标系基础上再次加密。其中bd09ll表示百度经纬度坐标,bd09mc表示百度墨卡托米制坐标
全景静态图 API v2.0的输入参数支持以上三种坐标系,开发者无需进行任何坐标转换,通过请求参数"coordtype"指明所使用的坐标系即可。
服务相关配额及并发请求限制请访问开发者权益页面查看。
编码说明
API请求中需要用到中文或一些特殊字符的参数,如query、region等,为了避免提交到后台乱码,需要对这几个参数值进行编码处理,转换成UTF-8字符的二字符十六进制值,凡是不在下表中的字符都需要进行编码。
字符集合 | 字符 |
URL非保留字 |
a b c d e f g h i j k l m n o p q r s t u v w x y z A B C D E F G H I J K L M N O P Q R S T U V W X Y Z 0 1 2 3 4 5 6 7 8 9 - _ . ~ |
URL保留字 |
! * ' ( ) ; : @ & = + $ , / ? % # [ ] |
如果中文参数中使用URL保留字字符的字面意思,例如:region关键字取值为"?北京",检索关键字包含一个问号,此问号也必须进行编码。
附注:
javascript中一般采用encodeURIComponent函数对特殊字符进行编码。
Java中可以使用函数URLEncoder.encode对特殊字符进行编码。
C#中可以使用函数HttpUtility.UrlEncode对特殊字符进行编码。
php中可以使用函数urlencode对特殊字符进行编码。