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

地图调起URI API

百度地图URI API是为开发者提供直接调起百度地图产品(百度Web地图、百度地图手机客户端)以满足特定业务场景下应用需求的程序接口,开发者只需按照接口规范构造一条标准的URI,便可在PC和移动端浏览器或移动开发应用中调起百度地图产品,进行地图展示和检索、线路查询、导航等功能,无需进行复杂的地图功能开发。

适用环境

Web版百度地图面向PC&移动端浏览器的网站应用或移动APP应用,其中PC浏览器调起的百度地图地址为:http://map.baidu.com/ ;移动端调起的百度地图地址为:http://map.baidu.com/mobile/

详细目录
1 接口说明
  1.1 通用参数
2 接口功能文档
  2.1 图区功能
    2.1.1 地图标点功能
    2.1.2 地址解析
    2.1.3 反向地址解析
  2.2 搜索功能
    2.2.1 POI地点检索
    2.2.2 公交、地铁线路查询
    2.2.3 公交、驾车、步行路线规划
  2.3 信息显示
    2.3.1 POI详情页展示
    2.3.2 全景服务
1 接口说明

百度地图Open API所有接口共分为三类,分别为:图区功能类,搜索功能类和信息显示类。具体的协议形式和参数,见如下说明。

1.1 通用参数
scheme://hostname/service?parameters
示例
http://mapopen-website-wiki.cdn.bcebos.com/uri-api/images/web/webExamples.png
//可以在PC、移动设备浏览器上打开打开该链接显示地图上的点
移动设备浏览器调起效果如下:

webExamples.png

Webapp示例组成说明:

域名:对应hostname,如api.map.baidu.com

服务名:对应service,如marker

参数:对应parameters,如 location,title,content,output,src等。
其中src是统计必选参数,格式为:webapp.companyName.appName不传此参数,不保证服务。

2 接口功能文档
2.1 图区功能
2.1.1 地图标点功能
调用该接口可调起PC或web地图,且在指定坐标点上显示点的名称和内容信息。
服务地址
http://api.map.baidu.com/marker    

//PC&WebApp服务地址

示例
http://api.map.baidu.com/marker?location=40.047669,116.313082&title=我的位置&content=百度奎科大厦&output=html&src=webapp.baidu.openAPIdemo   

//调起百度PC或web地图,且在(lat:39.916979519873,lng:116.41004950566)坐标点上显示名称"我的位置",内容"百度奎科大厦"的信息窗口。

参数说明
参数名称 参数说明 是否必选 备注
location lat<纬度>,lng<经度> 必选
title 标注点显示标题 必选
content 标注点显示内容 必选
output 表示输出类型,web上必须指定为html才能展现地图产品结果。 必选
coord_type 坐标类型,可选参数 默认为bd09经纬度坐标。允许的值为bd09ll、bd09mc、gcj02、wgs84。bd09ll表示百度经纬度坐标,bd09mc表示百度墨卡托坐标,gcj02表示经过国测局加密的坐标,wgs84表示gps获取的坐标。
zoom 展现地图的级别,默认为视觉最优级别。 可选
src 调用来源,规则:webapp.companyName.appName。 必选 此参数不传值,不保证服务。
2.1.2 地址解析
调用该接口可以在调起百度地图时,当前页面显示地址对应的坐标点。
服务地址
http://api.map.baidu.com/geocoder   //PC&Webapp服务地址
示例
http://api.map.baidu.com/geocoder?address=北京市海淀区上地信息路9号奎科科技大厦&output=html&src=webapp.baidu.openAPIdemo

在iOS浏览器打开以上链接会调起百度web地图,详情页面如左图,点击"地图"后进入右图。

address_analysis1.jpg address_analysis2.jpg

参数说明
参数名称 参数说明 是否必选 备注
address 地址名称 必选
output 表示输出类型,web上必须指定为html才能展现地图产品结果。 必选 手机客户端忽略此参数
coord_type 坐标类型,可选参数,默认为bd09经纬度坐标。允许的值为bd09ll、bd09mc、gcj02、wgs84。bd09ll表示百度经纬度坐标,bd09mc表示百度墨卡托坐标,gcj02表示经过国测局加密的坐标,wgs84表示gps获取的坐标。 可选
zoom 展现地图的级别,默认为视觉最优级别。 可选
src 调用来源,规则:webapp.companyName.appName。 必选 此参数不传值,不保证服务。
2.1.3 反向地址解析
调用该接口可调起PC或Web百度地图,经过逆地理编码后,以标注形式显示位置和地址信息。
服务地址
http://api.map.baidu.com/geocoder       //PC&Webapp服务地址
示例
http://api.map.baidu.com/geocoder?location=39.990912172420714,116.32715863448607&coord_type=gcj02&output=html&src=webapp.baidu.openAPIdemo

在iOS浏览器打开以上链接会调起百度web地图,显示页面如下图:

reverse_address_analysis.jpg

