当权限验证(ak)失败时，会报如下错误：

发生该问题时，请参考如下解决办法：

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

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

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

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

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

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

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

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>

使用服务必须申请ak。

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

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

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

点击查看后端搜索案例

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

Marker聚合：请点击这里查看

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

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

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

检索服务支持800次/秒；

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

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

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

坐标转换接口：单ip 50次/秒；（超过100次返回403错误）

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

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

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

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

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

更多详细对比请查看示例

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

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

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

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

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

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

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

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

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

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

有以下四种可能：

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)。

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。

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

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

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

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

监听移动事件，动态改变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()); 
    });

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

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