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

JavaScript API

百度地图JavaScript API是一套由JavaScript语言编写的应用程序接口,可帮助您在网站中构建功能丰富、交互性强的地图应用,支持PC端和移动端基于浏览器的地图应用开发,且支持HTML5特性的地图开发。免费对广大用户开放。

服务常见问题
1、为什么总是弹出报错“百度未授权使用地图API”?

当权限验证(ak)失败时,会报如下错误:
js-ak-failure.jpg
发生该问题时,请参考如下解决办法:

1. 请确认已在API控制台申请ak,即'...ak='。

2. 请确认密钥设置正确。如E4805d16520de693a3fe707cdc962045为正确的ak,但是设置时输入的ak为E4805d16520de693a3fe707cdc962045xx。

3. 请确认密钥设置时的白名单正确。如下图,该ak在非baidu.com域名下会报错。
js_ak_refer.png

4. 请确认中API控制台密钥设置页面中JavaScript API选项为开启状态。如关闭,则在使用时会报错。

ak_no_click.jpg

5. 请确认使用的ak类型为“浏览器端”,JS API只支持浏览器类型的ak(自2016年1月15日升级)。

2、API升级,会不会影响我的使用?

当API升级后,如果已有接口在使用、命名等方面发生了变化,我们会为其增加一个新的版本号,这不会对您现有的应用造成任何影响。如果升级只是修复一些bug或者在不影响现有功能的前提下增加接口、改善性能,则版本号不会发生变化。您可以在更新日志页面查看版本的变化。

3、申请密钥(ak)时,应用类型有“浏览器端”和“服务端”,有什么区别?

因新系统升级,新建“服务端AK”不再支持浏览器端使用;在浏览器端使用,请选择“浏览器端AK”,例如JavaScript API只支持浏览器类型AK。 对于以前申请的服务端AK,不变更即不受影响,仍支持浏览器端使用;如更新老的服务端AK,再次保存,则按新创建AK处理,不再支持浏览器端使用。

4、JavaScript API是否支持HTTPS请求?

JavaScript API V2.0 及以上版本支持HTTPS。

如果想使用HTTPS协议调用JavaScript API,直接将脚本引用的协议修改为HTTPS即可。

<script type="text/javascript" src="https://api.map.baidu.com/api?v=2.0&ak=您的密钥"></script>
<script type="text/javascript" src="https://api.map.baidu.com/api?v=3.0&ak=您的密钥"></script>
5、必须申请ak吗?

当前版本服务必须申请ak。

6、使用用户数据图层服务,数据必须要存到LBS云吗?百度会收录用户存储的数据吗?

若您需要展示和检索海量用户数据,必须先存入LBS.云。方法请参看开发指南—用户数据图层。百度不会收录用户存储的数据。

7、比例尺的一像素对应几米?

Math.pow(2, (18 - zoom)); //把地图级别带进去,就能得出各个级别下1px对应多少米。

8、如何搜索百度地图的数据?

百度地图API提供localsearch类,其中search、searchInBounds、searchNearby方法均为搜索函数。利用此类方法可以搜索到百度地图数据库中所有POI信息。

9、如何搜索用户自己数据库里的数据?

用户需要自己实现该类搜索逻辑。

点击查看后端搜索案例

10、如何解决标注数量庞大时,地图反映慢的问题?

标注数据量请控制在150个以内,以保持各个浏览器都能高性能地展示地图;标注数量在260以内,可以使用自定义覆盖物实现;标注数量大于300个,建议尝试marker聚合,或者数据抽稀。

Marker聚合:请点击这里查看

数据抽稀:比如有10个marker,选择其中6个做为显示点。

我们建议您不要一次在地图上添加过多的marker,而是先把point存储在数据库里,当需要显示某个marker是,再addOverlay。

11、百度地图API是否有访问频率的限制?

用户同时在线数:按每秒初始JS获取来计算,支持每秒1000~1500次;

检索服务支持800次/秒;

公交、驾车服务400~600次/秒;

地理编码性能支持200次/秒;

带宽限度:由于API数据量较小,完全支持服务;

坐标转换接口:单ip 50次/秒;(超过100次返回403错误)

静态图:独立IP 10个/秒。

12、如果地址解析失败了怎么办?

地址解析失败有如下三种可能:

A、用户未区分地址解析和智能搜索的概念

地址解析,即Geocoder类,是根据一个地址得到对应的经纬度point。注:地址需要详细到街道,例如“北京市海淀区中关村南大街”。

智能搜索,即localsearch类,可以根据任意关键词查询到对应的POI信息。关键词可以是“上海市麦当劳”“重庆市解放碑”,当没有城市信息时,默认在当前城市进行搜索。Localsearch类会根据关键词的内容,智能地搜索POI的title和content信息。比如,搜索“家乐福”时,也能搜索到家乐福附近的面馆,停车场等信息。

更多详细对比请查看示例

注:百度地图(map.baidu.com)的输入框,采取了先地址解析,如果失败就智能搜索的策略。并且对输入关键词做了切词的处理,能定位城市。所以,用户需要结合API的各个接口来编写地址搜索框的代码。

B、用户输入的地址不符合地址解析的规则

地址解析的规范为:省+城市+区县+街道 (可以不用门牌号)。例如,北京市北京市海淀区中关村南大街27号。如果输入“南京路工行”,则无法解析。

C、百度地图数据库里无该地址或用户输入的地址错误

13、如何更换marker的图标?

第一、只需改变icon的路径即可,类似银行标注。

第二、图片加上文字的图标,并且鼠标滑过时有动画,类似房产标注。

第三、可以利用label来模拟自定义覆盖物。详细请点击示例

14、如何清除地图上的覆盖物?

清除地图上所有的标记,用map.clearOverlays();

清除单个标注iMarker,用map.removeOverlay(iMarker);

显示和隐藏自定义覆盖物,可以继承overlay的hide();或者show()方法。

15、我采集到的GPS数据转换成百度坐标系后,偏差非常大。如何怎么解决?

有以下四种可能:

A、原始坐标可能不是GPS(即wgs84)的

解决方案:请确保采集到的数据时WGS84的标准。

B、原始坐标准确度不够

解决方案:请确保采集GPS数据时,搜到至少4颗以上的卫星。并且GPS数据准不准,还取决于周围建筑物的高度,越高越不准,因为有遮挡。

C、度分秒的概念混淆

比如,在google earth上采集到的是39°31'20.51,那么应该这样换算,31分就是31/60度,20.51秒就是20.51/3600度,结果就是39 + 31/60 + 20.51/3600 度。

D、经纬度顺序写反了

百度坐标是先经度,再纬度,即Point(lng, lat)。谷歌坐标的顺序恰好相反,是(lat, lng)。

16、如何通过经纬度查询到已加上的标注(Marker)?

Marker 是通过map.AddOverlay()加上的,所以也用map可以得到加上的所有Marker:

var mkrs = map.getOverlays();
for (var i=1; i < mkrs.length;i++) {
...
}

要注意的是,假如用BMapLib.MarkerTool加上3个Marker后,map中含有的marker数量为4,第一个(mkrs[0])应该是MarkerTool。所以遍历Marker要从1到length。

17、如何实现百度地图全屏按钮?

百度地图的全屏按钮是代码逻辑,不属于API范畴。你只需要在全屏时,改变地图容器的宽度和高度,缩小列表栏的宽度和高度即可。同时可以利用CSS将浏览器的滚动条去掉。

18、更多百度地图API问题

更多百度地图API使用须知、数据情况、坐标体系、反馈通道等问题详见百度地图API常见问题