uexBaiduMap查看3.0文档

接入指引部分:

1、简介

提供百度地图的相关相关功能.用户可以使用该插件在网页上嵌入一张地图,并实现对地图的基本操作, 例如放大缩小,移动,点击,隐藏,显示.另外还提供了定位功能,搜索功能,路线规划功能,地理编码功能 .

本文的目的是为了开发能够更好更快地将API集成到自己的项目中,在使用前最好先使用好我们提供的demo并对照文档运行看看效果。
这里可以【参考教程】下载AppCan IDE为开发者工具开发,然后集成到自己的项目上。

1.1、说明

安卓&iOS插件已支持config.xml文件配置AK.

注:IDE插件因为涉及到百度方面的ID与Key暂时无法使用,此插件之前需要进行config.xml相关配置,具体使用点击查看:附录----->百度地图插件接入指引

1.2、UI展示

1.3、公告

安卓百度定位sdk升级,配合安卓打包服务升级,插件已经跟新至最新版本,已经公测通过,请使用最新版本(已支持config.xml文件配置AK) 旧版uexBaiduMap 插件已经下架,官方不再维护,如需使用,请跳转到详细官方通告

1.4、开源源码

点击插件中心至插件详情页(插件测试用例与插件源码已经提供)

1.5、平台版本支持

本插件的所有API默认支持Android4.0+iOS7.0+操作系统.
有特殊版本要求的API会在文档中额外说明.

1.6、接口有效性

本插件所有API默认在插件版本4.0.0+可用.
在后续版本中新添加的接口会在文档中额外说明.

2、API概览

2.1、方法
open //打开地图

uexBaiduMap.open(x,y,width,height,longitude,latitude, callbackFunction)

说明

在界面的指定位置显示地图, 成功显示地图后会回调callbackFunction

参数

参数名称 参数类型 是否必选 说明
x Number x坐标
y Number y坐标
width Number 地图宽度
height Number 地图高度
longitude Number 地图中心点经度
latitude Number 地图中心点纬度
callbackFunction Function 地图打开后的回调
  • x,y,width,height 的单位均为px
  • (x,y)表示地图左上角的坐标

示例

uexBaiduMap.open(10,100,480,640,"116.309","39.977", function(){
    console.log('------->open success');
});
close //关闭地图

uexBaiduMap.close()

说明

关闭地图

参数

示例

uexBaiduMap.close();
hideMap //隐藏地图

uexBaiduMap.hideMap()

说明

隐藏地图

参数

示例

uexBaiduMap.hideMap();
showMap //显示地图

uexBaiduMap.showMap()

说明

显示地图

参数

示例

uexBaiduMap.showMap();
setMapType //设置地图的类型

uexBaiduMap.setMapType(type)

说明

设置地图的类型

参数

参数名称 参数类型 是否必选 说明
type Number 地图的类型(1-标准地图,2-卫星地图)

示例

uexBaiduMap.setMapType(1);
setTrafficEnabled //开启或关闭交通图

uexBaiduMap.setTrafficEnabled(type)

说明

开启或关闭交通图

参数

参数名称 参数类型 是否必选 说明
type Number 0-关闭,1-开启

示例

uexBaiduMap.setTrafficEnabled(1);
setCenter //设置地图的中心点

uexBaiduMap.setCenter(longitude,latitude)

说明

设置地图的中心点经纬度,地图会移动使此点成为地图的中心点

参数

参数名称 参数类型 是否必选 说明
longitude Number 中心点经度
latitude Number 中心点纬度

示例

uexBaiduMap.setCenter(121.481,31.227);
getCenter //获取地图的中心点

uexBaiduMap.getCenter()

说明

得到当前地图的中心点经纬度

参数

返回值

获取成功后,返回值是JSON对象,格式如下:

{
    longitude:,
    latitude:
}

如果失败,返回null

示例

var data = uexBaiduMap.getCenter();
alert('data:' + JSON.stringify(data));
setZoomLevel //设置地图的比例级别

uexBaiduMap.setZoomLevel(zoomLevel)

说明

设置地图的比例级别

参数

参数名称 参数类型 是否必选 说明
zoomLevel Number 地图的缩放级别 范围:3~19,数值越大越精确

示例

uexBaiduMap.setZoomLevel(10);
zoomIn //放大一个地图级别

uexBaiduMap.zoomIn()

说明

放大一个地图级别

参数

示例

uexBaiduMap.zoomIn();
zoomOut //缩小一个地图级别

uexBaiduMap.zoomOut()

说明

缩小一个地图级别

参数

示例

uexBaiduMap.zoomOut();
rotate //旋转地图

uexBaiduMap.rotate(angle)

说明

旋转地图

参数

参数名称 参数类型 是否必选 说明
angle Number 旋转地图的角度,旋转角范围:-180~180,单位:度,逆时针旋转

示例

uexBaiduMap.rotate(90);
overlook //俯视地图

uexBaiduMap.overlook(angle)

说明

俯视地图

参数

参数名称 参数类型 是否必选 说明
angle Number 俯视地图的角度,俯角范围:-45~0,单位:度

示例

uexBaiduMap.overlook(-30);
setZoomEnable //开启或关闭缩放

uexBaiduMap.setZoomEnable(type)

说明

开启或关闭缩放

参数

参数名称 参数类型 是否必选 说明
type Number 0-关闭,1-开启

