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

文档全面上新

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

体验新版
javascript API

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

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

1)请确认已在API控制台申请ak。

2)请确认密钥设置正确。

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 版本及以上、Lite版本 支持HTTPS。

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

<script type="text/javascript" src="https://api.map.baidu.com/api?v=2.0&ak=您的密钥"></script>

5、必须申请ak吗?

使用服务必须申请ak。

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

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

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

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

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

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

点击查看后端搜索案例

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

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

Marker聚合:请点击这里查看

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

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

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

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

检索服务支持800次/秒;

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

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

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

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

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

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

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

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

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

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

更多详细对比请查看示例

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

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

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

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


12、如何更换marker的图标?

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

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

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

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

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

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

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

14、我采集到的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)。

15、如何通过经纬度查询到已加上的标注(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。

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

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

17、JavaScript API定位精度是多少?

JSAPI提供的浏览器定位能力 本身是浏览器自身提供的,精度依赖浏览器自身特性,JSAPI在此基础上进行二次封装,方便开发者使用。 不论是使用定位控件进行定位,或是使用浏览器定位接口进行定位。因为目前浏览器H5定位功能的瓶颈限制,精度基本上是不可能到达GPS的级别的。同时精度也和使用的设备(PC或手机)和浏览器有关,常见的情况包括IE精准度比其他高,手机部分浏览器定位精度不准等。所以目前这个接口最低支持到城市级别的定位,最高的定位精度要取决于使用环境。

18、本地检索和地址解析的区别?

地址解析接口的目标是解析地址,通过地理关系推算而来,输入应为“地址信息”,如“北京市海淀区上地十街”,地址结构越标准,解析准确度越高,如“省+市+区+路+门牌”,如缺少某一层级地址,可能会有重名等情况无法准确解析 而“百度大厦”这类POI数据更适用于POI检索接口

19、同一个地址,为什么使用百度地图客户端能准确检索对应坐标,而正向地理编码服务却解析错误?

百度地图客户端针对poi的address数据进行检索,而正向地理编码则针对专业的「门址」数据进行解析,两份数据不同。

20、如何在地图移动时固定覆盖物marker在中心点不动呢?

监听移动事件,动态改变marker位置

    // 百度地图API功能
    var map = new BMap.Map("allmap");
    var point = new BMap.Point(116.404, 39.915);
    map.centerAndZoom(point, 15);
    var marker = new BMap.Marker(point);   // 创建标注
    map.addOverlay(marker);         // 将标注添加到地图中      
    map.addEventListener("ondragging", function (){ // 监听地图移动事件
    // 获取地图中心点并更新marker坐标
        marker.setPosition(map.getCenter()); 
    });

21、使用浏览器定位时,第一次定位比较准确,移动后重新获取定位为什么还是第一次定位的位置?

使用浏览器定位Geolocation方法时,默认会有十分钟的缓存,导致你短时间内拿到的定位结果相同,如果想要每次重新获取定位数据如下,设maximumAge的值为10就可以解决了。

    var geolocation = new BMap.Geolocation({
    maximumAge:10  // 清除缓存
    });


还是没有解决您的问题?请创建问题吧!

  • 文档根本没法用

  • 文档水平很差

  • 文档水平一般

  • 文档不错

  • 文档写的很好

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

提交反馈

拖动标注工具

添加矩形标注

添加箭头标注

完成

取消