Web版百度地图面向PC&移动端浏览器的网站应用或移动APP应用,其中PC浏览器调起的百度地图地址为:http://map.baidu.com/ ;移动端调起的百度地图地址为:http://map.baidu.com/mobile/。
百度地图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.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地图,显示页面如下图:
参数说明
参数名称 | 参数说明 | 是否必选 | 备注 |
---|---|---|---|
address | 地址名称 | 必选 | |
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®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。 | 必选 | 此参数不传值,不保证服务。 |
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<右上角> |
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®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。 | 必选 | 此参数不传值,不保证服务。 |
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/place/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。 | 必选 | 此参数不传值,不保证服务。 |
上一篇
下一篇
本篇文章对您是否有帮助?