简介
移动设备浏览器端应用和移动App应用均可调起iOS版百度地图。
协议形式
无论是基于移动浏览器端的应用开发还是基于iOS SDK的应用开发均可采用如下协议调起iOS版百度地图。该协议要正确执行除了要参数填写正确外,还必须要安装iOS百度地图。
protocol://product/[service/]action[?parameters] //parameters功能参数定义,具体规范见功能协议说明
示例
baidumap://map/direction?origin=中关村&destination=五道口&mode=driving®ion=北京 //本示例是通过该URL启动地图app并进入北京市从中关村到五道口的驾车导航路线图
组成说明
参数名称 | 参数说明 | 是否必选 | 备注 |
---|---|---|---|
protocol | 产品线协议头,例如baidumap表示百度地图 | 必选 | |
product | 产品线名称,例如如百度地图客户端(map) | 必选 | product下可直接跟方法,当然产品线也可增加一个service级别 |
service | 具体功能服务名称,如POI检索服务(place) | 必选 | |
action | 方法名称,如POI检索中的详情检索(detail) | 必选 | |
parameters | 方法参数,参考各个功能协议说明的定义 | 必选 |
接口功能文档
标注
调用该接口可调起IOS百度地图,且在指定坐标点上显示点的名称和内容信息。
服务地址
baidumap://map/marker //iOS服务地址
示例
//网页应用调起iOS百度地图方式举例 <a href="baidumap://map/marker?location=40.047669,116.313082&title=我的位置&content=百度奎科大厦&src=webapp.marker.yourCompanyName.yourAppName">地图标点</a>
调用效果如下:
参数说明
参数名称 | 参数说明 | 是否必选 | 备注 |
---|---|---|---|
location | lat<纬度>,lng<经度> | 必选 | |
title | 标注点显示标题 | 必选 | product下可直接跟方法,当然产品线也可增加一个service级别 |
content | 标注点显示内容 | 必选 | |
coord_type | 坐标类型,可选参数,默认为bd09ll。 | 可选 | 允许的值为bd09ll、gcj02、wgs84。bd09ll表示百度经纬度坐标, gcj02表示经过国测局坐标,wgs84表示gps获取的坐标。 |
zoom | 展现地图的级别,默认为视觉最优级别。 | 可选 | |
src | 来源说明,规则:webapp.marker.yourCompanyName.yourAppName | 必选 | 此参数不传值,不保证服务。 |
地址解析
调用该接口可以在调起百度地图时,当前页面显示地址对应的坐标点。
服务地址
baidumap://map/geocoder // iOS服务地址
示例
//网页应用调起iOS百度地图方式举例 <a href="baidumap://map/geocoder?address=北京市海淀区上地信息路9号奎科科技大厦&src=webapp.geo.yourCompanyName.yourAppName">地理编码</a>
调起效果如左下图,点击地图进入右图:
参数说明
参数名称 | 参数说明 | 是否必选 | 备注 |
---|---|---|---|
address | 地址名称 | 必选 | |
zoom | 展现地图的级别,默认为视觉最优级别。 | 可选 | |
src | 来源说明,规则:webapp.geo.yourCompanyName.yourAppName | 必选 | 此参数不传值,不保证服务。 |
反向地址解析(地址查询)
调用该接口可调起iOS百度地图,经过逆地理编码后,以标注形式显示位置和地址信息。
服务地址
baidumap://map/geocoder // iOS服务地址
示例
//网页应用调起iOS百度地图方式举例 <a href="baidumap://map/geocoder?location=39.990912172420714,116.32715863448607&coord_type=gcj02&src=webapp.rgeo.yourCompanyName.yourAppName">逆地理编码>/a>
调起效果如左下图,单击地图进入右图:
参数说明
参数名称 | 参数说明 | 是否必选 | 备注 |
---|---|---|---|
location | lat<纬度>,lng<经度> | 必选 | |
coord_type | 坐标类型,可选参数,默认为bd09经纬度坐标。 | 可选 | 允许的值为bd09ll、gcj02、wgs84。bd09ll表示百度经纬度坐标, gcj02表示经过国测局加密的坐标,wgs84表示gps获取的坐标。 |
zoom | 展现地图的级别,默认为视觉最优级别。 | 可选 | |
src | 调用来源,规则:webapp.rgeo.yourCompanyName.yourAppName | 必选 | 此参数不传值,不保证服务。 |
POI(地点)搜索
服务地址
baidumap://map/place/search // iOS服务地址
示例
<a href="baidumap://map/place/search?query=%E9%A4%90%E9%A6%86&location=31.204055632862,121.41117785465&radius=1000®ion=上海&src=webapp.poi.yourCompanyName.yourAppName">周边检索</a>
调起效果左下图,单击地图进入右图。
参数说明
参数名称 | 参数说明 | 是否必选 | 备注 |
---|---|---|---|
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<右上角> |
coord_type | 坐标类型,可选参数,默认为bd09经纬度坐标。允许的值为bd09ll、bd09mc、gcj02、wgs84。bd09ll表示百度经纬度坐标,bd09mc表示百度墨卡托坐标,gcj02表示经过国测局加密的坐标,wgs84表示gps获取的坐标。 | 可选 | |
zoom | 展现地图的级别,默认为视觉最优级别。 | 可选 | |
src | 调用来源,规则:webapp.poi.yourCompanyName.yourAppName | 必选 | 此参数不传值,不保证服务。 |
POI详情页展示
服务地址
baidumap://map/place/detail // iOS服务地址
示例
//网页应用调起iOS百度地图方式举例 <a href="baidumap://map/place/detail?uid=d3099bdd81c525dbd1f49ee6&src=webapp.detail.yourCompanyName.yourAppName">详情检索</a>
调起iOS百度地图进行查询效果如下:
参数说明
参数名称 | 参数说明 | 是否必选 | 备注 |
---|---|---|---|
uid | POI的ID | 必选 | |
zoom | 展现地图的级别,默认为视觉最优级别。 | 可选 | |
src | 调用来源,规则:webapp.detail.yourCompanyName.yourAppName | 必选 | 此参数不传值,不保证服务。 |
公交、地铁线路查询
服务地址
baidumap://map/line // iOS服务地址
示例
//网页应用调起iOS百度地图方式举例 <a href="baidumap://map/line?region=北京&name=518&src=webapp.line.yourCompanyName.yourAppName">线路检索</a>
调起效果如左下图,单击地图后进入右下图
参数说明
参数名称 | 参数说明 | 是否必选 | 备注 |
---|---|---|---|
region | 城市名或县名 | 必选 | |
name | 线路名称 | 必选 | |
zoom | 展现地图的级别,默认为视觉最优级别。 | 可选 | |
src | 调用来源,规则:webapp.line.yourCompanyName.yourAppName | 必选 | 此参数不传值,不保证服务。 |
公交、驾车、步行、骑行路线规划
调起iOS百度地图,展示指定出行模式下从起点到终点的路线规划。
服务地址
baidumap://map/direction // iOS服务地址
示例
//网页应用调起iOS百度地图方式举例 <a href="baidumap://map/direction?origin=34.264642646862,108.95108518068&destination=40.007623,116.360582&mode=driving&src=webapp.navi.yourCompanyName.yourAppName">驾车导航</a>
调起效果如下:
参数说明
参数名称 | 参数说明 | 是否必选 | 备注 |
---|---|---|---|
origin | 起点名称或经纬度,或者可同时提供名称和经纬度,此时经纬度优先级高,将作为导航依据,名称只负责展示。 | 必选 | 1、名称:天安门
2、经纬度:39.98871<纬度>,116.43234<经度>。 3、名称和经纬度:name:天安门|latlng:39.98871,116.43234 |
destination | 终点名称或经纬度,或者可同时提供名称和经纬度,此时经纬度优先级高,将作为导航依据,名称只负责展示。 | 必选 | 同上 |
mode | 导航模式,固定为transit、driving、navigation、walking,riding分别表示公交、驾车、导航、步行和骑行 | 必选 | |
region | 城市名或县名 | 当给定region时,认为起点和终点都在同一城市,除非单独给定起点或终点的城市。 | |
origin_region | 起点所在城市或县 | 同上 | |
destination_region | 终点所在城市或县 | 同上 | |
coord_type | 坐标类型,可选参数,默认为bd09ll。 | 可选 | 允许的值为bd09ll、bd09mc、gcj02、wgs84。bd09ll表示百度经纬度坐标,bd09mc表示百度墨卡托坐标,gcj02表示经过国测局加密的坐标,wgs84表示gps获取的坐标。 |
zoom | 展现地图的级别,默认为视觉最优级别。 | 可选 | |
src | 调用来源,规则:webapp.navi.yourCompanyName.yourAppName | 必选 |
驾车导航
调起iOS百度地图,直接进入驾车导航模式。
服务地址
baidumap://map/navi//iOS服务地址(基于iOS SDK应用开发) bdapp://map/navi//iOS服务地址(基于浏览器端应用开发)
示例
//网页应用调起iOS百度地图方式举例 <a href="baidumap://map/navi?location=40.057023, 116.307852&src=push&type=BLK&src=webapp.line.yourCompanyName.yourAppName">驾车导航</a>
参数说明
参数名称 | 参数说明 | 是否必选 | 备注 |
---|---|---|---|
location | 坐标点 | 可选 | location与query二者必须有一个,当有location时,忽略query |
coord_type | 可选 | ||
query | 搜索key | 可选 | 同上 |
type | 路线规划类型 | 可选 | BLK:躲避拥堵(自驾);TIME:最短时间(自驾);DIS:最短路程(自驾);FEE:少走高速(自驾);DEFAULT:推荐(自驾,地图app不选择偏好);默认:地图app所选偏好 |