示例

uexBaiduMap.setZoomEnable(1);
setRotateEnable //开启或关闭旋转

uexBaiduMap.setRotateEnable(type)

说明

开启或关闭旋转

参数

参数名称 参数类型 是否必选 说明
type Number 0-关闭,1-开启

示例

uexBaiduMap.setRotateEnable(1);
setCompassEnable //开启或关闭指南针

uexBaiduMap.setCompassEnable(type)

说明

开启或关闭指南针

参数

参数名称 参数类型 是否必选 说明
type Number 0-关闭,1-开启

示例

uexBaiduMap.setCompassEnable(1);
setScrollEnable //开启或关闭平移

uexBaiduMap.setScrollEnable(type)

说明

开启或关闭平移

参数

参数名称 参数类型 是否必选 说明
type Number 0-关闭,1-开启

示例

uexBaiduMap.setScrollEnable(1);
setOverlookEnable //开启或关闭俯视

uexBaiduMap.setOverlookEnable(type)

说明

开启或关闭俯视

参数

参数名称 参数类型 是否必选 说明
type Number 0-关闭,1-开启

示例

uexBaiduMap.setOverlookEnable(1);
addMarkersOverlay //添加标注

uexBaiduMap.addMarkersOverlay(json);

说明

添加标注, 注意:json是String类型,需要将对象JSON.stringify()

参数

参数名称 参数类型 是否必选 说明
json String 添加到地图的标注信息的集合.该字符串为JSON格式.如下:
var json=[
    {
        id:,
        longitude:,
        latitude:,
        icon:,
        bubble:{
             title:,
             bgImage:
        } 
    }
]

各字段含义如下

参数 参数类型 是否必选 说明
id String 唯一标识符,不传时插件随机生成
longitude Number 经度
latitude Number 纬度
icon String 标注图标路径,支持类型:"res://""http://"
bubble String 自定义弹出气泡
title String 自定义弹出气泡标题
bgImage String 自定义弹出气泡背景图片,格式:res://btn.png

返回值

返回id组成的一个数组,如果添加失败返回为空

示例

var data = [
        {
        id:"10001",
        longitude:"116.400244",
        latitude:"39.963175",
        icon:"http://www.iconpng.com/png/mapmarkers/marker_inside_azure.png",
         bubble:{
            title:"title1"
     }
        },
        {
        id:"10002",
        longitude:"116.369199",
        latitude:"39.942821",
        bubble:{
            title:"title2",
            bgImage:"res://btn.png"
            }
},
        {
        id:"111",
        longitude:"116.404",
        latitude:"39.915",
        icon:"http://www.iconpng.com/png/mapmarkers/marker_inside_azure.png",
        bubble:{
            title:"title3",
            bgImage:"res://btn.png"
            }
        }
 ];
var ids=uexBaiduMap.addMarkersOverlay(JSON.stringify(data));
if(!ids){
    alert("添加失败");
}
setMarkerOverlay //更新设置标注信息

uexBaiduMap.setMarkerOverlay(makerId,makerInfo);

说明

更新设置标注信息

参数

参数 参数类型 是否必选 说明
makerId String 唯一标识符
makerInfo String 标注信息,json格式,形式见下:
var makerInfo={
    longitude:,
    latitude:,
    icon:,
    bubble:{
        title:,
        bgImage:
    }
}

各字段含义如下:

字段名称 类型 是否必选 说明
longitude Number 标注经度
latitude Number 标注纬度
icon String 标注图标
bubble Object 气泡设置
title String 气泡标题
bgImage String 气泡背景图片

示例

var makerInfo ={
    bubble:{
        bgImage: "res://btn.png",
        title: "这是标题"
    },
    latitude: "39.021514",
    longitude: "116.232323"    
};
var makerId = '10001';
uexBaiduMap. setMarkerOverlay (makerId, makerInfo);
showBubble //显示标注气泡

uexBaiduMap.showBubble(makerId);

说明

显示指定ID的标注气泡,地图上仅有一个标注气泡显示,其他标注气泡将被隐.

参数

参数 参数类型 是否必选 说明
makerId String 唯一标识符

示例

var makerId = '10001';
uexBaiduMap.showBubble(makerId);
hideBubble //隐藏标注气泡

uexBaiduMap.hideBubble();

说明

当前显示的标注气泡将被隐藏.

参数

示例

uexBaiduMap.hideBubble();
addDotOverlay //添加点覆盖物

uexBaiduMap.addDotOverlay(dotInfo);

说明

添加点覆盖物

参数

参数名称 参数类型 是否必选 说明
dotInfo String 添加到地图上的圆点信息的集合,形式见下:
var dotInfo={
    id:,
    fillColor:,
    radius:,
    longitude:,
    latitude:
}

各字段含义如下

参数 参数类型 是否必须 说明
id String 唯一标识符,不传时插件随机生成
fillColor String 圆点颜色,支持格式:"#000","#000000"
radius Number 圆点半径,单位:像素
longitude Number 圆点经度
latitude Number 圆点纬度

返回值

返回id,如果添加失败返回为空

示例

var dotInfo={
    fillColor:"#990033",
    id:"150",
    longitude:"116.400244",
    latitude:"39.963175",
    radius:"50"
};
var id=uexBaiduMap.addDotOverlay(dotInfo);
if(!id){
    alert("添加失败");
}
addPolylineOverlay //添加折线覆盖物

uexBaiduMap.addPolylineOverlay(polylineInfo);

说明

添加折线覆盖物

参数

参数名称 参数类型 是否必选 说明
polylineInfo String 添加到地图上的折线信息。该字符串为JSON格式:
var polylineInfo={
    fillColor:,
    lineWidth:,
    property:
        [
            {
                longitude:"116.357428",
                latitude:"39.93923
            },
            {
                longitude:"116.347428",
                latitude:"39.89923"
            }
        ]
    }

各字段含义如下

参数 参数类型 是否必须 说明
id String 唯一标识符,不传时插件随机生成
fillColor String 折线颜色,支持格式:"#000","#000000"
lineWidth Number 折线线宽,单位:像素
property Array 连接点经纬度集合
longitude Number 连接点经度
latitude Number 连接点纬度

返回值

返回id,如果添加失败返回为空

示例

var polylineInfo=
    {
    fillColor:"#990033",
    id:"151",
    lineWidth:"10.0",
    property:
        [
            {
                longitude:"116.357428",
                latitude:"39.93923"
            },
            {
                longitude:"116.401394",
                latitude:"39.942821"
            },
            {
                longitude:"116.347428",
                latitude:"39.89923"
            }
        ]
    };
var id=uexBaiduMap.addPolylineOverlay(polylineInfo);
if(!id){
    alert("添加失败");
}
addArcOverlay //添加弧形覆盖物

uexBaiduMap.addArcOverlay(arcInfo);

说明

添加弧形覆盖物

参数

参数名称 参数类型 是否必选 说明
arcInfo String 添加到地图上的弧形信息。该字符串为JSON格式:
var arcInfo={
    strokeColor:,
    lineWidth:,
    startLongitude:,
    startLatitude:,
    centerLongitude:,
    centerLatitude:,
    endLongitude:,
    endLatitude:
}

各字段含义如下

参数 参数类型 是否必须 说明
id String 唯一标识符,不传时插件随机生成
strokeColor String 颜色,支持格式:"#000","#000000"
lineWidth Number 线宽
startLongitude Number 起点经度
startLatitude Number 起点纬度
centerLongitude Number 中点经度
centerLatitude Number 中点纬度
endLongitude Number 终点经度
endLatitude Number 终点纬度

返回值

返回id,如果添加失败返回为空

示例

var data={
    centerLatitude:"39.942821",
    centerLongitude:"116.369199",
    endLatitude:"39.906965",
    endLongitude:"116.401394",
    id:"152",
    lineWidth:"2.0",
    startLatitude:"39.963175",
    startLongitude:"116.400244",
    strokeColor:"#990033"
};
var id=uexBaiduMap.addArcOverlay(data); 
if(!id){
    alert("添加失败");
}
addCircleOverlay //添加圆形覆盖物

uexBaiduMap.addCircleOverlay(circleInfo);

说明

添加圆形覆盖物

参数

参数名称 参数类型 是否必选 说明
circleInfo String 添加到地图上的圆形覆盖物信息。该字符串为JSON格式
var circleInfo={
    longitude:,
    latitude:,
    radius:"1000",
    fillColor:"#4169E1",
    strokeColor:"#990033",
    lineWidth:"4"
}

各字段含义如下

参数 参数类型 是否必须 说明
id String 唯一标识符,不传时插件随机生成
radius Number 半径,单位:米
fillColor String 填充颜色,支持格式:"#000","#000000"
strokeColor String 边框颜色,支持格式:"#000","#000000"
lineWidth Number 边框宽度
longitude Number 圆心经度
latitude Number 圆心纬度

返回值

返回id,如果添加失败返回为空

示例

var data={
    fillColor:"#4169E1",
    id:"153",latitude:"39.915",
    lineWidth:"4",
    longitude:"116.404",
    radius:"1000",
    strokeColor:"#990033"
};
var id=uexBaiduMap.addCircleOverlay(data); 
if(!id){
    alert("添加失败");
}
addPolygonOverlay //添加几何图形覆盖物

uexBaiduMap.addPolygonOverlay(polygonInfo);

说明

向添加几何图形覆盖物

参数

参数名称 参数类型 是否必选 说明
polygonInfo String 添加到地图上的集合图形信息的集合。该字符串为JSON格式
var polygonInfo={
    fillColor:,
    strokeColor:,
    lineWidth:,
    property:
        [
            {
            longitude:,
            latitude:
            },
        ]
}

各字段含义如下

参数 参数类型 是否必须 说明
id String 唯一标识符,不传时插件随机生成
fillColor String 填充颜色,支持格式:"#000","#000000"
strokeColor String 边框颜色,支持格式:"#000","#000000"
lineWidth Number 边框宽度
property Array 连接点经纬度数组
longitude Number 连接点经度
latitude Number 连接点纬度

返回值

返回id,如果添加失败返回为空

示例

var data={
    fillColor:"#990033",
    id:"154",
    lineWidth:"2.0",
    property:[
        {
            latitude:"39.93923",
            longitude:"116.357428"
        },
        {
            latitude:"39.91923",
            longitude:"116.327428"
        },
        {
            latitude:"39.89923",
            longitude:"116.347428"
        },
        {
            latitude:"39.89923",
            longitude:"116.367428"
        }
    ],
    strokeColor:"#990033"
};
var id=uexBaiduMap.addPolygonOverlay(data); 
if(!id){
    alert("添加失败");
}
addGroundOverlay //添加地形图图层覆盖物

