浏览器版本低!无法浏览完整内容,建议升级或更换浏览器。

文档全面上新

更科技的视觉体验,更高效的页面结构,快前往体验吧!

体验新版
(Lbsyun移动dev/viewstatic页面至viewstatic
 
(未显示1个用户的37个中间版本)
第1行: 第1行:
{{viewstatic-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可轻松实现将全景地图以图片形式嵌入到开发者的应用中。
 +
<div class="bluetitle"><div class="services-title-text">功能介绍</div></div>
 +
开发者只需要设置图片尺寸、经纬度坐标等参数,发送HTTP请求访问百度地图全景静态图服务,便可在PC浏览器、手机浏览器、移动APP或者车机显示屏中以图片形式展示全景图。<br/><br/><span style="color:#FF0000;">注:本服务属于高级权限,需付费开通,您可以[https://lbs.baidu.com/apiconsole/fankui#?typeOne=产品需求&typeTwo=高级服务&typeThree=全景静态图API 联系我们]开通15天试用并了解更多信息。</span>
 +
<div class="bluetitle"><div class="services-title-text">请求示例</div></div>
 +
以下为奎科科技大厦周边点全景图请求示例:
 +
<div class="code-template"><pre class="get-url-pre">https://api.map.baidu.com/panorama/v2?ak=您的密钥&width=512&height=256&location=116.313393,40.04778&fov=180 
 +
</pre>
 +
//GET请求</div>
 +
https://mapopen-website-wiki.cdn.bcebos.com/products/viewstaticv2.jpeg
  
    <h1>全景静态图API</h1>
+
 
    <p>百度地图全景静态图API与静态图API类似,可轻松实现将全景地图以图片形式嵌入到您的应用中。您只需要设置图片尺寸、经纬度坐标等参数,发送HTTP请求访问百度地图全景静态图服务,便可在您的PC浏览器、手机浏览器、移动APP或者车机显示屏中以图片形式显示您的全景图。 </p>
+
</div><!--内容2--><div class="navRemark"><div class="handpointto">内容(服务文档)</div></div><div class="txtstyle2"><div class="bluetitle"><div class="services-title-text">服务文档</div></div>
    <p>该套API免费对外开放,使用前请先[http://lbsyun.baidu.com/apiconsole/key 申请密钥]。注意:申请密钥时,请选择AK的应用类型为 “for server”。</p>
+
'''{{bluepoint}}使用场景'''
    <p>您在使用百度地图Web服务 API之前,请先阅读[[:question/law|百度地图API使用条款]]。任何非营利性应用请直接使用,商业应用请参考[[:question#qa0013|使用须知]]。</p>
+
 
    <h2 id="column2">功能示例</h2>
+
使用全景静态图接口,可获取图片形式的全景图,并支持将图片嵌入到PC浏览器、手机浏览器、移动APP、车机显示屏等多种场景的应用中。
    <p>以下为您展示百度奎科科技大厦周边点的全景图示例。</p>
+
 
    <p><b>请求示例:</b></p>
+
'''{{bluepoint}}服务参数列表'''
    <anchor  url='http://api.map.baidu.com/panorama?width=512&height=256&location=116.313393,40.04778&fov=180&ak=E4805d16520de693a3fe707cdc962045' target='_blank'>http://api.map.baidu.com/panorama?width=512&height=256&location=116.313393,40.04778&fov=180&<br>ak=E4805d16520de693a3fe707cdc962045</anchor>  
+
<div class="code-template"><pre class="get-url-pre">https://api.map.baidu.com/panorama/v2 //GET请求
    <p><b>返回结果如下图所示:</b></p>
+
</pre>
    <p class="tl-c">
+
</div>
http://developer.baidu.com/map/static/img/viewstatic.png
+
'''{{bluepoint}}组成说明:'''
    </p>
+
 
    <p><b>扫描二维码查看手机端效果:</b></p>
+
域名:api.map.baidu.com
    <p class="tl-c">
+
 
http://developer.baidu.com/map/static/img/viewstaticcode.png</p>
+
服务名:panorama
 +
 
 +
版本号:v2
 +
 
 +
ak: 使用前请先申请密钥,申请密钥时,请选择ak的应用类型为 “for server”。
 +
 
 +
'''{{bluepoint}}服务参数说明'''
 +
 
 +
{|
 +
|-
 +
! width="80" | 参数名
 +
! width="80" | 必选
 +
! width="80" | 默认值
 +
! width="180" | 描述
 +
|-
 +
| ak
 +
| 是
 +
| 无
 +
| 用户的访问密钥。只支持浏览器端ak和Android/IOS SDK的ak,服务端ak不支持sn校验方式。
 +
|-
 +
| mcode
 +
| 否
 +
| 无
 +
| 安全码。若为Android/IOS SDK的ak, 该参数必需。
 +
|-
 +
| width
 +
| 否
 +
| 400
 +
| 图片宽度,范围[10,1024]
 +
|-
 +
| height
 +
| 否
 +
| 300
 +
| 图片高度,范围[10,512]
 +
|-
 +
| location
 +
| 是
 +
| 无
 +
| 全景位置点坐标。坐标格式:lng&lt;经度&gt;,lat&lt;纬度&gt;,例如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即可显示整幅全景图
 +
|}
 +
 
 +
'''{{bluepoint}}返回码说明'''
 +
 
 +
{|
 +
|-
 +
! width="180" | 状态码
 +
! width="180" | 含义
 +
|-
 +
| 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
 +
| 请求街景服务失败
 +
|}
 +
 
 +
查看更多[http://lbsyun.baidu.com/index.php?title=webapi/appendix 控制服务返回码定义]
 +
</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:为一种大地坐标系,也是目前广泛使用的全球卫星定位系统使用的坐标系。
 +
 
 +
{{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}}服务相关配额及并发请求限制请访问[http://lbsyun.baidu.com/apiconsole/auth/privilege 开发者权益]页面查看。
 +
</div><div class="serve-explain-text">
 +
<br/><span style="font-size:larger;"><span style="color:#000000;">编码说明</span></span><br/><br/>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/>
 +
| &nbsp;! * ' ( )&nbsp;;&nbsp;: @ & = + $ , /&nbsp;?&nbsp;% # [ ]<br/>
 +
|}
 +
 
 +
如果中文参数中使用URL保留字字符的字面意思,例如:region关键字取值为"?北京",检索关键字包含一个问号,此问号也必须进行编码。
 +
 
 +
'''附注:'''
 +
 
 +
{{bluepoint}}javascript中一般采用encodeURIComponent函数对特殊字符进行编码。
 +
 
 +
{{bluepoint}}Java中可以使用函数URLEncoder.encode对特殊字符进行编码。
 +
 
 +
{{bluepoint}}C#中可以使用函数HttpUtility.UrlEncode对特殊字符进行编码。
 +
 
 +
{{bluepoint}}php中可以使用函数urlencode对特殊字符进行编码。
 +
</div></div></div>

2022年9月7日 (三) 19:59的最后版本

功能介绍
服务文档
使用指南
全景静态图

百度地图全景静态图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请求

viewstaticv2.jpeg


服务文档

使用场景

使用全景静态图接口,可获取图片形式的全景图,并支持将图片嵌入到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对特殊字符进行编码。

  • 文档根本没法用

  • 文档水平很差

  • 文档水平一般

  • 文档不错

  • 文档写的很好

如发现文档错误,或对此文档有更好的建议,请在下方反馈。问题咨询请前往反馈平台提交工单咨询。

提交反馈

拖动标注工具

添加矩形标注

添加箭头标注

完成

取消