浏览器版本低!无法浏览完整内容,建议升级或更换浏览器。

文档全面上新

更科技的视觉体验,更高效的页面结构,快前往体验吧!

体验新版
适用环境

移动应用、浏览器端应用均可调起Android版百度地图。

移动应用调用百度地图

该调用方式是指第三方基于Android SDK进行应用开发时要调用Android版百度地图客户端需遵守的协议。该协议要正确执行除了要参数填写正确外,还必须要安装Android百度地图。

详细目录
1 接口通用说明
  1.1 实现原理
  1.2 使用方法
2 接口说明
  2.1 通用参数
  2.2 图区功能
    2.2.1 展示地图
    2.2.2 自定义打点
    2.2.3 展示地图图区
    2.2.4 地址解析
    2.2.5 反向地址解析
  2.3 搜索功能
    2.3.1 POI搜索
    2.3.2 路线规划
    2.3.3 公交、地铁路线查询
    2.3.4 附近搜索
  2.4 导航
    2.4.1 驾车导航
    2.4.2 骑行导航
    2.4.3 步行导航
    2.4.4 导航到家(公司)(map9.5.5以上版本支持)
  2.5 信息显示
    2.5.1 POI详情显示
    2.5.2 离线导航包
    2.5.3 路线(出行)页面调起协议
    2.5.4 出行早知道
    2.5.5 行程助手
    2.5.6 实时公交页面(map9.5.5以上版本支持)
    2.5.7 离线地图下载页面(map9.5.5以上版本支持)
    2.5.8 实时汇率页面
    ​2.5.9 实时翻译页面
1 接口通用说明
1.1 实现原理
在百度地图的清单文件中对主页面设置了
android:scheme="baidumap"

android:host="map"

属性.指定了接受Uri的scheme为baidumap,host为map。当接收到指定Uri后,在主界面中对Uri进行解析和业务拆分,实现功能的调用。
其中

native:scheme为baidumap,host为map

web:scheme为bdapp,host为map
1.2 使用方法
第三方APP在使用该类型接口时,手机中需要安装Android百度地图,同时需要拼写符合协议规范的Uri串,通过srartActivity的方式进行调用。示例如下
// 调起出行早知道页面

Intent i1 = new Intent();

i1.setData(Uri.parse("baidumap://map/newsassistant"));

startActivity(i1);

//网页应用调起Android百度地图方式举例

<a href="bdapp://map/newsassistant">调起出行早知道页面</a>

在第三方APP中执行上述代码就可以打开百度地图的出行早知道界面。如下图:

image2016-10-2113-23-22.png

2 接口说明

百度地图Open API所有接口共分为四类,分别为:图区功能类,搜索功能类,导航类和信息显示类。每个接口对应一个专门的Uri串,每个串中相应参数会在下面详细说明。

2.1 通用参数
每个协议都可以填写的通用参数
参数说明
参数 描述
coord_type 坐标类型,可选参数,默认为bd09经纬度坐标。允许的值为bd09ll、bd09mc、gcj02、wgs84。bd09ll表示百度经纬度坐标,bd09mc表示百度墨卡托坐标,gcj02表示经过国测局加密的坐标,wgs84表示gps获取的坐标
src 必选参数,格式为:companyName|appName
不传此参数,不保证服务
2.2 图区功能
2.2.1 展示地图
展示地图,可通过zoom、center以及bounds来指定地图的视野范围。
URL接口: baidumap://map/show
参数说明
参数名称 描述 是否必选 格式(示例)
center 中心点 可选 lat,lng (先纬度,后经度)
center和bounds不可全为空
bounds 图区范围 可选 lat,lng,lat,lng (先纬度,后经度, 先左下,后右上)
center和bounds不可全为空
traffic 是否开启路况,目前仅查看地图和打点支持,on表示开启,off表示关闭。 可选 on、off
zoom 地图展示的级别 可选 13

注意:地点搜索限定范围可以由bounds和zoom+center方式进行,其中bounds优先级最高。

使用示例
Intent i1 = new Intent();

// 展示地图

i1.setData(Uri.parse(" baidumap://map/show?center=40.057406655722,116.29644071728&zoom=11&traffic=on&bounds=37.8608310000,112.5963090000,42.1942670000,118.9491260000"));

startActivity(i1);

//网页应用调起Android百度地图方式举例

<a href="bdapp://map/show?center=40.057406655722,116.29644071728
&zoom=11&traffic=on&bounds=37.8608310000,112.5963090000,42.1942670000,118.9491260000">展示地图</a>

显示效果如下:

image2016-10-2113-25-44.png

2.2.2 自定义打点
调用该接口可调起Android百度地图,且在指定坐标点上显示点的名称和内容信息。
URL接口:baidumap://map/marker
参数说明
参数名称 描述 是否必选 格式(示例)
location 经纬度 必选 at,lng (先纬度,后经度)
title 打点标题 必选
content 打点内容 可选
traffic 是否开启路况,目前仅查看地图和打点支持,on表示开启,off表示关闭。 可选 on、off
使用示例
// 自定义打点

i1.setData(Uri.parse("baidumap://map/marker?location=40.057406655722,116.2964407172&title=Marker&content=makeamarker&traffic=on"));

startActivity(i1);

//网页应用调起Android百度地图方式举例

<a href="bdapp://map/marker?location=40.05740665572,
116.2964407172&title=Marker&content=makeamarker&traffic=on">
自定义打点</a>

显示效果如下:

image2016-10-2113-26-14.png

2.2.3 展示地图图区
展示地图图区,无参数。。
URL接口:baidumap://map?
使用示例
Intent i1 = new Intent();

// 展示地图图区

i1.setData(Uri.parse("baidumap://map?"));

startActivity(i1);

//网页应用调起Android百度地图方式举例

<a href="bdapp://map?">展示地图图区</a>

显示效果如下:

image2016-10-2113-26-41.png

2.2.4 地址解析
调用该接口可以在调起百度地图时,在图区显示地址对应的坐标点。
URL接口: baidumap://map/geocoder
参数说明
参数名称 描述 是否必选 格式(示例)
address 地址名称 必选 北京市海淀区上地信息路9号奎科科技大厦
使用示例
Intent i1 = new Intent();

// 地址解析

i1.setData(Uri.parse("baidumap://map/geocoder?src=openApiDemo&address=北京市海淀区上地信息路9号奎科科技大厦"));

startActivity(i1);

//网页应用调起Android百度地图方式举例

<a href="bdapp:// map/geocoder?src=openApiDemo&address=北京市海淀区上地信息路9号奎科科技大厦">地址解析</a>

显示效果如下:

image2016-10-2113-27-21.png

2.2.5 反向地址解析
调用该接口可调起百度地图,经过逆地理编码后,以标注形式显示位置和地址信息。
URL接口: baidumap://map/geocoder
参数说明
参数名称 描述 是否必选 格式(示例)
location 经纬度 必选 lat,lng (先纬度,后经度)
使用示例
Intent i1 = new Intent();

// 反向地址解析

i1.setData(Uri.parse("baidumap://map/geocoder?location=39.98871,116.43234"));

startActivity(i1);

//网页应用调起Android百度地图方式举例

<a href="bdapp://map/geocoder?location=39.98871,116.43234">反向地
址解析</a>

显示效果如下:

image2016-10-2113-27-45.png

  • 文档根本没法用

  • 文档水平很差

  • 文档水平一般

  • 文档不错

  • 文档写的很好

如发现文档错误,或对此文档有更好的建议,请在下方反馈。问题咨询请前往反馈平台提交工单咨询。

提交反馈

拖动标注工具

添加矩形标注

添加箭头标注

完成

取消