uexBaiduMap.addGroundOverlay(groundInfo);

说明

添加地形图图层覆盖物

参数

参数名称 参数类型 是否必选 说明
groundInfo String 添加到地图上的地形图图层信息。该字符串为JSON格式如下:
var groundInfo={
    imageUrl:,
    transparency:,
    imageWidth:,
    imageHeight:,
    property:
        [
            {
                longitude:,
                latitude:
            }
        ]
}

各字段含义如下

参数 参数类型 是否必须 说明
id String 唯一标识符,不传时插件随机生成
imageUrl String 图片路径,支持格式:"http://","res://"
transparency Number 透明度,范围:[0.0f,1.0f]
property Array 地理位置数组,长度为2
longitude Number 经度
latitude Number 纬度
imageWidth Number 是(property数组长度为1时)否(property数组长度为2时) 图片宽度,单位:米
imageHeight Number 图片高度,单位:米

返回值

返回id,如果添加失败返回为空

示例

var data={
    id:"155",
    imageHeight:"5000",
    imageUrl:"http://img0.bdstatic.com/img/image/9baf75d938553886ce515def29441ed31409109131.jpg",
    imageWidth:"10000",
    property:[
        {
            longitude:"116.380338",
            latitude:"39.92235"
        },
        {
            longitude:"116.414977",
            latitude:"39.947246"
        }
    ],
    transparency:"0.8"
    };
var id=uexBaiduMap.addGroundOverlay(data);
if(!id){
    alert("添加失败");
}
addTextOverlay //添加文字覆盖物

uexBaiduMap.addTextOverlay(textInfo);

说明

添加文字覆盖物

参数

参数名称 参数类型 是否必选 说明
textInfo String 添加到地图上的文字覆盖物信息。该字符串为JSON格式如下:
var textInfo = {
    bgColor:,
    fontSize:,
    fontColor:,
    text:,
    rotate:,
    longitude:,
    latitude:
}

各字段含义如下

参数 参数类型 是否必须 说明
id String 唯一标识符,不传时插件随机生成
bgColor String 文字背景,支持格式:"#000","#000000"
fontSize Number 字体大小
fontColor String 字体颜色,支持格式:"#000","#000000"
text String 文字内容
longitude Number 经度
latitude Number 纬度
rotate Number 文字旋转角度(逆时针),旋转角范围:-180~180,单位:度

返回值

返回id,如果添加失败返回为空

示例

var data={
    bgColor: "#FFFF00",
    fontSize: "24",
    id: "156",
    longitude: "116.400244",
    latitude: "39.963175",
    rotate: "-30",
    text: "baidu map"
};
var id=uexBaiduMap.addTextOverlay(data);
if(!id){
    alert("添加失败");
}
removeMakersOverlay //移除标注

uexBaiduMap.removeMakersOverlay(ids);

说明

移除地图上对应标识的覆盖物

参数

参数 参数类型 是否必须 说明
ids String 唯一标识符数组,json结构字符串

示例

 var ids='["150","151"]';
 uexBaiduMap.removeMakersOverlay(ids);
removeOverlay //移除覆盖物

uexBaiduMap.removeOverlay(id);

说明

移除地图上对应标识的覆盖物

参数

参数 参数类型 是否必须 说明
id String 唯一标识符

示例

 uexBaiduMap.removeOverlay("150");
poiSearchInCity //城市内检索

uexBaiduMap.poiSearchInCity(json, callbackFunction);

说明

根据单个关键字在指定城市内搜索兴趣点, 搜索完成后回调callbackFunction

参数

参数名称 参数类型 是否必选 说明
json String 搜索所需要的信息.该字符串为JSON格式,形式见下:
callbackFunction Function 搜索结果的回调方法
var json={
    city:,
    searchKey:,
    pageNum:
}

各字段含义如下

参数 是否必须 说明
city 城市
searchKey 关键字
pageNum 结果页索引

回调参数:

var callbackFunction = function(error,data){}
参数名称 参数类型 说明
error Number 搜索结果,0-成功,非0-失败
data Object 成功时返回的数据,形式见下:
var data = {
    totalPoiNum:,
    totalPageNum:,
    currentPageNum:,
    currentPageCapacity:,
    poiInfo:[
        {
            uid:,
            poiType:,
            phoneNum:,
            address:,
            name:,
            longitude:,
            latitude:,
            distance:,
            city:,
            postCode:
        }
    ]
}

各字段含义如下

参数 是否必须 说明
poiInfo POI信息集合
longitude 经度
latitude 纬度
distance 距离
name 名称
uid 唯一标识符
address 地址
city 城市
phoneNum 电话
postCode 邮编
poiType 类型(POI类型,0:普通点1:公交站2:公交线路3:地铁站4:地铁线路)
totalPoiNum 总结果数
totalPageNum 总页数
currentPageNum 当前页
currentPageCapacity 当前页的poi结果数

示例

var data={
    city: "北京",
    searchKey: "114",
    pageNum: "0"
};
uexBaiduMap.poiSearchInCity(data, function(error,data) {
    alert(JSON.stringify(data));
});
poiNearbySearch //周边检索

uexBaiduMap.poiNearbySearch(json, callbackFunction);

说明

