地图调起URIAPI(通过连接直接调⽤百度地图)
地图调起URI API
百度地图URI API是为开发者提供直接调起百度地图产品(百度Web地图、百度地图⼿机客户端)以满⾜特定业务场景下应⽤需求的程序接⼝,开发者只需按照接⼝规范构造⼀条标准的URI,便可在PC和移动端浏览器或移动开发应⽤中调起百度地图产品,进⾏地图展⽰和检索、线路查询、导航等功能,⽆需进⾏复杂的地图功能开发。
简介
协议形式
scheme://hostname/service?parameters
⽰例
api.map.baidu/marker?location=39.916979519873,116.41004950566&title=我的位置&content=百度奎科⼤厦&output=html
//可以在PC、移动设备浏览器上打开打开该链接显⽰地图上的点
移动设备浏览器调起效果如下:
Webapp⽰例组成说明:
域名:对应hostname,如api.map.baidu
服务名:对应service,如marker
参数:对应parameters,如 location,title,content,output等。
接⼝功能⽂档
地图标点功能
调⽤该接⼝可调起PC或web地图,且在指定坐标点上显⽰点的名称和内容信息。
服务地址
api.map.baidu/marker
/
/PC&WebApp服务地址
⽰例
api.map.baidu/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。必选此参数不传值,不保证服务。
地址解析
调⽤该接⼝可以在调起百度地图时,当前页⾯显⽰地址对应的坐标点。
服务地址
api.map.baidu/geocoder  //PC&Webapp服务地址
⽰例
api.map.baidu/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百度地图,经过逆地理编码后,以标注形式显⽰位置和地址信息。
服务地址
api.map.baidu/geocoder      //PC&Webapp服务地址
⽰例
api.map.baidu/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百度地图,通过本地检索服务,以列表形式显⽰符合查询条件的点。
服务地址
api.map.baidu/place/search    //PC&Webapp服务地址
⽰例
api.map.baidu/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详情查询服务,显⽰指定点的详情信息。
服务地址
api.map.baidu/place/detail  //PC&Webapp服务地址
⽰例
api.map.baidu/place/detail?uid=d3099bdd81c525dbd1f49ee6&output=html&src=yourCompanyName|yourAppName  //调起百度PC或Web地图
在iOS浏览器打开以上链接会调起,详情页⾯如左图,点击"地图"后进⼊右图。
参数说明
参数名称参数说明是否必选备注uid POI的ID必选
output表⽰输出类型,web上必须指定为html才能展现地图产品结果。必选⼿机客户端忽略此参数
zoom展现地图的级别,默认为视觉最优级别。可选
src appName。必选此参数不传值,不保证服务。公交、地铁线路查询
调⽤该接⼝可调起PC或Web百度地图,通过线路查询服务,以列表形式显⽰线路信息。
服务地址
api.map.baidu/line    //PC&Webapp服务地址
⽰例
api.map.baidu/line?region=北京&name=518&output=html&src=yourCompanyName|yourAppName    //调起百度PC或Web地图
百度api接口在iOS浏览器打开以上链接会调起,详情页⾯如左图,点击"地图"后进⼊右图。
参数说明
参数名称参数说明是否必选备注region城市名或县名必选
name线路名称必选
output表⽰输出类型,web上必须指定为html才能展现地图产品结果。必选⼿机客户端忽略此参数zoom展现地图的级别,默认为视觉最优级别。可选
src appName。必选此参数不传值,不保证服务。公交、驾车、步⾏路线规划
服务地址
api.map.baidu/direction  //PC&Webapp服务地址
⽰例
api.map.baidu/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浏览器打开以上链接会调起,详情页⾯如左图,点击"地图"后进⼊右图。
参数说明
参数名称参数说明是否必选备注
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时,当前页⾯显⽰对应的全景点。
服务地址
api.map.baidu/pano  //PC&Webapp服务地址
⽰例
api.map.baidu/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,即显⽰内景出⼝