百度地图API开发指南
目录
简介_______________________________________________________________ 3
什么使百度地图API ______________________________________________________ 3面向的读者_____________________________________________________________ 3兼容性_________________________________________________________________ 3获取API ________________________________________________________________ 3开发移动平台上的地图应用_______________________________________________ 3版本说明_______________________________________________________________ 4基础知识___________________________________________________________ 4
百度地图的“Hello, World” ________________________________________________ 4准备页面 ______________________________________________________________________ 5引用百度地图API文件 __________________________________________________________ 5创建地图容器元素______________________________________________________________ 6命名空间 ______________________________________________________________________ 6创建地图实例
__________________________________________________________________ 6创建点坐标 ____________________________________________________________________ 6地图初始化 ____________________________________________________________________ 6
地图操作_______________________________________________________________ 6
控件_______________________________________________________________ 7地图控件概述___________________________________________________________ 7向地图添加控件_________________________________________________________ 7控制控件位置___________________________________________________________ 8修改控件配置___________________________________________________________ 8自定义控件_____________________________________________________________ 8覆盖物_____________________________________________________________ 9地图覆盖物概述_________________________________________________________ 9
标注__________________________________________________________________ 10定义标注图标 _________________________________________________________________ 10监听标注事件 _________________________________________________________________ 11可托拽的标注 ___
______________________________________________________________ 11内存释放 _____________________________________________________________________ 12
信息窗口______________________________________________________________ 12折线__________________________________________________________________ 12
自定义覆盖物__________________________________________________________ 13定义构造函数并继承Overlay ____________________________________________________ 13初始化自定义覆盖物___________________________________________________________ 13绘制覆盖物 ___________________________________________________________________ 14移除覆盖物 ___________________________________________________________________ 15显示和隐藏覆盖物_____________________________________________________________ 15自定义其他方法 _______________________________________________________________ 15添加覆盖物 ___________________________________________________________________ 16事件______________________________________________________________ 16地图事件概述__________________________________________________________ 16事件监听______________________________________________________________ 16事件参数和this _________________________________________________________ 17移除事件监听___________
_______________________________________________ 17地图图层__________________________________________________________ 18地图图层概念__________________________________________________________ 18自定义图层____________________________________________________________ 18工具______________________________________________________________ 18地图工具概述__________________________________________________________ 18向地图添加工具________________________________________________________ 19通过按钮控制工具的开启和关闭__________________________________________ 19拉框放大工具__________________________________________________________ 20服务______________________________________________________________ 20地图服务概述__________________________________________________________ 20本地搜索______________________________________________________________ 20配置搜索 _____________________________________________________________________ 21结果面板 _____________________________________________________________________ 21数据接口 _____________________________________________________________________ 21周边搜索 _____________________________________________________________________ 22范围搜索 _____________________________________________________________________ 23公交导航___
___________________________________________________________ 23结果面板 _____________________________________________________________________ 23数据接口 _____________________________________________________________________ 24驾车导航______________________________________________________________ 25结果面板 _____________________________________________________________________ 25数据接口 _____________________________________________________________________ 25地址解析______________________________________________________________ 26根据地址描述获得坐标_________________________________________________________ 26
反向地址解析 _________________________________________________________________ 27简介
什么使百度地图API
百度地图API是一套由JavaScript语言编写的应用程序接口,它能够帮助您在网站中构建功能丰富、交互性强的地图应用程序。
百度地图API不仅包含构建地图的基本功能接口,还提供了诸如本地搜索、路线规划等数据服务。
面向的读者
API是提供给那些具有一定JavaScript编程经验和了解面向对象概念的读者使用。此外,读者还应该对地图产品有一定的了解。
您可能对地图的内部处理逻辑不是很了解,百度地图API会尽量将复杂的底层逻辑进行隐藏和封装,以一种便于您理解的方式提供。
您在使用中遇到任何问题,都可以反馈给我们。
兼容性
浏览器:IE 6.0+、Firefox 3.0+、Opera 9.0+、Safari 3.0+、Chrome
操作系统:Windows、Mac、Linux
获取API
通过地址api.map.baidu/api加载API
<script src="api.map.baidu/api?v=版本&services=true或者false" type="text/javascript"></script>
参数v为当前API的版本号,目前最新版本为1.1,services参数表示是否加载服务部分,true表示加载,false表示不加载。
开发移动平台上的地图应用
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 获得更多信息版本说明
地址api.map.baidu/api?v=1.1 中的参数v表示您加载API的版本,例如当前API的最新版本为1.
1,则您可在地址中添加v=1.1。当API升级后,如果已有接口在使用、命名等方面发生了变化,我们会为其增加一个新的版本号,这不会对您现有的应用造成任何影响。如果升级只是修复一些bug或者在不影响现有功能的前提下增加接口、改善性能,则版本号不会发生变化。您可以在更新日志页面查看版本的变化
问题解答
如果您在使用百度地图API中遇到问题,请尝试通过以下途径解决:
确认您使用了正确的地图API密钥。
对于通过localhost或者文件方式调用API,不需要使用密钥。
访问百度地图API吧,查相关问题的帖子,或者将您的问题发布到贴吧中。基础知识
百度地图的“Hello, World”
开始学习百度地图API最简单的方式是看一个简单的示例。以下代码创建了一个地图并以天安门作为地图的中心:
1.<!DOCTYPE html>
2.<html>
3.<head>
4.<meta name="viewport"content="initial-scale=1.0, user-scalable=no"/>
5.<meta http-equiv="Content-Type"content="text/html; charset=utf-8"/>
6.<title>Hello, World</title>
7.<style type="text/css">
8.html{height:100%}
9.body{height:100%;margin:0px;padding:0px}
10.#container{height:100%}
11.</style>
12.<script type="text/javascript"src="api.map.baidu/api?key=46ce9d0
614bf7aefe0ba562f8cf87194&v=1.0&services=false"></script>
13.</head>
14.
15.<body>
16.<div id="container"></div>
17.<script type="text/javascript">
18.var map = new BMap.Map("container"); // 创建地图实例
19.var point = new BMap.Point(116.404, 39.915); // 创建点坐标
百度api接口AndZoom(point, 15); // 初始化地图,设置中心点坐标和地
图级别
21.</script>
22.</body>
23.</html>
下面我们分步向您介绍:
准备页面
根据HTML标准,每一份HTML文档都应该声明正确的文档类型,我们建议您使用最新的符合HTML5规范的文档声明:
1.<!DOCTYPE html>
您也可以根据需要选择其他类型的文档声明,这样浏览器会以标准的方式对页面进行渲染,保证页面最大的兼容性。我们不建议您使用quirks模式进行开发。下面我们添加一个meta标签,以便使您的页面更好的在移动平台上展示。
1.<meta name="viewport"content="initial-scale=1.0, user-scalable=no"/>
接着我们设置样式,使地图充满整个浏览器窗口:
1.<style type="text/css">
2.html{height:100%}
3.body{height:100%;margin:0px;padding:0px}
4.#container{height:100%}
5.</style>
引用百度地图API文件
当您引用地图API文件时,需要使用自己申请的API密钥。
1.<script type="text/javascript"src="api.map.baidu/api?key=46ce9d0
614bf7aefe0ba562f8cf87194&v=1.1&services=false"></script>
2.
版权声明:本站内容均来自互联网,仅供演示用,请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198,我们将在24小时内删除。
发表评论