根据单个关键字在指定的中心点和半径范围内搜索兴趣点

参数

参数名称 参数类型 是否必选 说明
json String 搜索所需要的信息.该字符串为JSON格式,形式见下:
callbackFunction Function 搜索结果的回调方法
var json={
    longitude:,
    latitude:,
    radius:,
    searchKey:,
    pageNum:
}

各字段含义如下

参数 是否必须 说明
longitude 经度
latitude 纬度
radius 半径值,单位米
searchKey 关键字
pageNum 结果页索引

回调参数:

var callbackFunction = function(error,data){}
参数名称 参数类型 说明
error Number 搜索结果,0-成功,非0-失败
data Object 成功时返回的数据,形式见下:
var data = {
    totalPoiNum:,
    totalPageNum:,
    currentPageNum:,
    currentPageCapacity:,
    poiInfo:[
        {
            uid:,
            poiType:,
            phoneNum:,
            address:,
            name:,
            longitude:,
            latitude:,
            distance:,
            city:,
            postCode:
        }
    ]
}

各字段含义如下

参数 是否必须 说明
poiInfo POI信息集合
longitude 经度
latitude 纬度
distance 距离
name 名称
uid 唯一标识符
address 地址
city 城市
phoneNum 电话
postCode 邮编
poiType 类型(POI类型,0:普通点1:公交站2:公交线路3:地铁站4:地铁线路)
totalPoiNum 总结果数
totalPageNum 总页数
currentPageNum 当前页
currentPageCapacity 当前页的poi结果数

示例

var data ={
    longitude: "116.309",
    latitude: "39.977",
    radius: "1000",
    searchKey: "电影院",
    pageNum: "0"
};
uexBaiduMap.poiNearbySearch (jsonStr, function(error,data) {
    alert(JSON.stringify(data));
});
poiBoundSearch //区域检索

uexBaiduMap.poiBoundSearch(json, callbackFunction);

说明

根据单个关键字在指定的矩形区域内搜索兴趣点

参数

参数名称 参数类型 是否必选 说明
json String 搜索所需要的信息.该字符串为JSON格式,形式见下:
callbackFunction Function 搜索结果的回调方法
var json={
    searchKey:,
    pageNum:,
    northeast:{
        longitude:,
        latitude:
    },
    southwest:{
        longitude:,
        latitude:
    }
}

各字段含义如下

参数 是否必须 说明
searchKey 关键字
pageNum 结果页索引
northeast 东北点
southwest 西南点
longitude 经度
latitude 纬度

回调参数:

var callbackFunction = function(error,data){}
参数名称 参数类型 说明
error Number 搜索结果,0-成功,非0-失败
data Object 成功时返回的数据,形式见下:
var data = {
    totalPoiNum:,
    totalPageNum:,
    currentPageNum:,
    currentPageCapacity:,
    poiInfo:[
        {
            uid:,
            poiType:,
            phoneNum:,
            address:,
            name:,
            longitude:,
            latitude:,
            distance:,
            city:,
            postCode:
        }
    ]
}

各字段含义如下

参数 是否必须 说明
poiInfo POI信息集合
longitude 经度
latitude 纬度
distance 距离
name 名称
uid 唯一标识符
address 地址
city 城市
phoneNum 电话
postCode 邮编
poiType 类型(POI类型,0:普通点1:公交站2:公交线路3:地铁站4:地铁线路)
totalPoiNum 总结果数
totalPageNum 总页数
currentPageNum 当前页
currentPageCapacity 当前页的poi结果数

示例

var data={
    searchKey: "电影院",
    pageNum: "0",
    northeast: {
        longitude: "116.326664",
        latitude: "39.991418"
    },
    southwest: {
        longitude: "116.312705",
        latitude: "39.981730"
    }
};
uexBaiduMap.poiBoundSearch(data, function(error,data) {
    alert(JSON.stringify(data));
});
busLineSearch //公交线路检索

uexBaiduMap.busLineSearch(json, callbackFunction);

说明

根据公交线路编号在指定城市范围内搜索公交线路详情, 搜索完成后执行回调函数callbackFunction

参数

参数名称 参数类型 是否必选 说明
json String 搜索所需要的信息.该字符串为JSON格式,形式见下:
callbackFunction Function 搜索结果的回调方法
var json={
    city:,
    busLineName:
}

各字段含义如下

参数 是否必须 说明
city 城市
busLineName 公交名

回调参数:

var callbackFunction = function(error,data){}
参数名称 参数类型 说明
error Number 搜索结果,0-成功,非0-失败
data Object 成功时返回的数据,形式见下:
var data ={
    busLineName:,
    busCompany:,
    startTime:,
    endTime:,
    busStation:[
        {
            title:,
            longitude:,
            latitude:
        }
    ]
}

各字段含义如下

参数 是否必须 说明
busLineName 公交线路名称
busCompany 公交线路所属公司
startTime 首班时间
endTime 末班时间
busStation 站点信息列表
longitude 站点的经度
latitude 站点的纬度
title 站点的名称

示例

var data={
    city: "北京",
    busLineName: "114"
};
uexBaiduMap.busLineSearch(data, function(error,data) {
    alert(JSON.stringify(data));
});
removeBusLine //清除公交线路

uexBaiduMap.removeBusLine();

说明

清除公交线路

参数

示例

uexBaiduMap.removeBusLine();
preBusLineNode //显示上一个公交站点

