您当前的位置URI API>接口说明

Android版百度地图调起说明

1 适用环境

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

2 移动应用调用百度地图

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

协议规范

intent://product/[service/]action[?parameters]#Intent;scheme=bdapp;package=package;end
//parameters功能参数定义,具体规范见功能协议说明

组成说明

参数名称 参数说明 是否必选 备注
intent:// android固定协议头 必选  
product 产品线名称,如百度地图客户端(map) 必选  
service 具体功能服务名称,如POI检索服务(place) 必选  
action 方法名称,如POI检索中的详情检索(detail) 必选  
parameters 方法参数,参考各个功能协议说明的定义 必选  
scheme 固定为bdapp,即等价于iOS的协议头。 必选  
package 客户端包名称,如百度地图客户端(com.baidu.BaiduMap) 必选  

代码片段:

intent = Intent.getIntent("intent://map/line?coordtype=&zoom=&region=上海&name=28&src=yourCompanyName|yourAppName#Intent;scheme=bdapp;package=com.baidu.BaiduMap;end");  //调起百度地图客户端(Android)展示上海市"28"路公交车的检索结果
startActivity(intent);   //启动调用

以上代码会调起Android百度地图,调起效果如下:

3 浏览器内调起百度地图

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

协议规范

bdapp://product/[service/]action[?parameters]   //parameters功能参数定义,具体规范见功能协议说明

参数名称 参数说明 是否必选 备注
scheme 固定为bdapp 必选  
product 产品线名称,如百度地图客户端(map) 必选  
service 具体功能服务名称,如POI检索服务(place) 必选 有些服务无service,如标注服务
action 方法名称,如POI检索中的详情检索(detail) 必选  
parameters 方法参数,参考各个功能协议说明的定义 必选  

代码片段

<a href="bdapp://map/line?coordtype=&zoom=&region=上海&name=28&src=yourCompanyName|yourAppName">
线路查询</a>

单击浏览器以上链接会调起Android百度地图,与2示例效果相同。

4 功能使用说明

4.1 标注

调用该接口可调起Android百度地图,且在指定坐标点上显示点的名称和内容信息。

服务地址

intent://map/marker     //Android服务地址(基于Android SDK应用开发)
bdapp://map/marker      //Android服务地址(基于浏览器端应用开发)

参数说明

参数名称 参数说明 是否必选 备注
location lat <纬度> ,lng <经度> 必选  
title 标注点显示标题 必选  
content 标注点显示内容 必选  
coord_type 坐标类型,可选参数,默认为百度经纬度坐标。 可选 默认为bd09经纬度坐标。允许的值为bd09ll、bd09mc、gcj02、wgs84。bd09ll表示百度经纬度坐标,gcj02表示经过国测局加密的坐标,wgs84表示gps获取的坐标。
zoom 展现地图的级别,默认为视觉最优级别。 可选  
src 调用来源,规则:companyName|appName。 必选 此参数不传值,不保证服务。

代码片段

