html5 百度地图api文档,开发指南--百度地图JavaScript API大众版.doc

开发指南--百度地图JavaScriptAPI大众版开发指南--百度地图JavaScriptAPI大众版

简介 JavaScript API大众版

JavaScript API功能介绍

百度地图JavaScript API是一套由JavaScript语言编写的应用程序接口，它能够帮助您在网站中构建功能丰富、交互性强的地图应用，包含了构建地图基本功能的各种接口，提供了诸如本地搜索、路线规划等数据服务。 基本地图功能：展示(支持2D图、3D图、卫星图)、平移、缩放、拖拽等。 地图控件展示功能：可以在地图上添加/删除鹰眼、工具条、比例尺、自定义版权、地图类型及定位控件，并可以设置各类控件的显示位置。 覆盖物功能：支持在地图上添加/删除点、线、面、热区、行政区划、用户自定义覆盖物等；开源库提供富标注、标注管理器、聚合marker、自定义覆盖物等功能。 工具类功能：提供经纬度坐标与屏幕坐标互转功能；开源库里提供测距、几何运算及GPS坐标/国测局坐标转百度坐标等功能。 定位功能：支持IP定位及浏览器(支持html5特性浏览器)定位功能。 右键菜单功能：支持在地图上添加右键菜单。 鼠标交互功能：支持动态修改鼠标样式、鼠标拖拽/缩放地图及鼠标绘制等功能。 图层功能：支持重设地图底图、地图上叠加实时交通图层或自定义图层功能。 本地搜索功能：包括根据城市、矩形范围、圆形范围等条件进行POI搜索；且支持用户自有数据的检索。 公交检索：支持起始点坐标、起始点名称、LocalSearchPoi实例三种检索条件的检索；检索结果支持便捷、可换乘、少步行、不乘地铁四种方案。 驾车检索：支持起始点坐标、起始点名称、LocalSearchPoi实例三种检索条件的检索；返回最短时间、最短距离、避开高速的驾车导航结果；且提供计算打车费用服务。 步行导航：提供步行导航方案。 逆/地理编码：支持百度坐标与地址描述信息之间的转换服务。 个性化数据展示功能：用户自有数据存储到LBS.云后，JavaScript API可以提供以麻点图形式展示自有数据功能。 面向的读者

API是提供给那些具有一定JavaScript编程经验和了解面向对象概念的读者使用。此外，读者还应该对地图产品有一定的了解。 您在使用中遇到任何问题，都可以通过API论坛反馈给我们。 坐标转换

国际经纬度坐标标准为WGS-84,国内必须至少使用国测局制定的GCJ-02,对地理位置进行首次加密。百度坐标在此基础上，进行了BD-09二次加密措施,更加保护了个人隐私。百度对外接口的坐标系并不是GPS采集的真实经纬度，需要通过坐标转换接口进行转换。 坐标转换、批量坐标转换示例详见JavaScript API示例【地图示例_坐标换算】。 版本说明及申请API ak

为了统一平台服务的配额管理，JavaScript API在新版本引入ak机制。JavaScript API v1.4及以前版本无须申请密钥(ak)，自v1.5版本开始需要先申请密钥(ak)，才可使用，超出ak配额部分，可以进行申请。 地址： /api?v=1.4 //参数v表示您加载API的版本，使用JavaScript APIv1.4及以前版本可使用此方式引用。

/api?v=1.5&ak=您的密钥 //使用JavaScript APIv1.5请先申请密钥ak，按此方式引用。

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

验证失败的可能原因包括： 尚未在API控制台申请ak，即'...ak='; 密钥设置错误，如E4805d16520de693a3fe707cdc962045为正确的ak，但是设置时输入的ak为E4805d16520de693a3fe707cdc962045xx; 密钥未通过白名单，如下图的ak在非域名下会报错。

API控制台关闭JavaScript API时会报错;

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

自JS APIv1.5之后，您需要首先申请密钥(ak)，才可成功加载API JS文件。ak的使用方法如下：

其中参数v为API当前的版本号，目前最新版本为1.5。在1.2版本之前您还可以设置services参数，以告知API是否加载服务部分，true表示加载，false表示不加载，默认为true。 地图API是由JavaScript语言编写的，您在使用之前需要通过