简介
什么是百度地图API?
百度地图API是一套由JavaScript语言编写的应用程序接口,它能够帮助您在网站中构建功能丰富、交互性强的地图应用。百度地图API包含了构建地图基本功能的各种接口,提供了诸如本地搜索、路线规划等数据服务。
面向的读者
API是提供给那些具有一定JavaScript编程经验和了解面向对象概念的读者使用。此外,读者还应该对地图产品有一定的了解。
您在使用中遇到任何问题,都可以通过API贴吧或交流群反馈给我们。
坐标转换
国际经纬度坐标标准为WGS-84,国内必须至少使用国测局制定的GCJ-02,对地理位置进行首次加密。百度坐标在此基础上,进行了BD-09二次加密措施,更加保护了个人隐私。百度对外接口的坐标系并不是GPS采集的真实经纬度,需要通过坐标转换接口进行转换。
坐标转换、批量坐标转换示例详见JavaScript API示例【地图示例_坐标换算】。
获取API
地图API是由JavaScript语言编写的,您在使用之前需要通过<script>标签将API引用到页面中:
-
其中参数v为API当前的版本号,目前最新版本为1.4。在1.2版本之前您还可以设置services参数,以告知API是否加载服务部分,true表示加载,false表示不加载,默认为true。
开发移动平台上的地图应用
API自1.1版本起开始支持iPhone、Android这样的移动平台。用户通过手机浏览器就可以访问由地图API创建出来的应用。移动平台的屏幕尺寸通常比PC或笔记本要小,操作方式也有所不同。为了更好的在手机浏览器上展示地图,我们有如下建议:
- 将地图容器高设置为100%,使其充满整个屏幕,或者您也可以计算浏览器窗口的大小并进行设置。
- 添加下面的meta标签: <meta name="viewport" content="initial-scale=1.0, user-scalable=no" /> 这样做是为了让页面以正常比例进行显示并且禁止用户缩放页面的操作。
您可以参考 Apple's Developer documentation 和 Android documentation 获得更多信息。
移动端开发具体实现请参考相关下载_示例代码提供的Demo源码。
异步加载
API 1.1,1.2,1.3和1.4版本支持异步加载,您可以在引用脚本的时候添加callback参数,当脚本加载完成后callback函数会被立刻调用。请参考下面的使用示例:
-
<!DOCTYPE html>
-
<html>
-
<head>
-
<meta charset="utf-8"/>
-
-
<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 = "http://api.map.baidu.com/api?v=1.4
&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
版本说明
地址 http://api.map.baidu.com/api?v=1.4中的参数v表示您加载API的版本,例如当前API的最新版本为1.4,则您可在地址中添加 v=1.4。当API升级后,如果已有接口在使用、命名等方面发生了变化,我们会为其增加一个新的版本号,这不会对您现有的应用造成任何影响。如果升级只是修复一些bug或者在不影响现有功能的前提下增加接口、改善性能,则版本号不会发生变化。您可以在更新日志页面查看版本的变化。
问题解答
如果您在使用百度地图API中遇到问题,请尝试通过以下途径解决: