(→使用条款与限制) |
|||
第1行: | 第1行: | ||
{{webapi-sidebar}} | {{webapi-sidebar}} | ||
− | == | + | <div class="labels"><!--点击按钮代码--><div class="interiorNav"><div class="interiorLI">功能介绍</div><div class="interiorLI">服务文档</div><div class="interiorLI">使用指南</div></div></div><!--与按钮对应的内容代码--><div class="contents"><!--内容1--><div class="navRemark"><div class="handpointto">内容(服务介绍)</div></div><div class="txtstyle2"><div class="bluetitle"><div class="services-title-text">简介</div></div> |
− | + | 百度地图全景静态图API与静态图API类似,可轻松实现将全景地图以图片形式嵌入到您的应用中。您只需要设置图片尺寸、经纬度坐标等参数,发送HTTP请求访问百度地图全景静态图服务,便可在您的PC浏览器、手机浏览器、移动APP或者车机显示屏中以图片形式显示您的全景图。 | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | 以下为您展示百度奎科科技大厦周边点的全景图示例。 请求示例: | |
− | + | <div class="code-template"><pre class="get-url-pre">http://api.map.baidu.com/panorama/v2?ak=E4805d16520de693a3fe707cdc962045&width=512&height=256&location=116.313393,40.04778&fov=180 | |
− | + | </pre> | |
− | http:// | + | //请将AK替换为您的AK</div> |
− | + | [http://api.map.baidu.com/panorama/v2?ak=E4805d16520de693a3fe707cdc962045&width=512&height=256&location=116.313393,40.04778&fov=180 点击查看Demo] | |
− | + | 结果如下图所示: http://wiki.lbsyun.baidu.com/cms/jsapi/v2.jpg | |
− | + | 该套API免费对外开放,使用前请先申请密钥。 | |
− | + | <span style="color:#FF0000;">注意:申请密钥时,请选择ak的应用类型为 “for server”。</span> | |
+ | |||
+ | 您在使用百度地图Web服务 API之前,请先阅读百度地图API使用条款。任何非营利性应用请直接使用,商业应用请参考使用须知。 | ||
+ | </div><!--内容2--><div class="navRemark"><div class="handpointto">内容(服务文档)</div></div><div class="txtstyle2"><div class="bluetitle"><div class="services-title-text">服务文档</div></div> | ||
+ | '''{{bluepoint}}使用场景''' | ||
− | |||
使用全景静态图接口,可获取图片形式的全景图,并支持将图片嵌入到PC浏览器、手机浏览器、移动APP、车机显示屏等多种场景的应用中。 | 使用全景静态图接口,可获取图片形式的全景图,并支持将图片嵌入到PC浏览器、手机浏览器、移动APP、车机显示屏等多种场景的应用中。 | ||
− | |||
− | |||
− | {{bluepoint}}组成说明: | + | '''{{bluepoint}}服务参数列表''' |
+ | <div class="code-template"><pre class="get-url-pre">http://api.map.baidu.com/panorama/v2 | ||
+ | </pre> | ||
+ | </div> | ||
+ | '''{{bluepoint}}组成说明:''' | ||
− | + | 域名:api.map.baidu.com | |
− | + | 服务名:panorama | |
− | + | 版本号:v2 | |
− | + | ak: 该套API免费对外开放,使用前请先申请密钥。申请密钥时,请选择ak的应用类型为 “for server”。 | |
+ | |||
+ | '''{{bluepoint}}服务参数说明''' | ||
{| | {| | ||
|- | |- | ||
− | !width="80" | 参数名 | + | ! width="80" | 参数名 |
− | !width="80" | 必选 | + | ! width="80" | 必选 |
− | !width="80" | 默认值 | + | ! width="80" | 默认值 |
− | !width="180" | 描述 | + | ! width="180" | 描述 |
|- | |- | ||
− | |ak | + | | ak |
− | |是 | + | | 是 |
− | |无 | + | | 无 |
− | | | + | | 用户的访问密钥。只支持浏览器端ak和Android/IOS SDK的ak,服务端ak不支持sn校验方式。 |
|- | |- | ||
− | |mcode | + | | mcode |
− | |否 | + | | 否 |
− | |无 | + | | 无 |
− | |安全码。若为Android/IOS SDK的ak, 该参数必需。 | + | | 安全码。若为Android/IOS SDK的ak, 该参数必需。 |
|- | |- | ||
− | |width | + | | width |
− | |否 | + | | 否 |
− | |400 | + | | 400 |
− | |图片宽度,范围[10,1024] | + | | 图片宽度,范围[10,1024] |
|- | |- | ||
− | |height | + | | height |
− | |否 | + | | 否 |
− | |300 | + | | 300 |
− | |图片高度,范围[10,512] | + | | 图片高度,范围[10,512] |
|- | |- | ||
− | |location | + | | location |
− | |是 | + | | 是 |
− | |无 | + | | 无 |
− | |全景位置点坐标。坐标格式:lng | + | | 全景位置点坐标。坐标格式:lng<经度>,lat<纬度>,例如116.313393,40.047783。 |
|- | |- | ||
− | |coordtype | + | | coordtype |
− | |否 | + | | 否 |
− | |bd09ll | + | | bd09ll |
− | |全景位置点的坐标类型,目前支持bd09ll(百度坐标),wgs84ll(GPS坐标)和gcj02(google,高德,soso坐标)。 | + | | 全景位置点的坐标类型,目前支持bd09ll(百度坐标),wgs84ll(GPS坐标)和gcj02(google,高德,soso坐标)。 |
|- | |- | ||
− | |poiid | + | | poiid |
− | |是 | + | | 是 |
− | |无 | + | | 无 |
− | |poi的id,该属性通常通过place api接口获取,poiid与panoid、location一起设置全景的显示场景,优先级为:poiid>panoid>location。其中根据poiid获取的全景视角最佳。 | + | | poi的id,该属性通常通过place api接口获取,poiid与panoid、location一起设置全景的显示场景,优先级为:poiid>panoid>location。其中根据poiid获取的全景视角最佳。 |
|- | |- | ||
− | |panoid | + | | panoid |
− | |是 | + | | 是 |
− | |无 | + | | 无 |
− | |全景图id,panoid与poiid、location一起设置全景的显示场景,优先级为:poiid>panoid>location。 | + | | 全景图id,panoid与poiid、location一起设置全景的显示场景,优先级为:poiid>panoid>location。 |
|- | |- | ||
− | |heading | + | | heading |
− | |否 | + | | 否 |
− | |0 | + | | 0 |
− | |水平视角,范围[0,360] | + | | 水平视角,范围[0,360] |
|- | |- | ||
− | |pitch | + | | pitch |
− | |否 | + | | 否 |
− | |0 | + | | 0 |
− | |垂直视角,范围[0,90]。 | + | | 垂直视角,范围[0,90]。 |
|- | |- | ||
− | |fov | + | | fov |
− | |否 | + | | 否 |
− | |90 | + | | 90 |
− | |水平方向范围,范围[10,360],fov=360即可显示整幅全景图 | + | | 水平方向范围,范围[10,360],fov=360即可显示整幅全景图 |
|} | |} | ||
− | + | '''{{bluepoint}}返回码说明''' | |
{| | {| | ||
|- | |- | ||
− | !width="180" | 状态码 | + | ! width="180" | 状态码 |
− | !width="180" | 含义 | + | ! width="180" | 含义 |
|- | |- | ||
− | |0 | + | | 0 |
− | |正常 | + | | 正常 |
|- | |- | ||
− | |507 | + | | 507 |
− | |coordtype赋值错误,目前只支持bd09ll,wgs84ll | + | | coordtype赋值错误,目前只支持bd09ll,wgs84ll |
|- | |- | ||
− | |509 | + | | 509 |
− | |ak为必选参数,没有加ak时返回错误。其他ak验证码,请 查看 | + | | ak为必选参数,没有加ak时返回错误。其他ak验证码,请 查看 |
|- | |- | ||
− | |508 | + | | 508 |
− | |请求ak验证服务失败 | + | | 请求ak验证服务失败 |
|- | |- | ||
− | |302 | + | | 302 |
− | |坐标的格式不对,经纬度应该以逗号分隔 | + | | 坐标的格式不对,经纬度应该以逗号分隔 |
|- | |- | ||
− | |303 | + | | 303 |
− | |百度经纬度坐标转换为百度墨卡托坐标错误 | + | | 百度经纬度坐标转换为百度墨卡托坐标错误 |
|- | |- | ||
− | |304 | + | | 304 |
− | |wgs84经纬度坐标转换为百度墨卡托坐标错误 | + | | wgs84经纬度坐标转换为百度墨卡托坐标错误 |
|- | |- | ||
− | |402 | + | | 402 |
− | |请求坐标转panoid服务,返回错误,可能是该点没有panoid | + | | 请求坐标转panoid服务,返回错误,可能是该点没有panoid |
|- | |- | ||
− | |401 | + | | 401 |
− | |请求坐标转panoid服务失败 | + | | 请求坐标转panoid服务失败 |
|- | |- | ||
− | |403 | + | | 403 |
− | |没有panoid 和 location 参数 | + | | 没有panoid 和 location 参数 |
|- | |- | ||
− | |404 | + | | 404 |
− | |根据poi id获取pano id服务请求失败 | + | | 根据poi id获取pano id服务请求失败 |
|- | |- | ||
− | |405 | + | | 405 |
− | |根据poi id获取pano id服务返回无效的pano id | + | | 根据poi id获取pano id服务返回无效的pano id |
|- | |- | ||
− | |501 | + | | 501 |
− | |超出了width的范围 | + | | 超出了width的范围 |
|- | |- | ||
− | |502 | + | | 502 |
− | |超出了height的范围 | + | | 超出了height的范围 |
|- | |- | ||
− | |503 | + | | 503 |
− | |超出了heading 的范围 | + | | 超出了heading 的范围 |
|- | |- | ||
− | |506 | + | | 506 |
− | |超出了fov的范围 | + | | 超出了fov的范围 |
|- | |- | ||
− | |601 | + | | 601 |
− | |请求街景服务失败 | + | | 请求街景服务失败 |
|} | |} | ||
查看更多[http://developer.baidu.com/map/index.php?title=webapi/errorcode 控制服务返回码定义] | 查看更多[http://developer.baidu.com/map/index.php?title=webapi/errorcode 控制服务返回码定义] | ||
+ | </div><!--内容3--><div class="navRemark"><div class="handpointto">内容(使用指南)</div></div><div class="txtstyle2"><div class="bluetitle"><div class="services-title-text">使用方法</div></div><div class="useguide"><div class="useguide_bg"></div><div class="useguide_li"> | ||
+ | <span>1</span> | ||
+ | |||
+ | [http://passport.baidu.com 申请百度账号用户] | ||
+ | </div><div class="useguide_li"> | ||
+ | <span>2</span> | ||
+ | |||
+ | [http://lbsyun.baidu.com/apiconsole/key 申请成为百度地图开发者] | ||
+ | </div><div class="useguide_li"> | ||
+ | <span>3</span> | ||
+ | |||
+ | [http://lbsyun.baidu.com/apiconsole/key/create 获取服务密钥(ak)] | ||
+ | </div><div class="useguide_li"> | ||
+ | <span>4</span> | ||
+ | |||
+ | [http://lbsyun.baidu.com/index.php?title=viewstatic 发送请求,使用服务] | ||
+ | </div></div><div class="bluetitle"><div class="services-title-text">坐标系说明</div></div><div class="serve-explain-text"> | ||
+ | {{bluepoint}}WGS84:为一种大地坐标系,也是目前广泛使用的GPS全球卫星定位系统使用的坐标系。 | ||
+ | |||
+ | {{bluepoint}}GCJ02:是由中国国家测绘局制订的地理信息系统的坐标系统。由WGS84坐标系经加密后的坐标系。 | ||
+ | |||
+ | {{bluepoint}}BD09:为百度坐标系,在GCJ02坐标系基础上再次加密。其中bd09ll表示百度经纬度坐标,bd09mc表示百度墨卡托米制坐标 | ||
+ | |||
+ | {{bluepoint}}<span style="color:#FF0000;">全景静态图 API v2.0的输入参数支持以上三种坐标系,开发者无需进行任何坐标转换,通过请求参数"coordtype"指明所使用的坐标系即可。</span> | ||
+ | </div><div class="bluetitle"><div class="services-title-text">服务配额</div></div><div class="serve-explain-text"> | ||
+ | {{bluepoint}}每个ak可每天最多可调用10万次该服务。 | ||
+ | |||
+ | {{bluepoint}}每个开发者账号每天调用“全景静态图”API 服务的总次数(即配额)是有限的。 | ||
+ | |||
+ | {{bluepoint}}每个开发者账号每天调用“全景静态图”API 服务的总次数(即并发量)是有限的。 | ||
+ | |||
+ | {{bluepoint}}若需要更高配额和并发量,请[http://lbsyun.baidu.com/apiconsole/auth 申请开发者认证]以获取更高配额和更及时的技术支持(若已认证,请通过[http://lbsyun.baidu.com/apiconsole/quota API控制台-我的服务]自行申请配额)。 | ||
+ | |||
+ | {{bluepoint}}同一个账号下的HTTP/HTTPS请求,配额,并发共享。 | ||
+ | |||
+ | '''配额及默认并发量说明如下''' | ||
+ | <div class="tablecenter"> | ||
+ | {| | ||
+ | |- | ||
+ | ! width="220" | 分类 | ||
+ | ! width="270" | 未认证 | ||
+ | ! width="220" | 个人认证 | ||
+ | ! width="270" | 企业认证 | ||
+ | |- | ||
+ | | 日配额(次) | ||
+ | | 2,000 | ||
+ | | 30,000 | ||
+ | | 300,000 | ||
+ | |- | ||
+ | | 分钟并发数(次/分钟) | ||
+ | | 1,200 | ||
+ | | 3,000 | ||
+ | | 12,000 | ||
+ | |} | ||
+ | </div></div><div class="bluetitle"><div class="services-title-text">编码说明</div></div><div class="serve-explain-text"> | ||
+ | API请求中需要用到中文或一些特殊字符的参数,如query、region等,为了避免提交到后台乱码,需要对这几个参数值进行编码处理,转换成UTF-8字符的二字符十六进制值,凡是不在下表中的字符都需要进行编码。 | ||
+ | |||
+ | {| border="1" cellspacing="1" cellpadding="1" | ||
+ | |- | ||
+ | | '''字符集合''' | ||
+ | | '''字符''' | ||
+ | |- | ||
+ | | URL非保留字<br/> | ||
+ | | 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 - _ . ~<br/> | ||
+ | |- | ||
+ | | URL保留字<br/> | ||
+ | | ! * ' ( ) ; : @ & = + $ , / ? % # [ ]<br/> | ||
+ | |} | ||
+ | |||
+ | 如果中文参数中使用URL保留字字符的字面意思,例如:region关键字取值为"?北京",检索关键字包含一个问号,此问号也必须进行编码。 | ||
+ | |||
+ | '''附注:''' | ||
+ | |||
+ | {{bluepoint}}javascript中一般采用encodeURIComponent函数对特殊字符进行编码。 | ||
+ | |||
+ | {{bluepoint}}Java中可以使用函数URLEncoder.encode对特殊字符进行编码。 | ||
+ | |||
+ | {{bluepoint}}C#中可以使用函数HttpUtility.UrlEncode对特殊字符进行编码。 | ||
+ | |||
+ | {{bluepoint}}php中可以使用函数urlencode对特殊字符进行编码。 | ||
+ | </div></div></div> |
2017年10月26日 (四) 07:24的版本
百度地图全景静态图API与静态图API类似,可轻松实现将全景地图以图片形式嵌入到您的应用中。您只需要设置图片尺寸、经纬度坐标等参数,发送HTTP请求访问百度地图全景静态图服务,便可在您的PC浏览器、手机浏览器、移动APP或者车机显示屏中以图片形式显示您的全景图。
以下为您展示百度奎科科技大厦周边点的全景图示例。 请求示例:
http://api.map.baidu.com/panorama/v2?ak=E4805d16520de693a3fe707cdc962045&width=512&height=256&location=116.313393,40.04778&fov=180//请将AK替换为您的AK
结果如下图所示:
该套API免费对外开放,使用前请先申请密钥。
注意:申请密钥时,请选择ak的应用类型为 “for server”。
您在使用百度地图Web服务 API之前,请先阅读百度地图API使用条款。任何非营利性应用请直接使用,商业应用请参考使用须知。
使用场景
使用全景静态图接口,可获取图片形式的全景图,并支持将图片嵌入到PC浏览器、手机浏览器、移动APP、车机显示屏等多种场景的应用中。
服务参数列表
http://api.map.baidu.com/panorama/v2
组成说明:
域名:api.map.baidu.com
服务名:panorama
版本号:v2
ak: 该套API免费对外开放,使用前请先申请密钥。申请密钥时,请选择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:为一种大地坐标系,也是目前广泛使用的GPS全球卫星定位系统使用的坐标系。
GCJ02:是由中国国家测绘局制订的地理信息系统的坐标系统。由WGS84坐标系经加密后的坐标系。
BD09:为百度坐标系,在GCJ02坐标系基础上再次加密。其中bd09ll表示百度经纬度坐标,bd09mc表示百度墨卡托米制坐标
全景静态图 API v2.0的输入参数支持以上三种坐标系,开发者无需进行任何坐标转换,通过请求参数"coordtype"指明所使用的坐标系即可。
每个ak可每天最多可调用10万次该服务。
每个开发者账号每天调用“全景静态图”API 服务的总次数(即配额)是有限的。
每个开发者账号每天调用“全景静态图”API 服务的总次数(即并发量)是有限的。
若需要更高配额和并发量,请申请开发者认证以获取更高配额和更及时的技术支持(若已认证,请通过API控制台-我的服务自行申请配额)。
同一个账号下的HTTP/HTTPS请求,配额,并发共享。
配额及默认并发量说明如下
分类 | 未认证 | 个人认证 | 企业认证 |
---|---|---|---|
日配额(次) | 2,000 | 30,000 | 300,000 |
分钟并发数(次/分钟) | 1,200 | 3,000 | 12,000 |
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对特殊字符进行编码。