web端

适用环境

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、移动设备浏览器上打开打开该链接显示地图上的点

移动设备浏览器调起效果如下：

Webapp示例组成说明：

域名：对应hostname，如api.map.baidu.com

服务名：对应service，如marker

参数：对应parameters，如 location,title,content,output,src等。
每个协议都可以填写的通用参数，其中coord_type指坐标类型参数，默认为bd09经纬度坐标，如用户使用的坐标类型为gcj02、wgs84，则必须传递此参数值（
示例：coord_type=gcj02、coord_type=wgs84）,否则会导致地点坐标位置偏移。src是统计必选参数，格式为：andr.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	坐标类型，可选参数。 示例： coord_type= bd09ll 允许的值为： bd09ll（百度经纬度坐标） bd09mc（百度墨卡托坐标） gcj02（经国测局加密的坐标) wgs84（gps获取的原始坐标）	可选	如开发者不传递正确的坐标类型参数，会导致地点坐标位置偏移。默认为bd09经纬度坐标。 坐标类型说明。
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	地址名称	必选
output	表示输出类型，web上必须指定为html才能展现地图产品结果。	必选	手机客户端忽略此参数
coord_type	坐标类型，可选参数。 示例： coord_type= bd09ll 允许的值为： bd09ll（百度经纬度坐标） bd09mc（百度墨卡托坐标） gcj02（经国测局加密的坐标) wgs84（gps获取的原始坐标）	可选	如开发者不传递正确的坐标类型参数，会导致地点坐标位置偏移。默认为bd09经纬度坐标。 坐标类型说明。
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地图,显示页面如下图：

参数说明

参数名称	参数说明	是否必选	备注
location	lat<纬度>,lng<经度>	必选
output	表示输出类型，web上必须指定为html才能展现地图产品结果。	必选	手机客户端忽略此参数
coord_type	坐标类型，可选参数。 示例： coord_type= bd09ll 允许的值为： bd09ll（百度经纬度坐标） bd09mc（百度墨卡托坐标） gcj02（经国测局加密的坐标) wgs84（gps获取的原始坐标）	可选	如开发者不传递正确的坐标类型参数，会导致地点坐标位置偏移。默认为bd09经纬度坐标。 坐标类型说明。
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地图,详情页面如左图，点击"地图"后进入右图。

参数说明

参数名称	参数说明	是否必选	备注
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	坐标类型，可选参数。 示例： coord_type= bd09ll 允许的值为： bd09ll（百度经纬度坐标） bd09mc（百度墨卡托坐标） gcj02（经国测局加密的坐标) wgs84（gps获取的原始坐标）	可选	如开发者不传递正确的坐标类型参数，会导致地点坐标位置偏移。默认为bd09经纬度坐标。 坐标类型说明。
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地图,详情页面见下图。

参数说明

参数名称	参数说明	是否必选	备注
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地图,详情页面见下图。

参数说明

参数名称	参数说明	是否必选	备注
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	坐标类型，必选参数。 示例： coord_type= bd09ll 允许的值为： 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=2fd2beabe34a80517adbd220&output=html&src=webapp.baidu.openAPIdemo //调起百度PC或Web地图

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

参数说明

参数名称	参数说明	是否必选	备注
uid	POI的ID	必选
output	表示输出类型，web上必须指定为html才能展现地图产品结果。	必选	手机客户端忽略此参数
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。	必选	此参数不传值，不保证服务。