参数说明
参数名称 参数说明 是否必选 备注
location lat<纬度>,lng<经度> 必选
output 表示输出类型,web上必须指定为html才能展现地图产品结果。 必选 手机客户端忽略此参数
coord_type 坐标类型,可选参数,默认为bd09经纬度坐标。允许的值为bd09ll、bd09mc、gcj02、wgs84。bd09ll表示百度经纬度坐标,bd09mc表示百度墨卡托坐标,gcj02表示经过国测局加密的坐标,wgs84表示gps获取的坐标。 可选
zoom 展现地图的级别,默认为视觉最优级别。 可选
src 调用来源,规则:webapp.companyName.appName。 必选 此参数不传值,不保证服务。
2.2 搜索功能
2.2.1 POI地点检索
调用该接口可调起PC或Web百度地图,通过本地检索服务,以列表形式显示符合查询条件的点。
服务地址
http://api.map.baidu.com/place/search    //PC&Webapp服务地址
示例
http://api.map.baidu.com/place/search?query=海底捞&location=31.204055632862,121.41117785465&radius=1000&region=上海&output=html&src=webapp.baidu.openAPIdemo   //周边检索

在iOS浏览器打开以上链接会调起百度web地图,详情页面如左图,点击"地图"后进入右图。

POIsearch%201.jpg POIsearch%202.jpg

参数说明
参数名称 参数说明 是否必选 备注
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 调用来源,规则:webapp.companyName.appName。 必选 此参数不传值,不保证服务。
2.2.2 公交、地铁线路查询
调用该接口可调起PC或Web百度地图,通过本地检索服务,以列表形式显示符合查询条件的点。
服务地址
http://api.map.baidu.com/line    //PC&Webapp服务地址
示例
http://api.map.baidu.com/line?region=北京&name=518&output=html&src=webapp.baidu.openAPIdemo    //调起百度PC或Web地图

在iOS浏览器打开以上链接会调起百度web地图,详情页面见下图。

Bus_subway_Route_query2.jpg

参数说明
参数名称 参数说明 是否必选 备注
region 城市名或县名 必选
name 线路名称 必选
output 表示输出类型,web上必须指定为html才能展现地图产品结果。 必选 手机客户端忽略此参数
bounds 视野范围 同上 lat,lng<左下角>,lat,lng<右上角>
output 表示输出类型,web上必须指定为html才能展现地图产品结果。 必选 手机客户端忽略此参数
zoom 展现地图的级别,默认为视觉最优级别。 可选
src 调用来源,规则:webapp.companyName.appName。 必选 此参数不传值,不保证服务。
2.2.3公交、驾车、步行路线规划
服务地址
http://api.map.baidu.com/direction   //PC&Webapp服务地址
示例
http://api.map.baidu.com/direction?origin=latlng:34.264642646862,108.95108518068|name:我家&destination=大雁塔&mode=driving&region=西安&output=html&src=webapp.baidu.openAPIdemo
//调起百度PC或Web地图,展示"西安市"从(lat:34.264642646862,lng:108.95108518068 )"我家"到"大雁塔"的驾车路线。

在iOS浏览器打开以上链接会调起百度web地图,详情页面见下图。

Route_plan.jpg

参数说明
参数名称 参数说明 是否必选 备注
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表示百度墨卡托坐标,gcj02表示经过国测局加密的坐标,wgs84表示gps获取的坐标
zoom 展现地图的级别,默认为视觉最优级别。 可选
src 调用来源,规则:webapp.companyName.appName。 必选 此参数不传值,不保证服务。
2.3 信息显示
2.3.1 POI详情页展示
调用该接口可调起PC或Web百度地图,通过POI详情查询服务,显示指定点的详情信息。
服务地址
http://api.map.baidu.com/place/detail   //PC&Webapp服务地址
示例
http://api.map.baidu.com/place/detail?uid=d3099bdd81c525dbd1f49ee6&output=html&src=webapp.baidu.openAPIdemo   //调起百度PC或Web地图

在iOS浏览器打开以上链接会调起百度web地图,详情页面见下图。

POIpageExhibition.jpg

参数说明
参数名称 参数说明 是否必选 备注
uid POI的ID 必选
output 表示输出类型,web上必须指定为html才能展现地图产品结果。 必选 手机客户端忽略此参数
zoom 展现地图的级别,默认为视觉最优级别。 可选
src 调用来源,规则:webapp.companyName.appName。 必选 此参数不传值,不保证服务。
2.3.2 全景服务
调用该接口可以在调起百度地图api时,当前页面显示对应的全景点。
服务地址
http://api.map.baidu.com/pano   //PC&Webapp服务地址
示例
http://api.map.baidu.com/pano/?x=120.320032&y=31.589666&lc=0&ak=您的秘钥&src=webapp.baidu.openAPIdemo

调用该接口可调起PC或Web百度地图。

参数说明
参数名称 参数说明 是否必选 备注
ak 应用秘钥 必选
xy 经纬度 xy/pid/uid三组参数必选一组 显示该经纬周围最近的全景点
pid 全景的id xy/pid/uid三组参数必选一组 显示该id的全景点
uid poiid xy/pid/uid三组参数必选一组 显示该poi的全景点
h 水平角度 可选 默认为该场景点最佳角度
p 垂直视角 可选 默认为该场景点最佳角度
nc 是否显示鱼骨控件 可选 默认为1,即开启
lc 是否显示拓扑箭头 可选 默认为1,即开启
issc 是否显示内景场景切换控件 可选 默认为1,即开启
ac 是否相册控件 可选 默认为0,即关闭
z 场景缩放级别 可选 默认为3
iec 是否显示内部全景出口 可选 默认为1,即显示内景出口
src 调用来源,规则:webapp.companyName.appName。 必选 此参数不传值,不保证服务。