网站:http://lbsyun.baidu.com/index.php?title=uri/api/web
地图调起URI API
百度地图URI API是为开发者提供直接调起百度地图产品(百度Web地图、百度地图手机客户端)以满足特定业务场景下应用需求的程序接口,开发者只需按照接口规范构造一条标准的URI,便可在PC和移动端浏览器或移动开发应用中调起百度地图产品,进行地图展示和检索、线路查询、导航等功能,无需进行复杂的地图功能开发。
简介
Web版百度地图面向PC&移动端浏览器的网站应用或移动APP应用,其中PC浏览器调起的百度地图地址为:http://map.baidu.com/ ;移动端调起的百度地图地址为:http://map.baidu.com/mobile/
协议形式
scheme://hostname/service?parameters
示例
http://api.map.baidu.com/marker?location=39.916979519873,116.41004950566&title=我的位置&content=百度奎科大厦&output=html
//可以在PC、移动设备浏览器上打开打开该链接显示地图上的点
移动设备浏览器调起效果如下:
Webapp示例组成说明:
域名:对应hostname,如api.map.baidu.com
服务名:对应service,如marker
参数:对应parameters,如 location,title,content,output等。
接口功能文档
地图标点功能
调用该接口可调起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=yourComponyName|yourAppName
//调起百度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 | appName。 | 必选 | 此参数不传值,不保证服务。 |
地址解析
调用该接口可以在调起百度地图时,当前页面显示地址对应的坐标点。
服务地址
http://api.map.baidu.com/geocoder //PC&Webapp服务地址
示例
http://api.map.baidu.com/geocoder?address=北京市海淀区上地信息路9号奎科科技大厦&output=html&src=yourCompanyName|yourAppName
在iOS浏览器打开以上链接会调起百度web地图,详情页面如左图,点击”地图”后进入右图。
参数说明
参数名称 | 参数说明 | 是否必选 | 备注 |
---|---|---|---|
address | 地址名称 | 必选 | |
output | 表示输出类型,web上必须指定为html才能展现地图产品结果。 | 必选 | 手机客户端忽略此参数 |
coord_type | 坐标类型,可选参数,默认为bd09经纬度坐标。允许的值为bd09ll、bd09mc、gcj02、wgs84。bd09ll表示百度经纬度坐标,bd09mc表示百度墨卡托坐标,gcj02表示经过国测局加密的坐标,wgs84表示gps获取的坐标。 | 可选 | |
zoom | 展现地图的级别,默认为视觉最优级别。 | 可选 | |
src | appName。 | 必选 | 此参数不传值,不保证服务。 |
反向地址解析(地址查询)
调用该接口可调起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=yourCompanyName|yourAppName
参数说明
参数名称 | 参数说明 | 是否必选 | 备注 |
---|---|---|---|
location | lat<纬度>,lng<经度> | 必选 | |
output | 表示输出类型,web上必须指定为html才能展现地图产品结果。 | 必选 | 手机客户端忽略此参数 |
coord_type | 坐标类型,可选参数,默认为bd09经纬度坐标。允许的值为bd09ll、bd09mc、gcj02、wgs84。bd09ll表示百度经纬度坐标,bd09mc表示百度墨卡托坐标,gcj02表示经过国测局加密的坐标,wgs84表示gps获取的坐标。 | 可选 | |
zoom | 展现地图的级别,默认为视觉最优级别。 | 可选 | |
src | appName。 | 必选 | 此参数不传值,不保证服务。 |
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®ion=上海&output=html&src=yourCompanyName|yourAppName //周边检索
在iOS浏览器打开以上链接会调起百度web地图,详情页面如左图,点击”地图”后进入右图。
参数说明
参数名称 | 参数说明 | 是否必选 | 备注 |
---|---|---|---|
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 | appName。 | 必选 | 此参数不传值,不保证服务。 |
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=yourCompanyName|yourAppName //调起百度PC或Web地图
在iOS浏览器打开以上链接会调起百度web地图,详情页面如左图,点击”地图”后进入右图。
参数说明
参数名称 | 参数说明 | 是否必选 | 备注 |
---|---|---|---|
uid | POI的ID | 必选 | |
output | 表示输出类型,web上必须指定为html才能展现地图产品结果。 | 必选 | 手机客户端忽略此参数 |
zoom | 展现地图的级别,默认为视觉最优级别。 | 可选 | |
src | appName。 | 必选 | 此参数不传值,不保证服务。 |
公交、地铁线路查询
调用该接口可调起PC或Web百度地图,通过线路查询服务,以列表形式显示线路信息。
服务地址
http://api.map.baidu.com/line //PC&Webapp服务地址
示例
http://api.map.baidu.com/line?region=北京&name=518&output=html&src=yourCompanyName|yourAppName //调起百度PC或Web地图
在iOS浏览器打开以上链接会调起百度web地图,详情页面如左图,点击”地图”后进入右图。
参数说明
参数名称 | 参数说明 | 是否必选 | 备注 |
---|---|---|---|
region | 城市名或县名 | 必选 | |
name | 线路名称 | 必选 | |
output | 表示输出类型,web上必须指定为html才能展现地图产品结果。 | 必选 | 手机客户端忽略此参数 |
zoom | 展现地图的级别,默认为视觉最优级别。 | 可选 | |
src | appName。 | 必选 | 此参数不传值,不保证服务。 |
公交、驾车、步行路线规划
服务地址
http://api.map.baidu.com/direction //PC&Webapp服务地址
示例
http://api.map.baidu.com/direction?origin=latlng:34.264642646862,108.95108518068|name:我家&destination=大雁塔&mode=driving®ion=西安&output=html&src=yourCompanyName|yourAppName //调起百度PC或Web地图,展示"西安市"从(lat:34.264642646862,lng:108.95108518068 )"我家"到"大雁塔"的驾车路线。
在iOS浏览器打开以上链接会调起百度web地图,详情页面如左图,点击”地图”后进入右图。
参数说明
参数名称 | 参数说明 | 是否必选 | 备注 |
---|---|---|---|
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 | appName。 | 必选 |
全景服务
调用该接口可以在调起百度地图api时,当前页面显示对应的全景点。
服务地址
http://api.map.baidu.com/pano //PC&Webapp服务地址
示例
http://api.map.baidu.com/pano/?x=120.320032&y=31.589666&lc=0&ak=您的秘钥
调用该接口可调起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,即显示内景出口 |