uexBaiduMap.preBusLineNode();

说明

显示公交线路中当前站点的上一个站点,起始站点无效, 该方法仅Android支持.

参数

示例

uexBaiduMap.preBusLineNode();
nextBusLineNode //显示下一个公交站点

uexBaiduMap.nextBusLineNode();

说明

显示公交线路中当前站点的下一个站点,终点站点无效,该方法仅Android支持.

参数

示例

uexBaiduMap.nextBusLineNode();
searchRoutePlan //规划并显示路线

uexBaiduMap.searchRoutePlan(json, callbackFunction);

说明

根据起点和终点信息搜索并显示路线,信息可以用city和name结合模糊描述,也可以用longitude和latitude结合精确描述,在start和end里面可以出现任意一种结合方式.

参数

参数名称 参数类型 是否必选 说明
json String 规划路线所需要的信息,形式见下:
callbackFunction Function 回调方法
var json={
    id:,
    type:,
    start:{
        city:,
        name:,
        longitude:,
        latitude:
    },
    end:{
        city:,
        name:,
        longitude:,
        latitude:
    }
}

各字段含义如下

参数 是否必须 说明
id 唯一标识符,不传时插件随机生成
type 路线类型:0-驾车;1-公交;2-步行
start 起点信息,JSON格式
end 终点信息,JSON格式
city 城市,必须与name合用
name 地址
longitude 经度,必须与latitude合用
latitude 纬度

回调参数:

var callbackFunction = function(error){}
参数名称 参数类型 说明
error Number 显示结果,0-成功,非0-失败,具体错误码见下:
错误码 说明
0 检索结果正常返回
1 检索词有岐义
2 检索地址有岐义
3 该城市不支持公交搜索
4 不支持跨城市公交
5 没有找到检索结果
6 起终点太近
7 key错误
8 网络连接错误
9 网络连接超时
10 还未完成鉴权,请在鉴权通过后重试
11 室内图ID错误
12 室内图检索楼层错误

返回值

返回id

示例

var data = {
    id: "rp345",
    type: "0",
    start: {
        city: "北京",
        name: "天安门"
    },
    end:{
        city: "北京",
        name: "百度大厦",
        longitude: "116.307827",
        latitude: "40.056957"
    }
};
var id=uexBaiduMap.searchRoutePlan(data,function(error){
  if(!error){
    alert("成功");
  }
});
alert(id);
preRouteNode //显示上一个线路节点

uexBaiduMap.preRouteNode();

说明

显示线路规划中当前节点的上一个节点,起始节点无效,该方法仅Android支持.

参数

示例

 uexBaiduMap.preRouteNode();
removeRoutePlan //清除线路规划

uexBaiduMap.removeRoutePlan(id);

说明

清除线路规划

参数

参数 参数类型 是否必须 说明
id String 线路id

示例

 uexBaiduMap.removeRoutePlan("rp345");
nextRouteNode //显示下一个线路节点

uexBaiduMap.nextRouteNode();

说明

显示线路规划中当前节点的下一个节点,终点节点无效,该方法仅Android支持.

参数

示例

 uexBaiduMap.nextRouteNode();
geocode //地理编码

uexBaiduMap.geocode(json, callbackFunction)

说明

根据地址获取经纬度信息, 执行完成后,回调callbackFunction.

参数

参数名称 参数类型 是否必选 说明
json String 接口所需要的信息.该字符串为JSON格式,形式见下:
callbackFunction Function 回调方法
var json={
    city:,
    address:
}

各字段含义如下

参数 是否必须 说明
city 城市
address 地址

回调参数:

var callbackFunction=function(error,data){}
参数名称 参数类型 说明
error Number 编码结果,0-成功,非0-失败
data Object 成功时返回的数据,形式见下:
var data = {
    longitude:,
    latitude:
}

示例

var data=
{
    city: "北京",
    address: "东长安街33号"
};

uexBaiduMap.geocode(data, function(error,data) {
    alert(JSON.stringify(data));
});
reverseGeocode //反地理编码

uexBaiduMap.reverseGeocode(json, callbackFunction)

说明

根据经纬度获取地址信息, 执行完成后回调callbackFunction.

参数

参数名称 参数类型 是否必选 说明
json String 接口所需要的信息.该字符串为JSON格式,形式见下:
callbackFunction Function 回调方法
var json = {
  longitude:,
  latitude:
}

各字段含义如下:

参数 是否必须 说明
longitude 经度
latitude 纬度

回调参数:

var callbackFunction=function(error,data){}
参数名称 参数类型 说明
error Number 编码结果,0-成功,非0-失败
data Object 成功时返回的数据,形式见下:
var data = {
    address://地理位置信息
}

示例

var data={
    longitude: "116.307827",
    latitude: "40.056957"
};
uexBaiduMap.reverseGeocode(data, function(error,data) {
    alert(data.address);
});
getCurrentLocation //获取当前位置

uexBaiduMap.getCurrentLocation(callbackFunction)

说明

获取当前的位置信息,仅定位一次,执行完成后回调callbackFunction.

参数

参数名称 参数类型 是否必选 说明
callbackFunction Function 回调方法

回调参数

var callbackFunction=function(error,data){}
参数名称 参数类型 说明
error Number 获取结果,0-成功,非0-失败
data Object 成功时返回的数据,形式见下:
var data = {
    longitude:, //经度
    latitude:,  //纬度
    timestamp:  //时间,格式如"2014-11-2217:46:37"
}

