百度地图API开发指南.pdf

Michael 简介 基础知识 控件 覆盖物 事件 地图图层 工具 服务 坐标转换 演示  百度地图API是一套由JavaScript 语言编写的应用程 序接口，它能够帮助您在网站中构建功能丰富、交 互性强的地图应用程序。  百度地图API不仅包含构建地图的基本功能接口， 还提供了诸如本地搜索、路线规划等数据服务。  通过地址 /api 加载 API ： ◦ script src=/api?key=您的API密 钥v=版本services=true 或者false type=text/javascript/script  其中参数key为密钥，参数v为当前API 的版本号， 目前最新版本为1.0，services参数表示是否加载 服务部分，true表示加载，false表示不加载。  地址 /api?v=1.0 中 的参数v表示您加载API 的版本，例如当前API 的最 新版本为1.0，则您可在地址中添加v=1.0 。当API 升级后，如果已有接口在使用、命名等方面发生了 变化，我们会为其增加一个新的版本号（比如 1.1），这不会对您现有的应用造成任何影响。如 果升级只是修改一些bug或者在不影响现有功能的 前提下增加接口，则版本号不会发生变化。  浏览器：IE 6.0+、Firefox 3.0+、Opera 9.0+、 Safari 3.0+、Chrome  操作系统：Windows 、Mac、Linux  一、引用百度地图API文件 ◦ 当您引用地图API文件时，需要使用自己申请的API密钥。 ◦ script type=text/javascript src=http://api.map.baidu.c om/api?key=46ce9d0614bf7aefe0ba562f8cf87194v=1.0 services=false/script •二、创建地图容器元素  div style=width:520px;height:340px;border:1px solid # 000 id=container/div  地图需要一个HTML元素作为容器，这样才能展现到页面上。这 里我们创建了一个div元素并制定它的大小地图会根据容器大小调 整自身尺寸。  三、命名空间 ◦ API使用BMap作为命名空间，所有类均在该命名空间之下，比如： BMap.Map、BMap.Control、BMap.Overlay。 •四、创建地图实例  var map = new BMap.Map(container);  位于BMap命名空间下的Map类表示地图，通过new操作符可以创 建一个地图实例。其参数可以是元素id也可以是元素对象。 注意在调用此构造函数时应确保容器元素已经添加到地图上。  五、创建点坐标 ◦ var point = new BMap.Point(116.404, 39.915); ◦ 这里我们使用BMap命名空间下的Point类来创建一个坐标 点。Point类描述了一个地理坐标点，其中116.404表示 经度，39.915表示纬度。 •六、地图初始化  map.centerAndZoom(point,15);  在创建地图实例后，我们需要对其进行初始化， BMap.Map.centerAndZoom()方法要求设置中心点坐标和地图级 别。 地图必须经过初始化才可以执行其他操作。  五、创建点坐标 ◦ var point = new BMap.Point(116.404, 39.915); ◦ 这里我们使用BMap命名空间下的Point类来创建一个坐标 点。Point类描述了一个地理坐标点，其中116.404表示 经度，39.915表示纬度。 •六、地图初始化  map.centerAndZoom(point,15);  在创建地图实例后，我们需要对其进行初始化， BMap.Map.centerAndZoom()方法要求设置中心点坐标和地图级 别。 地图必须经过初始化才可以执行其他操作。  百度地图上负责与地图交互