使用须知 | JSAPI 3.0 | 百度地图开放平台文档中心

您当前查看的是 JSAPI 3.0 历史版本文档。该版本仅用于维护现有项目，不建议用于新项目开发。新项目请使用 JSAPI 4.0，如需升级现有项目，请参考升级指南。
You are viewing the legacy JSAPI 3.0 documentation. This version is maintained for existing projects only and is not recommended for new development. For new projects, use the JSAPI 4.0 documentation. If you are upgrading an existing project, please refer to the Migration Guide.

使用须知

JavaScript API v3.0 是在 v2.0 的基础上进行开发的，并针对2.0的一些接口进行了升级，为开发者提供更完善的服务。v3.0的绝大部分接口向下兼容，开发者仅需要修改版本参数（v=3.0）就可以切换到JavaScript API v3.0版本。具体版本差异请参考如下说明：

功能	接口	v2.0	v3.0
功能	接口	v2.0	v3.0
公交换乘规划	TransitRoute	支持市内换乘	支持跨城公交（飞机、火车、大巴）
定位	Geolocation	支持	定位策略优化
自定义绘制层	CanvasLayer	不支持	支持，可以自定义贴合底图的canvas和WebGL覆盖物
驾车线路规划	DrivingRoute	支持	暂不支持起终点为关键字、途径点
骑行线路规划	RidingRoute	不支持	支持

移动平台上的地图应用开发

JavaScript API支持iPhone、Android这样的移动平台。用户通过手机浏览器就可以访问由地图API创建出来的应用。移动平台的屏幕尺寸通常比PC或笔记本要小，操作方式也有所不同。为了更好的在手机浏览器上展示地图，我们有如下建议：

将地图容器高设置为100%，使其充满整个屏幕，或者您也可以计算浏览器窗口的大小并进行设置。
添加下面的meta标签： <meta name="viewport" content="initial-scale=1.0, user-scalable=no" /> 这样做是为了让页面以正常比例进行显示并且禁止用户缩放页面的操作。

您可以参考Apple's Developer documentation和Android documentation获得更多信息。
移动端开发具体实现请参考相关下载_示例代码提供的Demo源码。

异步加载

JavaScript API支持异步加载，您可以在引用脚本的时候添加callback参数，当脚本加载完成后callback函数会被立刻调用。请参考下面的使用示例：


<!DOCTYPE html>
<html>
    <head>
        <meta charset="utf-8"/>
        <title>异步加载</title>
        <script type="text/javascript">
            function initialize() {
                var mp = new BMap.Map('map');
                mp.centerAndZoom(new BMap.Point(121.491,31.233), 11);
            }
            function loadScript() {
                var script = document.createElement("script");
                script.src ="https://api.map.baidu.com/api?v=2.0&ak=您的密钥&callback=initialize";
                document.body.appendChild(script);
            }
            window.onload = loadScript;
        </script>
    </head>
    <body></body>
</html>

兼容性

浏览器：IE 6.0+、Firefox 3.6+、Opera 9.0+、Safari 3.0+、Chrome
操作系统：Windows、Mac、Linux
移动平台：iPhone、Android

获取技术支持途径

如果您在使用百度地图API中遇到问题，请尝试通过以下途径解决：

确认您使用了正确的地图API地址。
访问百度地图API论坛，查找相关问题的帖子，或者将您的问题发布到贴吧中。
查看常见问题。

账号和获取密钥

Hello World

本篇文章对您是否有帮助？