//移动APP调起Android百度地图方式举例
intent = Intent.getIntent("intent://map/marker?location=40.047669,116.313082&title=我的位置&content
=百度奎科大厦&src=yourCompanyName|yourAppName#Intent;scheme=bdapp;package=com.baidu.BaiduMap;end"); startActivity(intent);
//启动调用 //网页应用调起Android百度地图方式举例 <a href="bdapp://map/marker?location=40.047669,116.313082&title=我的位置&content=百度奎科大厦&src=
yourCompanyName|yourAppName">地图标点</a>

调起的Android百度地图效果如下:

4.2 地址解析

调用该接口可以在调起百度地图时,当前页面显示地址对应的坐标点。

服务地址

intent://map/geocoder       //Android服务地址(基于Android SDK应用开发)
bdapp://map/geocoder       //Android服务地址(基于浏览器端应用开发)

参数说明

参数名称 参数说明 是否必选 备注
address 地址名称 必选  
zoom 展现地图的级别,默认为视觉最优级别。 可选  
src 调用来源,规则:companyName|appName。 必选 此参数不传值,不保证服务。

代码片段

//移动APP调起Android百度地图方式举例
intent = Intent.getIntent("intent://map/geocoder?address=北京市海淀区上地信息路9号奎科科技大厦&src=your
CompanyName|yourAppName#Intent;scheme=bdapp;package=com.baidu.BaiduMap;end"); startActivity(intent);
//启动调用 //网页应用调起Android百度地图方式举例 <a href="bdapp://map/geocoder?address=北京市海淀区上地信息路9号奎科科技大厦&src=yourCompanyName|yourApp
Name">地理编码</a>

4.3 反向地址解析(地址查询)

调用该接口可调起Android百度地图,经过逆地理编码后,以标注形式显示位置和地址信息。

服务地址

intent://map/geocoder           //Android服务地址(基于Android SDK应用开发)
bdapp://map/geocoder       //Android服务地址(基于浏览器端应用开发I)

参数说明

参数名称 参数说明 是否必选 备注
location lat <纬度> ,lng <经度> 必选  
coord_type 坐标类型,可选参数,默认为bd09经纬度坐标。 可选 允许的值为bd09ll、gcj02、wgs84。bd09ll表示百度经纬度坐标, gcj02表示经过国测局加密的坐标,wgs84表示gps获取的坐标。
zoom 展现地图的级别,默认为视觉最优级别。 可选  
src 调用来源,规则:companyName|appName。 必选 此参数不传值,不保证服务。

代码片段

//移动APP调起Android百度地图方式举例
intent = Intent.getIntent("intent://map/geocoder?location=39.990912172420714,116.32715863448607&
coord_type=gcj02&src=yourCompanyName|yourAppName#Intent;scheme=bdapp;package=com.baidu.BaiduMap;
end"); startActivity(intent);
//启动调用 //网页应用调起Android百度地图方式举例 <a href="bdapp://map/geocoder?location=39.990912172420714,116.32715863448607&coord_type=gcj02&s
rc=yourCompanyName|yourAppName">逆地理编码</a>

4.4 POI(地点)搜索

调用该接口可调起Android百度地图,通过本地检索服务,以列表形式显示符合查询条件的点。

服务地址

intent://map/place/search        //Android服务地址(基于Android SDK应用开发)
bdapp://map/place/search       //Android服务地址(基于浏览器端应用开发)

参数说明

参数名称 参数说明 是否必选 备注
query 关键词 必选  
region 城市名或县名 选择方式:地点搜索限定范围可以由region、bounds和location + radius方式进行,其中bounds优先级最高、region优先级最低(与web服务保持一致)。  
location 中心点经纬度,或中心点经纬度和名称描述,注意,名称不参与检索,只负责显示。 同上 1、39.9761 <纬度> ,116.3282 <经度>
2、39.9761 <纬度> ,116.3282 <经度> | 中关村<名称>
radius 检索半径 同上  
bounds 视野范围 同上 lat,lng <左下角> ,lat,lng <右上角>
output 表示输出类型,web上必须指定为html才能展现地图产品结果。 必选 手机客户端忽略此参数
coord_type 坐标类型,可选参数,默认为bd09经纬度坐标。 可选 允许的值为bd09ll、gcj02、wgs84。bd09ll表示百度经纬度坐标, gcj02表示经过国测局加密的坐标,wgs84表示gps获取的坐标。
zoom 展现地图的级别,默认为视觉最优级别。 可选  
src 调用来源,规则:companyName|appName。 必选 此参数不传值,不保证服务。

代码片段

//移动APP调起Android百度地图方式举例
intent = Intent.getIntent("intent://map/place/search?query=海底捞&location=31.204055632862,121.4
1117785465&radius=1000&region=上海&src=yourCompanyName|yourAppName#Intent;scheme=bdapp;package=com.
baidu.BaiduMap;end"); startActivity(intent);
//启动调用 //网页应用调起Android百度地图方式举例 <a href="bdapp://map/place/search?query=海底捞&location=31.204055632862,121.41117785465&radius=1
000&region=上海&src=yourCompanyName|yourAppName">周边检索</a>

调起Android百度地图进行查询效果如下:

4.5 POI详情页展示

调用该接口可调起Android百度地图,通过POI详情查询服务,显示指定点的详情信息。

服务地址

intent://map/place/detail       //Android服务地址(基于Android SDK应用开发)
bdapp://map/place/detail       //Android服务地址(基于浏览器端应用开发)

参数说明

参数名称 参数说明 是否必选 备注
uid POI的ID 必选  
zoom 展现地图的级别,默认为视觉最优级别。 可选  
src 调用来源,规则:companyName|appName。 必选 此参数不传值,不保证服务。

代码片段

//移动APP调起Android百度地图方式举例
intent = Intent.getIntent("intent://map/place/detail?uid=d3099bdd81c525dbd1f49ee6&src=yourCompany
Name|yourAppName#Intent;scheme=bdapp;package=com.baidu.BaiduMap;end"); startActivity(intent);
//启动调用 //网页应用调起Android百度地图方式举例 <a href="bdapp://map/place/detail?uid=d3099bdd81c525dbd1f49ee6&src=yourCompanyName|yourAppName">
详情检索</a>

调起Android百度地图进行查询效果如下:

4.6 公交、地铁线路查询

服务地址

intent://map/line      //Android服务地址(基于Android SDK应用开发)
bdapp://map/line       //Android服务地址(基于浏览器端应用开发)

参数说明

参数名称 参数说明 是否必选 备注
region 城市名或县名 必选  
name 线路名称 必选  
zoom 展现地图的级别,默认为视觉最优级别。 可选  
src 调用来源,规则:companyName|appName。 必选 此参数不传值,不保证服务。

代码片段

//移动APP调起Android百度地图方式举例
 intent = Intent.getIntent("intent://map/line? region=北京&name=518&src=yourCompanyName|yourApp
Name#Intent;scheme=bdapp;package=com.baidu.BaiduMap;end"); startActivity(intent);
//启动调用 //网页应用调起Android百度地图方式举例 <a href="bdapp://map/line?region=北京&name=518&src=yourCompanyName|yourAppName">线路查询</a>

调起Android地图效果如2。

4.7 公交、驾车、步行导航

调起Android百度地图,展示指定导航模式下从起点到终点的路线规划。

服务地址

intent://map/direction       //Android服务地址(基于Android SDK应用开发)
bdapp://map/direction      //Android服务地址(基于浏览器端应用开发)

参数名称 参数说明 是否必选 备注
origin 起点名称或经纬度,或者可同时提供名称和经纬度,此时经纬度优先级高,将作为导航依据,名称只负责展示。 必选 1、名称:天安门
2、经纬度:39.98871 <纬度> ,116.43234 <经度> 。
3、名称和经纬度:name:天安门|latlng:39.98871,116.43234
destination 终点名称或经纬度,或者可同时提供名称和经纬度,此时经纬度优先级高,将作为导航依据,名称只负责展示。 必选 同上
mode 导航模式,固定为transit、driving、walking,分别表示公交、驾车和步行 必选  
region 城市名或县名 当给定region时,认为起点和终点都在同一城市,除非单独给定起点或终点的城市。  
origin_region 起点所在城市或县 同上  
destination_region 终点所在城市或县 同上  
coord_type 坐标类型,可选参数,默认为bd09经纬度坐标。 可选 允许的值为bd09ll、bd09mc、gcj02、wgs84。bd09ll表示百度经纬度坐标,bd09mc表示百度墨卡托坐标,gcj02表示经过国测局加密的坐标,wgs84表示gps获取的坐标。
zoom 展现地图的级别,默认为视觉最优级别。 可选  
src 调用来源,规则:companyName|appName。 必选  

示例

//移动APP调起Android百度地图方式举例
intent = Intent.getIntent("intent://map/direction?origin=latlng:34.264642646862,108.95108518068|
name:我家&destination=大雁塔&mode=driving&region=西安&src=yourCompanyName|yourAppName#Intent;scheme=b
dapp;package=com.baidu.BaiduMap;end"); startActivity(intent);
//启动调用 //网页应用调起Android百度地图方式举例 <a href="intent://map/direction?origin=latlng:34.264642646862,108.95108518068|name:我家&destinat
ion=大雁塔&mode=driving&region=西安&src=yourCompanyName|yourAppName">线路规划</a>

调起Android地图效果如下: