百度地图URI APIv2.0接口说明文档

百度地图 URIAPIv2.0接口说明百度在线网络技术（北京）有限公司 2013 年 6 月 6 日 北京

法律说明版权所有百度在线网络技术有限公司。 本文档包含的所有内容除特别声明之外，版权均属于百度在线网络技术有限公司所有，百度可在不作任何申明的情 况下对本文档内容进行修改。 本文档中所使用的商标所有权属于该商标的所有者。文件说明文件标识： 当前版本： 作 者： Baidu_URI API 2013_06_V2.0 Baidu_Map_PM 2012-10-24 2013-06-06（第 1 次更新）创建日期： 最新更新：百度在线网络技术有限公司 总机： （+86 10）59928888 邮箱：mapapi@ 地址：北京市海淀区上地信息路 9 号甲奎科科技大厦 邮编：100085 百度地图 API 网址：/map/ 百度地图 API 开发论坛：

目1 1.1 1.2 1.3录Web 版百度地图调起说明 ..................................................................................................................................................... 1 适用环境 ................................................................................................................................................................................ 1 协议形式 ................................................................................................................................................................................ 1 功能使用说明 ........................................................................................................................................................................ 2 1.3.1 1.3.2 1.3.3 1.3.4 1.3.5 1.3.6 1.3.7 地图标点功能 ........................................................................................................................................................... 2 地址解析 .................................................................................................................................................................... 3 反向地址解析（地址查询） .................................................................................................................................. 4 POI（地点）搜索 .................................................................................................................................................... 4 POI 详情页展示 ....................................................................................................................................................... 6 公交、地铁线路查询 ............................................................................................................................................... 7 公交、驾车、步行导航 ........................................................................................................................................... 82 2.1 2.2 2.3 2.4Android 版百度地图调起说明 ............................................................................................................................................ 10 适用环境 .............................................................................................................................................................................. 10 移动应用调用百度地图 ..................................................................................................................................................... 10 浏览器内调起百度地图 ..................................................................................................................................................... 11 功能使用说明 ...................................................................................................................................................................... 11 2.4.1 2.4.2 2.4.3 2.4.4 2.4.5 2.4.6 2.4.7 标注 .......................................................................................................................................................................... 11 地址解析 .................................................................................................................................................................. 13 反向地址解析（地址查询） ................................................................................................................................ 14 POI（地点）搜索 .................................................................................................................................................. 15 POI 详情页展示 ..................................................................................................................................................... 16 公交、地铁线路查询 ............................................................................................................................................. 17 公交、驾车、步行导航 ......................................................................................................................................... 183 3.1 3.2 3.3iOS 版百度地图调起说明...................................................................................................................................................... 20 适用环境 .............................................................................................................................................................................. 20 协议形式 .............................................................................................................................................................................. 20 功能使用说明 ...................................................................................................................................................................... 21

3.3.1 3.3.2 3.3.3 3.3.4 3.3.5 3.3.6 3.3.7 3.4 3.5标注 .......................................................................................................................................................................... 21 地址解析 .................................................................................................................................................................. 22 反向地址解析（地址查询） ................................................................................................................................ 23 POI（地点）搜索 .................................................................................................................................................. 24 POI 详情页展示 ..................................................................................................................................................... 25 公交、地铁线路查询 ............................................................................................................................................. 26 公交、驾车、步行导航 ......................................................................................................................................... 27附录 1：参数赋值说明 ...................................................................................................................................................... 28 附录 2：为何我的程序未返回结果？ ............................................................................................................................. 28

百度地图 API（/map）URI APIv2.0 接口说明1Web 版百度地图调起说明1.1 适用环境Web 版百度地图面向 PC&移动端浏览器的网站应用或移动 APP 应用，其中 PC 浏览器调起的百度地图地址为： /;移动端调起的百度地图地址为：/mobile/。1.2 协议形式scheme://hostname/service?parameters示例：/marker?location=39.916979519873,116.41004950566&title=我的位置&content =百度奎科大厦&output=html //可以在 PC、移动设备浏览器上打开打开该链接显示地图上的点移动设备浏览器调起效果如下：组成说明： 域名：对应 hostname，如 服务名：对应 service，如 marker 参数：对应 parameters，如 location,title,content,output 等。1

百度地图 API（/map）URI APIv2.0 接口说明1.3 功能使用说明1.3.1 地图标点功能调用该接口可调起 PC 或 web 地图，且在指定坐标点上显示点的名称和内容信息。 服务地址/marker//PC&WebApp 服务地址参数说明参数名称 location title content output 参数说明 lat<纬度>,lng<经度> 标注点显示标题 标注点显示内容 表示输出类型，web 上必须指定为 html 才能 展现地图产品结果。 coord_type 坐标类型，可选参数。 可选 默认为 bd09 经纬度坐标。允许的值为 bd09ll、 gcj02、wgs84。bd09ll 表示百度经纬度坐标， gcj02 表示经过国测局坐标， wgs84 表示 gps 获 取的坐标。 zoom src 展现地图的级别，默认为视觉最优级别。 调用来源， 规则： companyName|appName。 可选 必选 此参数不传值，不保证服务。 是否必选 必选 必选 必选 必选 备注示例/marker?location=40.047669,116.313082&title=我的位置&content=百度奎科大厦&o utput=html&src=yourComponyName|yourAppName //调起百度 PC 或 web 地图，且在（lat: 40.047669，lng: 116.313082）坐标点上显示名称“我的位置”，内容“百 度奎科大厦”的信息窗口。在 iOS 浏览器打开以上链接会调起百度 web 地图,页面如左图，点击”我的位置”后进入右图。2

百度地图 API（/map）URI APIv2.0 接口说明1.3.2地址解析调用该接口可以在调起百度地图时，当前页面显示地址对应的坐标点。 服务地址/geocoder//PC&Webapp 服务地址参数说明参数名称 address output zoom src 参数说明 地址名称 表示输出类型，web 上必须指定为 html 才能展现地图产品结果。 展现地图的级别，默认为视觉最优级别。 调用来源，规则：companyName|appName。 是否必选 必选 必选 可选 必选 此参数不传值，不保证 服务。 手机客户端忽略此参数 备注示例/geocoder?address=北京市海淀区上地信息路 9 号奎科科技大厦&output=html&src=yo urCompanyName|yourAppName在 iOS 浏览器打开以上链接会调起百度 web 地图,页面如左图，点击”地图”后进入右图。3

百度地图 API（/map）URI APIv2.0 接口说明1.3.3反向地址解析（地址查询）调用该接口可调起 PC 或 Web 百度地图，经过逆地理编码后，以标注形式显示位置和地址信息。 服务地址/geocoder 参数说明参数名称 location output coord_type 参数说明 lat<纬度>,lng<经度>//PC&Webapp 服务地址是否必选 必选 必选 可选备注表示输出类型，web 上必须指定为 html 才能展现地图产品结果。 坐标类型，可选参数，默认为 bd09 经纬度坐标。允许的值为 bd09ll、 gcj02、wgs84。bd09ll 表示百度经纬度坐标， gcj02 表示经过国测局 加密的坐标，wgs84 表示 gps 获取的坐标。手机客户端忽略此参数zoom src展现地图的级别，默认为视觉最优级别。 调用来源，规则：companyName|appName。可选 必选 此参数不传值，不保证服务。示例/geocoder?location=39.990912172420714,116.32715863448607&coord_type=gcj0 2&output=html&src=yourCompanyName|yourAppName1.3.4POI（地点）搜索调用该接口可调起 PC 或 Web 百度地图，通过本地检索服务，以列表形式显示符合查询条件的点。 服务地址/place/search//PC&Webapp 服务地址参数说明4

百度地图 API（/map）URI APIv2.0 接口说明参数名称 query region参数说明 关键词 城市名或县名是否必选 必选 选择方式：地点 搜索限定范围可 以 由 region 、 bounds location 和 +备注radius 方 式 进 行， 其中 bounds 优先级最高、 region 优先级最 低（与 web 服务 保持一致） 。 location 中心点经纬度，或中心点经纬度和名称描述，注意， 名称不参与检索，只负责显示。 同上 1. 经纬度：39.9761,116.3282 2. 经 纬 度 和 名 称 ：latlng:39.9761,116.3282|name:中关村radius bounds output检索半径 视野范围 表示输出类型，web 上必须指定为 html 才能展现 地图产品结果。同上 同上 必选 lat,lng<左下角>,lat,lng<右上角> 手机客户端忽略此参数coord_type坐标类型，可选参数，可选默认为 bd09 经纬度坐标。允许的值为 bd09ll、gcj02、wgs84。bd09ll 表示百 度经纬度坐标， gcj02 表示经过国测局 加密的坐标，wgs84 表示 gps 获取的坐 标。zoom src展现地图的级别，默认为视觉最优级别。 调用来源，规则：companyName|appName。可选 必选 此参数不传值，不保证服务。示例/place/search?query=海底捞&location=31.204055632862,121.41117785465&radius =1000&region=上海&output=html&src=yourCompanyName|yourAppName //周边检索在 iOS 浏览器打开以上链接会调起百度 web 地图,页面如左图，点击”地图”后进入右图。5

百度地图 API（/map）URI APIv2.0 接口说明1.3.5POI 详情页展示调用该接口可调起 PC 或 Web 百度地图，通过 POI 详情查询服务，显示指定点的详情信息。 服务地址/place/detail//PC&Webapp 服务地址参数说明参数名称 uid output zoom src 参数说明 POI 的 ID 表示输出类型，web 上必须指定为 html 才能展现地图产品结果。 展现地图的级别，默认为视觉最优级别。 调用来源，规则：companyName|appName。 是否必选 必选 必选 可选 必选 此参数不传值，不保证服务。 手机客户端忽略此参数 备注示例/place/detail?uid=d3099bdd81c525dbd1f49ee6&output=html&src=yourCompany Name|yourAppName //调起百度 PC 或 Web 地图在 IOS 浏览器打开以上链接会调起百度 web 地图,详情页面如左图，点击”地图”后进入右图。6

百度地图 API（/map）URI APIv2.0 接口说明1.3.6公交、地铁线路查询调用该接口可调起 PC 或 Web 百度地图，通过线路查询服务，以列表形式显示线路信息。 服务地址/line//PC&Webapp 服务地址参数说明参数名称 region name output zoom src 参数说明 城市名或县名 线路名称 表示输出类型，web 上必须指定为 html 才能展现地图产品结果。 展现地图的级别，默认为视觉最优级别。 调用来源，规则：companyName|appName。 是否必选 必选 必选 必选 可选 必选 此参数不传值，不保证服务。 手机客户端忽略此参数 备注示例/line?region=北京&name=518&output=html&src=yourCompanyName|yourAppNa me //调起百度 PC 或 Web 地图 在 iOS 浏览器打开以上链接会调起百度 web 地图,线路列表如左图，点击”地图”后进入右图。7

百度地图 API（/map）URI APIv2.0 接口说明1.3.7公交、驾车、步行导航调起 PC 或 Web 百度地图，展示指定导航模式下从起点到终点的路线规划。 服务地址/direction//PC&Webapp 服务地址参数说明参数名称 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 output 起点所在城市或县 终点所在城市或县 表示输出类型， web 上必须指定为 html 才能展现地图产品结果。 coord_type 坐标类型，可选参数。 可选 默 认 为 bd09 经 纬 度 坐 标 。 允 许 的 值 为 bd09ll、bd09mc、gcj02、wgs84。bd09ll 表示百度经纬度坐标，bd09mc 表示百度墨 8 同上 同上 必选 手机客户端忽略此参数 必选 必选 同上

百度地图 API（/map）URI APIv2.0 接口说明卡托坐标，gcj02 表示经过国测局加密的坐 标，wgs84 表示 gps 获取的坐标 zoom 展现地图的级别，默认为视觉最优级 别。 src 调 用 来 源 ， 规 则 ： 必选 可选companyName|appName。示例/direction?origin=latlng:34.264642646862,108.95108518068|name:我家&destinatio n=大雁塔&mode=driving&region=西安&output=html&src=yourCompanyName|yourAppName //调起百度 PC 或 Web 地图，展示“西安市”从（lat:34.264642646862,lng:108.95108518068 ）“我家”到“大雁 塔”的驾车路线。在 IOS 浏览器打开以上链接会调起百度 web 地图,导航结果如左图，点击”地图”后进入右图。9

百度地图 API（/map）URI APIv2.0 接口说明2 Android 版百度地图调起说明2.1 适用环境移动应用、浏览器端应用均可调起 Android 版百度地图。2.2 移动应用调用百度地图该调用方式是指第三方基于 Android SDK 进行应用开发时要调用 Android 版百度地图客户端需遵守的协议。 该协议 要正确执行除了要参数填写正确外，还必须要安装 Android 百度地图。 协议规范：intent://product/[service/]action[?parameters]#Intent;scheme=bdapp;package=package;end ers 功能参数定义，具体规范见功能协议说明//paramet组成说明：参数名称 intent:// product service action parameters scheme package 参数说明 android 固定协议头 产品线名称，如百度地图客户端（map） 具体功能服务名称，如 POI 检索服务（place） 方法名称，如 POI 区域检索（search） 方法参数，参考各个功能协议说明的定义 固定为 bdapp，即等价于 IOS 的协议头 客户端包名称，如百度地图客户端（com.baidu.BaiduMap） 是否必选 必选 必选 必选 必选 必选 必选 必选 备注代码片段：intent = Intent.getIntent("intent://map/line?coordtype=&zoom=&region=上海&name=28&src=yourCo mpanyName|yourAppName#Intent;scheme=bdapp;package=com.baidu.BaiduMap;end"); 图客户端（Android）展示上海市“28”路公交车的检索结果 startActivity(intent); //启动调用 //调起百度地以上代码会调起 Android 百度地图，调起效果如下：10

百度地图 API（/map）URI APIv2.0 接口说明2.3 浏览器内调起百度地图该调用方式是指第三方基于移动浏览器端进行应用开发时调用 Android 版百度地图客户端需遵守的协议。该协议要 正确执行除了要参数填写正确外，还必须要安装 Android 百度地图。 协议规范：bdapp://product/[service/]action[?parameters] //parameters 功能参数定义，具体规范见功能协议说明组成说明：参数名称 scheme product service 参数说明 固定为 bdapp 产品线名称，如百度地图客户端（map） 具体功能服务名称，如 POI 检索服务（place） 是否必选 必选 必选 必选 有些服务无 service，如标注 服务 action parameters 方法名称，如 POI 区域检索（search） 方法参数，参考各个功能协议说明的定义 必选 必选 备注代码片段：<a href="bdapp://map/line?coordtype=&zoom=&region=上海&name=28&src=yourCompanyName|yo urAppName">线路查询</a>单击浏览器以上链接会调起 Android 百度地图，与 2.2 示例效果相同。2.4 功能使用说明2.4.1 标注调用该接口可调起 Android 百度地图，且在指定坐标点上显示点的名称和内容信息。11

百度地图 API（/map）URI APIv2.0 接口说明服务地址intent://map/marker bdapp://map/marker//Android 服务地址（基于 Android SDK 应用开发） //Android 服务地址（基于浏览器端应用开发）参数说明参数名称 location title content coord_type 参数说明 lat<纬度>,lng<经度> 标注点显示标题 标注点显示内容 坐标类型，可选参数，默认为百度经纬度坐标。 是否必选 必选 必选 必选 可选 默认为 bd09 经纬度坐标。 允许的 值 为 bd09ll 、 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.Baid uMap;end"); startActivity(intent); //启动调用 //网页应用调起 Android 百度地图方式举例 <a href="bdapp://map/marker?location=40.047669,116.313082&title=我的位置&content=百度奎科大厦& src=yourCompanyName|yourAppName">地图标点</a>调起的 Android 百度地图效果如下：12

百度地图 API（/map）URI APIv2.0 接口说明2.4.2地址解析调用该接口可以在调起百度地图时，当前页面显示地址对应的坐标点。服务地址intent://map/geocoder bdapp://map/geocoder//Android 服务地址（基于 Android SDK 应用开发） //Android 服务地址（基于浏览器端应用开发）参数说明参数名称 address zoom src 参数说明 地址名称 展现地图的级别，默认为视觉最优级别。 调用来源，规则：companyName|appName。 是否必选 必选 可选 必选 此参数不传值，不 保证服务。 参数名称 参数说明 是否必选 备注 备注代码片段//移动 APP 调起 Android 百度地图方式举例 intent = Intent.getIntent("intent://map/geocoder?address=北京市海淀区上地信息路 9 号奎科科技大厦&src =yourCompanyName|yourAppName#Intent;scheme=bdapp;package=com.baidu.BaiduMap;end"); startActivity(intent); //启动调用13

百度地图 API（/map）URI APIv2.0 接口说明//网页应用调起 Android 百度地图方式举例 <a href="bdapp://map/geocoder?address=北京市海淀区上地信息路 9 号奎科科技大厦&src=yourCompanyN ame|yourAppName">地理编码</a>2.4.3反向地址解析（地址查询）调用该接口可调起 Android 百度地图，经过逆地理编码后，以标注形式显示位置和地址信息。服务地址intent://map/geocoder bdapp://map/geocoder//Android 服务地址（基于 Android SDK 应用开发） //Android 服务地址（基于浏览器端应用开发 I）参数说明参数名称 location coord_type 参数说明 lat<纬度>,lng<经度> 坐标类型，可选参数，默认为 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=gcj 02&src=yourCompanyName|yourAppName">逆地理编码</a>14

百度地图 API（/map）URI APIv2.0 接口说明2.4.4POI（地点）搜索调用该接口可调起 Android 百度地图，通过本地检索服务，以列表形式显示符合查询条件的点。服务地址intent://map/place/search bdapp://map/place/search//Android 服务地址（基于 Android SDK 应用开发） //Android 服务地址（基于浏览器端应用开发）参数说明参数名称 query region 参数说明 关键词 城市名或县名 是否必选 必选 选择方式：地点搜索限定范围可 以由 region、 bounds 和 location + radius 方式进行， 其中 bounds 优先级最高、region 优先级最低 （与 web 服务保持一致） 。 location 中心点经纬度，或中心点经纬度和名称 描述，注意，名称不参与检索，只负责 显示。 同上 1、39.9761<纬度>,116.3282<经 度> 2、39.9761<纬度>,116.3282<经 度>| 中关村<名称> radius bounds coord_type 检索半径 视野范围 坐标类型，可选参数，默认为 bd09 经 纬度坐标。 同上 同上 可选 lat,lng<左下角>,lat,lng<右上角> 允 许 的 值 为 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.411 17785465&radius=1000&region=上海&src=yourCompanyName|yourAppName#Intent;scheme=bdapp;p ackage=com.baidu.BaiduMap;end"); startActivity(intent); //启动调用 //网页应用调起 Android 百度地图方式举例15

百度地图 API（/map）URI APIv2.0 接口说明<a href="bdapp://map/place/search?query=海底捞&location=31.204055632862,121.41117785465&radi us=1000&region=上海&src=yourCompanyName|yourAppName">周边检索</a>调起 Android 百度地图进行查询效果如下：2.4.5POI 详情页展示调用该接口可调起 Android 百度地图，通过 POI 详情查询服务，显示指定点的详情信息。服务地址intent://map/place/detail//Android 服务地址（基于 Android SDK 应用开发）bdapp://map/place/detail //Android 服务地址（基于浏览器端应用开发）参数说明参数名称 uid zoom src 参数说明 POI 的 ID 展现地图的级别，默认为视觉最优级别。 调用来源，规则：companyName|appName。 是否必选 必选 可选 必选 此参数不传值，不保证服务。 备注代码片段//移动 APP 调起 Android 百度地图方式举例16

百度地图 API（/map）URI APIv2.0 接口说明intent = Intent.getIntent("intent://map/place/detail?uid=d3099bdd81c525dbd1f49ee6&src=yourCompa nyName|yourAppName#Intent;scheme=bdapp;package=com.baidu.BaiduMap;end"); startActivity(intent); //启动调用 //网页应用调起 Android 百度地图方式举例 <a href="bdapp://map/place/detail?uid=d3099bdd81c525dbd1f49ee6&src=yourCompanyName|yourAp pName">详情检索</a>调起 Android 百度地图进行查询效果如下：2.4.6公交、地铁线路查询服务地址intent://map/line//Android 服务地址（基于 Android SDK 应用开发）bdapp://map/line //Android 服务地址（基于浏览器端应用开发）参数说明参数名称 region name zoom src 参数说明 城市名或县名 线路名称 展现地图的级别，默认为视觉最优级别。 调用来源，规则：companyName|appName。 是否必选 必选 必选 可选 必选 此参数不传值，不保证服务。 备注17

本文来源：https://www.bwwdw.com/article/ngl1.html