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 全景服务
百度地图Open API所有接口共分为三类,分别为:图区功能类,搜索功能类和信息显示类。具体的协议形式和参数,见如下说明。
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。不传
此参数,不保证服务。
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。 | 必选 | 此参数不传值,不保证服务。 |
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。 | 必选 | 此参数不传值,不保证服务。 |
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。 | 必选 | 此参数不传值,不保证服务。 |
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=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。 | 必选 | 此参数不传值,不保证服务。 |
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。 | 必选 | 此参数不传值,不保证服务。 |
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=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。 | 必选 | 此参数不传值,不保证服务。 |
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。 | 必选 | 此参数不传值,不保证服务。 |
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。 | 必选 | 此参数不传值,不保证服务。 |