示例

 uexBaiduMap.getCurrentLocation(function(error,data){
     alert(JSON.stringify(data));
 });
startLocation //开始连续定位

uexBaiduMap.startLocation()

说明

开始连续定位

参数

示例

 uexBaiduMap.startLocation();
stopLocation //停止连续定位

uexBaiduMap.stopLocation()

说明

停止连续定位

参数

示例

 uexBaiduMap.stopLocation();
setMyLocationEnable //显示或隐藏用户位置

uexBaiduMap.setMyLocationEnable(type)

说明

显示或隐藏用户位置

参数

参数 参数类型 是否必须 说明
type Number 显示或隐藏用户位置(0-隐藏,1-显示)

示例

 uexBaiduMap.setMyLocationEnable(1);
setUserTrackingMode //设置跟踪模式

uexBaiduMap.setUserTrackingMode(mode)

说明

设置定位时的跟踪模式

参数

参数 参数类型 是否必须 说明
mode Number 跟踪模式(0-----普通定位模式,1-----跟随模式,2-----罗盘模式

示例

 uexBaiduMap.setUserTrackingMode(0);
zoomControlsEnabled //显示或隐藏缩放控件

uexBaiduMap.zoomControlsEnabled(mode)

说明

显示或隐藏缩放控件

参数

参数 参数类型 是否必须 说明
mode Number 控件状态(0—隐藏,1—显示)

示例

uexBaiduMap.zoomControlsEnabled(0)
getDistance //获取两点之间距离

uexBaiduMap.getDistance(lat1,lon1,lat2,lon2)

说明

通过经纬度计算两点之间的距离

参数

参数 参数类型 是否必须 说明
lat1 Number 第一个坐标纬度
lon1 Number 第一个坐标经度
lat2 Number 第二个坐标纬度
lon2 Number 第二个坐标经度

返回值 Number类型,两点之间距离值.

示例

var distance = uexBaiduMap.getDistance(lat1,lon1,lat2,lon2);
2.2、监听方法
onMapClickListener //点击地图的监听方法

uexBaiduMap.onMapClickListener(data)

参数

data:(String类型) 必选 经纬度,该字符串为JSON格式
var data={
    longitude:,
    latitude:
}

各字段含义如下

参数 是否必须 说明
longitude 经度
latitude 纬度
onMapDoubleClickListener //双击地图的监听方法

uexBaiduMap.onMapDoubleClickListener(data)

参数

同onMapClickListener

onMapLongClickListener //长按地图的监听方法

uexBaiduMap.onMapLongClickListener(data)

参数

同onMapClickListener

onMapStatusChangeListener //地图状态改变的监听方法

uexBaiduMap.onMapStatusChangeListener(json);

说明:此方法仅支持android

参数

var json = {
    center: { // 地图中心点改变时返回值,回调改变后的中心点坐标
        longitude:, //经度
        latitude:  //纬度
    },
    zoom:{ // 地图缩放级别改变时返回值,回调改变前后的缩放级别
        oldZoom:, // 地图状态改变前的缩放级别
        newZoom: // 地图状态改变后的缩放级别
    }
    overlook: {//地图倾斜度改变时返回值,回调改变前后的倾斜度
        oldOverlook:, // 地图状态改变前的倾斜度
        newOverlook: // 地图状态改变后的倾斜度
    },
    northeast: {//地图东北角坐标改变时返回值,回调改变后的东北角坐标值
        longitude:, // 经度
        latitude: // 纬度
    },
    southwest: {//地图西南角坐标改变时返回值,回调改变后的西南角坐标值
        longitude:, // 经度
        latitude: // 纬度
    },
    rotate: {//地图旋转角度改变时返回值,回调改变前后的旋转角度
        oldRotate:, // 地图状态改变前的旋转角度
        newRotate: // 地图状态改变后的旋转角度
    }
}

示例

uexBaiduMap.onMapStatusChangeListener = function(data){
    alert(data);
}
onMarkerClickListener //点击标注的监听方法

uexBaiduMap.onMarkerClickListener(markerId)

参数

参数 参数类型 是否必须 说明
markerId String 标注的ID

示例

uexBaiduMap.onMarkerClickListener = function(data){
    alert(data);
}
onMarkerBubbleClickListener //点击标注气泡的监听方法

uexBaiduMap.onMarkerBubbleClickListener(markerId)

参数

参数 参数类型 是否必须 说明
markerId String 标注的ID

示例

uexBaiduMap.onMarkerBubbleClickListener = function(data){
    alert(data);
}
onSDKReceiverError //初始化地图时,key非法、网络错误时的监听方法

uexBaiduMap.onSDKReceiverError(data)

参数

data:(String类型) 必选 失败信息  该字符串为JSON格式
var data={
    errorInfo://失败信息
}

示例

uexBaiduMap.onSDKReceiverError = function(data){
    alert(data);
}
onReceiveLocation //开始定位后的监听方法

uexBaiduMap.onReceiveLocation(data)

参数

data:(String类型) 必选 位置信息该字符串为JSON格式
var data={
    longitude:,
    latitude:,
    timestamp:
}

各字段含义如下

参数 是否必须 说明
longitude 经度
latitude 纬度
timestamp 时间戳 "2014-11-2217:46:37"格式

示例

uexBaiduMap.onReceiveLocation = function(data){
    alert(data);
}
onSearchRoutePlan //线路规划搜索结果的监听

uexBaiduMap.onSearchRoutePlan(status)

参数

status:(Number类型) 必选 线路规划搜索结果.0-表示成功,非0-表示失败 示例

uexBaiduMap.onSearchRoutePlan = function(status){
    alert(status);
}
onZoomLevelChangeListener //缩放级别改变时,获取缩放级别和中心点的监听方法

uexBaiduMap.onZoomLevelChangeListener(level,latitude,longitude)

参数

level:(Number类型) 必选 缩放级别
latitude:(Number类型) 必选 中心点纬度
longitude:(Number类型) 必选 中心点经度

示例

uexBaiduMap.onZoomLevelChangeListener = function(data){
    alert(data);
}

3、更新历史

iOS

API版本: uexBaiduMap-4.0.5

最近更新时间:2017-06-08

历史发布版本 更新内容
4.0.5 4:修复bugs
4.0.3 3:修复窗口关闭导致后续的搜索功能异常的问题
4.0.2 2: SDK更新,支持ATS;反地理编码现在可以返回更详细的信息
4.0.1 修复getCurrentLocation回调参数错误的问题
Android

API版本: uexBaiduMap-4.0.3

最近更新时间:2016-12-30

历史发布版本 更新内容
4.0.3 3:reverseGeocode返回详细信息
4.0.2 searchRoutePlan支持function传入
4.0.1 百度地图插件,封装最新的百度地图API

百度地图插件是基于百度地图API封装的AppCan平台的插件模块。此文档适用于百度地图和百度导航2个插件模块。开发者集成及使用此插件,需要到百度开放平台为应用申请相应的APIKey, 并将APIKey配置到应用中。以下是具体步骤。

使用须知:配置的百度地图KEY与打包证书必须一致匹配,配合打包

4、申请成为开发者

访问。http://developer.baidu.com/map/index.php

5、进入API控制台

访问http://lbsyun.baidu.com/apiconsole/key

6、点击"创建应用"

系统将为您弹出创建APIKey页面,输入应用名称,将应用类型改为:“for mobile”,需要配置应用的安全码。

7.Android平台安全码

安全码的组成规则为:Android应用的签名证书的sha1值+“;”+应用包名(即:数字签名信息的sha1值+分号+包名),例如:

75:AC:5D:A2:BC:06:88:74:E5:51:DF:80:33:85:F1:40:E2:DC:4D:75;org.zywx.wbpalmstar.widgetone.uexbaidumap

注意:此签名和包名,必须和应用打包时的签名及包名一致。安卓安全码生成 详见 第9步

8.iOS平台安全码为应用的Bundle Identifier

ios安全码生成 详见 第10步

9.Android打包集成百度插件使用

1) 打包服务器中Android应用使用签名证书的SHA1

默认使用Appcan证书打包为:49:3E:52:87:09:E1:B4:D2:B8:FF:12:6E:2C:C8:40:6D:3B:5E:4D:BB

sha1值获取请参考 签名信息获取工具使用文档 ,也可查看此配置方法

2) 自己定义Android包名必填项) 例如: org.zywx.wbpalmstar.widgetone.uexbaidumap

3) 按照上述步骤,在百度开放平台上申请对应的APIKey。

4) 通过config配置APIKey。 在工程的config.xml文件中加入如下配置:

<config desc="uexBaiduMap" type="KEY" >
    <param platform="Android" name="$uexBaiduMap_APIKey$" value="申请的APIKey"/>
</config>

其中value属性值即为步骤3中申请的APIKey(百度地图中的AK)。

5) 在线打包

uexBaiduMap.onSDKReceiverError回调方法主要用于APIKey是否合法的检测,若APIKey不合法该方法被回调,也即应用的包名、签名和APIKey不匹配。

10、iOS打包集成百度插件使用

1) 使用发布版或企业版证书在打包服务器生成一个应用安装包(例如:testBaiduMap.ipa)

2) 将testBaiduMap.ipa重命名为testBaiduMap.zip,解压后找到info.plist文件,使用《plist Editor》plist文件编辑器打开,找到CFBundleIdentifier这个key对应的值(即Bundle Identifier),例如com.zywx.testBaiduMap。这个值就是申请百度地图APIKey所需要的安全码。(plist Editor下载地址:http://www.pc6.com/softview/SoftView_54561.html#download

3) 按照上述步骤,在百度开放平台上申请对应的APIKey

4) 通过config配置APIKey 在工程的config.xml文件中加入如下配置:

<config desc="uexBaiduMap" type="KEY" >
    <param platform="iOS" name="$uexBaiduMap_APIKey$" value="申请的APIKey"/>
</config>

其中value属性值即为步骤3中申请的APIKey(百度地图中的AK)。

5) 上传第一步的iOS打包证书,然后生成安装包

11、百度插件打包使用常见问题

  • 按照文档操作在百度开放平台申请的key后打开地图还是弹出报错信息。
    • 可能原因
    • 1、你在config.xml里面的key还是与百度申请的百度key不一致,请再次check
    • 2、打包时没有填写自定义包名/证书的bundleId和百度Key不匹配,请确认
还需要帮助吗? 联系我们
最新更新 13th Jun 2017