下载文档

API
更新时间:2016-11-10

1、简介

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

1.1、说明

注:IDE插件因为涉及到百度方面的ID与Key暂时无法使用,使用此插件之前需要进行config.xml相关配置且需要在线打包,否则打包失败无法正常使用插件功能,具体使用点击查看:附录——->百度地图插件接入指引

1.2、UI展示

1.3、公告

安卓百度定位sdk升级,配合安卓打包服务升级,插件已经跟新至最新版本,已经公测通过,请使用最新版本(已支持config.xml文件配置AK)

旧版uexBaiduMap 插件已经下架,官方不再维护,如需使用,请跳转到详细官方通告

1.4、开源源码

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

2、API概览

2.1、方法

open 打开地图

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

说明

在界面的指定位置显示地图
回调 cbOpen

参数

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

平台支持

Android2.2+
iOS6.0+

版本支持

3.0.0+

示例

  1. uexBaiduMap.open(10,100,480,640,"116.309","39.977");

close 关闭地图

uexBaiduMap.close()

说明

关闭地图

参数

平台支持

Android2.2+
iOS6.0+

版本支持

3.0.0+

示例

  1. uexBaiduMap.close();

hideMap 隐藏地图

uexBaiduMap.hideMap()

说明

隐藏地图

参数

平台支持

Android2.2+
iOS6.0+

版本支持

3.0.0+

示例

  1. uexBaiduMap.hideMap();

showMap 显示地图

uexBaiduMap.showMap()

说明

显示地图

参数

平台支持

Android2.2+
iOS6.0+

版本支持

3.0.0+

示例

  1. uexBaiduMap.showMap();

setMapType 设置地图的类型

uexBaiduMap.setMapType(type)

说明

设置地图的类型

参数

  1. type:(Number类型) 必选地图的类型(1-标准地图,2-卫星地图)

平台支持

Android2.2+
iOS6.0+

版本支持

3.0.0+

示例

  1. uexBaiduMap.setMapType(1);

setTrafficEnabled 开启或关闭交通图

uexBaiduMap.setTrafficEnabled(type)

说明

开启或关闭交通图

参数

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

平台支持

Android2.2+
iOS6.0+

版本支持

3.0.0+

示例

  1. uexBaiduMap.setTrafficEnabled(1);

setCenter 设置地图的中心点

uexBaiduMap.setCenter(longitude,latitude)

说明

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

参数

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

平台支持

Android2.2+
iOS6.0+

版本支持

3.0.0+

示例

  1. uexBaiduMap.setCenter(121.481,31.227);

setZoomLevel 设置地图的比例级别

uexBaiduMap.setZoomLevel(zoomLevel)

说明

设置地图的比例级别

参数

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

平台支持

Android2.2+
iOS6.0+

版本支持

3.0.0+

示例

  1. uexBaiduMap.setZoomLevel(10);

zoomIn 放大一个地图级别

uexBaiduMap.zoomIn()

说明

放大一个地图级别

参数

平台支持

Android2.2+
iOS6.0+

版本支持

3.0.0+

示例

  1. uexBaiduMap.zoomIn();

zoomOut 缩小一个地图级别

uexBaiduMap.zoomOut()

说明

缩小一个地图级别

参数

平台支持

Android2.2+
iOS6.0+

版本支持

3.0.0+

示例

  1. uexBaiduMap.zoomOut();

rotate 旋转地图

uexBaiduMap.rotate(angle)

说明

旋转地图

参数

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

平台支持

Android2.2+
iOS6.0+

版本支持

3.0.0+

示例

  1. uexBaiduMap.rotate(90);

overlook 俯视地图

uexBaiduMap.overlook(angle)

说明

俯视地图

参数

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

平台支持

Android2.2+
iOS6.0+

版本支持

3.0.0+

示例

  1. uexBaiduMap.overlook(-30);

setZoomEnable 开启或关闭缩放

uexBaiduMap.setZoomEnable(type)

说明

开启或关闭缩放

参数

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

平台支持

Android2.2+
iOS6.0+

版本支持

3.0.0+

示例

  1. uexBaiduMap.setZoomEnable(1);

setRotateEnable 开启或关闭旋转

uexBaiduMap.setRotateEnable(type)

说明

开启或关闭旋转

参数

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

平台支持

Android2.2+
iOS6.0+

版本支持

3.0.0+

示例

  1. uexBaiduMap.setRotateEnable(1);

setCompassEnable 开启或关闭指南针

uexBaiduMap.setCompassEnable(type)

说明

开启或关闭指南针

参数

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

平台支持

Android2.2+
iOS6.0+

版本支持

3.0.0+

示例

  1. uexBaiduMap.setCompassEnable(1);

setScrollEnable 开启或关闭平移

uexBaiduMap.setScrollEnable(type)

说明

开启或关闭平移

参数

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

平台支持

Android2.2+
iOS6.0+

版本支持

3.0.0+

示例

  1. uexBaiduMap.setScrollEnable(1);

setOverlookEnable 开启或关闭俯视

uexBaiduMap.setOverlookEnable(type)

说明

开启或关闭俯视

参数

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

平台支持

Android2.2+
iOS6.0+

版本支持

3.0.0+

示例

  1. uexBaiduMap.setOverlookEnable(1);

addMarkersOverlay 添加标注

uexBaiduMap.addMarkersOverlay(json);

说明

添加标注

参数

  1. json:(String类型) 必选添加到地图的标注信息的集合。该字符串为JSON格式。如下:
  2. var json=[
  3. {
  4. id:,//(必选)唯一标识符
  5. longitude:,//(必选)经度
  6. latitude:,//(必选)纬度
  7. icon:,//(可选)标注图标路径,支持类型:”res://”“http://”
  8. bubble:{//(可选)自定义弹出气泡
  9. title:,//(必选)自定义弹出气泡标题
  10. bgImage://(可选)自定义弹出气泡背景图片,格式:res://btn.png
  11. }
  12. }
  13. ]

各字段含义如下

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

平台支持

Android2.2+
iOS6.0+

版本支持

3.0.0+

示例

  1. var data = [
  2. {
  3. id:"10001",
  4. longitude:"116.400244",
  5. latitude:"39.963175",
  6. icon:"http://www.iconpng.com/png/mapmarkers/marker_inside_azure.png",
  7. bubble:{
  8. title:"title1"
  9. }
  10. },
  11. {
  12. id:"10002",
  13. longitude:"116.369199",
  14. latitude:"39.942821",
  15. bubble:{
  16. title:"title2",
  17. bgImage:"res://btn.png"
  18. }
  19. },
  20. {
  21. id:"111",
  22. longitude:"116.404",
  23. latitude:"39.915",
  24. icon:"http://www.iconpng.com/png/mapmarkers/marker_inside_azure.png",
  25. bubble:{
  26. title:"title3",
  27. bgImage:"res://btn.png"
  28. }
  29. }
  30. ];
  31. var dataStr = JSON.stringify(data);
  32. uexBaiduMap.addMarkersOverlay(dataStr);

setMarkerOverlay 更新设置标注信息

uexBaiduMap.setMarkerOverlay(makerId,makerInfo);

说明

更新设置标注信息

参数

参数 参数类型 是否必选 说明
makerId String 唯一标识符
makerInfo String 标注信息,json格式
  1. var makerInfo={
  2. longitude:,//标注经度
  3. latitude:,//标注纬度
  4. icon://标注图标
  5. bubble:{//气泡设置
  6. title:,//气泡标题
  7. bgImage://气泡背景图片
  8. }
  9. }

平台支持

Android2.2+
iOS6.0+

版本支持

3.0.0+

示例

  1. var makerInfo ={
  2. makerInfo: {
  3. bubble: {
  4. bgImage: "res://btn.png",
  5. title: "这是标题"
  6. },
  7. latitude: "39.021514",
  8. longitude: "116.232323"
  9. }
  10. };
  11. var jsonStr=JSON.stringify(makerInfo);
  12. var makerId = 10001’;
  13. uexBaiduMap. setMarkerOverlay (makerId, jsonStr);

showBubble 显示标注气泡

uexBaiduMap.showBubble(makerId);

说明

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

参数

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

平台支持

Android2.2+
iOS6.0+

版本支持

3.0.0+

示例

  1. var makerId = 10001’;
  2. uexBaiduMap. showBubble (makerId);

hideBubble 隐藏标注气泡

uexBaiduMap.hideBubble();

说明

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

参数

平台支持

Android2.2+
iOS6.0+

版本支持

3.0.0+

示例

  1. uexBaiduMap. hideBubble();

addDotOverlay 添加点覆盖物

uexBaiduMap.addDotOverlay(dotInfo);

说明

添加点覆盖物

参数

  1. dotInfo:(String类型) 必选添加到地图上的圆点信息的集合。该字符串为JSON格式
  2. var dotInfo={
  3. id:,
  4. fillColor:,
  5. radius:,
  6. longitude:,
  7. latitude:
  8. }

各字段含义如下

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

平台支持

Android2.2+
iOS6.0+

版本支持

3.0.0+

示例

  1. var dotInfo={
  2. fillColor:"#990033",
  3. id:"150",
  4. longitude:"116.400244",
  5. latitude:"39.963175",
  6. radius:"50"
  7. };
  8. var jsonStr=JSON.stringify(dotInfo);
  9. uexBaiduMap.addDotOverlay(jsonStr);

addPolylineOverlay 添加折线覆盖物

uexBaiduMap.addPolylineOverlay(polylineInfo);

说明

添加折线覆盖物

参数

  1. polylineInfo:(String类型) 必选添加到地图上的折线信息的集合。该字符串为JSON格式:
  2. var polylineInfo={
  3. id:,
  4. fillColor:,
  5. lineWidth:,
  6. property:
  7. [
  8. {
  9. longitude:"116.357428",
  10. latitude:"39.93923
  11. },
  12. {
  13. longitude:"116.347428",
  14. latitude:"39.89923"
  15. }
  16. ]
  17. }

各字段含义如下

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

平台支持

Android2.2+
iOS6.0+

版本支持

3.0.0+

示例

  1. var polylineInfo=
  2. {
  3. fillColor:"#990033",
  4. id:"151",
  5. lineWidth:"10.0",
  6. property:
  7. [
  8. {
  9. longitude:"116.357428",
  10. latitude:"39.93923"
  11. },
  12. {
  13. longitude:"116.401394",
  14. latitude:"39.942821"
  15. },
  16. {
  17. longitude:"116.347428",
  18. latitude:"39.89923"
  19. }
  20. ]
  21. };
  22. var jsonStr=JSON.stringify(polylineInfo);
  23. uexBaiduMap.addPolylineOverlay(jsonStr);

addArcOverlay 添加弧形覆盖物

uexBaiduMap.addArcOverlay(arcInfo);

说明

添加弧形覆盖物

参数

  1. arcInfo:(String类型) 必选添加到地图上的弧形信息的集合。该字符串为JSON格式
  2. var arcInfo={
  3. id:,
  4. strokeColor:,
  5. lineWidth:,
  6. startLongitude:,
  7. startLatitude:,
  8. centerLongitude:,
  9. centerLatitude:,
  10. endLongitude:,
  11. endLatitude:
  12. }

各字段含义如下

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

平台支持

Android2.2+
iOS6.0+

版本支持

3.0.0+

示例

  1. var data={
  2. centerLatitude:"39.942821",
  3. centerLongitude:"116.369199",
  4. endLatitude:"39.906965",
  5. endLongitude:"116.401394",
  6. id:"152",
  7. lineWidth:"2.0",
  8. startLatitude:"39.963175",
  9. startLongitude:"116.400244",
  10. strokeColor:"#990033"
  11. };
  12. var jsonStr=JSON.stringify(data)
  13. uexBaiduMap.addArcOverlay(jsonStr);

addCircleOverlay 添加圆形覆盖物

uexBaiduMap.addCircleOverlay(circleInfo);

说明

添加圆形覆盖物

参数

  1. circleInfo:(String类型) 必选添加到地图上的圆形覆盖物信息的集合。该字符串为JSON格式
  2. var circleInfo={
  3. id:,
  4. longitude:,
  5. latitude:,
  6. radius:"1000",
  7. fillColor:"#4169E1",
  8. strokeColor:"#990033",
  9. lineWidth:"4"
  10. }

各字段含义如下

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

平台支持

Android2.2+
iOS6.0+

版本支持

3.0.0+

示例

  1. var data={
  2. fillColor:"#4169E1",
  3. id:"153",latitude:"39.915",
  4. lineWidth:"4",
  5. longitude:"116.404",
  6. radius:"1000",
  7. strokeColor:"#990033"
  8. };
  9. var jsonStr=JSON.stringify(data);
  10. uexBaiduMap.addCircleOverlay(jsonStr);

addPolygonOverlay 添加几何图形覆盖物

uexBaiduMap.addPolygonOverlay(polygonInfo);

说明

向添加几何图形覆盖物

参数

  1. polygonInfo:(String类型) 必选添加到地图上的集合图形信息的集合。该字符串为JSON格式:
  2. var polygonInfo={
  3. id:,
  4. fillColor:,
  5. strokeColor:,
  6. lineWidth:,
  7. property:
  8. [
  9. {
  10. longitude:,
  11. latitude:
  12. },
  13. ]
  14. }

各字段含义如下

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

平台支持

Android2.2+
iOS6.0+

版本支持

3.0.0+

示例

  1. var data={
  2. fillColor:"#990033",
  3. id:"154",
  4. lineWidth:"2.0",
  5. property:[
  6. {
  7. latitude:"39.93923",
  8. longitude:"116.357428"
  9. },
  10. {
  11. latitude:"39.91923",
  12. longitude:"116.327428"
  13. },
  14. {
  15. latitude:"39.89923",
  16. longitude:"116.347428"
  17. },
  18. {
  19. latitude:"39.89923",
  20. longitude:"116.367428"
  21. }
  22. ],
  23. strokeColor:"#990033"
  24. };
  25. var jsonStr=JSON.stringify(data)
  26. uexBaiduMap.addPolygonOverlay(jsonStr);

addGroundOverlay 添加地形图图层覆盖物

uexBaiduMap.addGroundOverlay(groundInfo);

说明

添加地形图图层覆盖物

参数

  1. groundInfo:(String类型) 必选添加到地图上的地形图图层信息的集合。该字符串为JSON格式
  2. var groundInfo={
  3. id:,
  4. imageUrl:,
  5. transparency:,
  6. imageWidth:,
  7. imageHeight:,
  8. property:
  9. [
  10. {
  11. longitude:,
  12. latitude:
  13. }
  14. ]
  15. }

各字段含义如下

参数 参数类型 是否必须 说明
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 图片高度,单位:米

平台支持

Android2.2+
iOS6.0+

版本支持

3.0.0+

示例

  1. var data={
  2. id:"155",
  3. imageHeight:"5000",
  4. imageUrl:"http://img0.bdstatic.com/img/image/9baf75d938553886ce515def29441ed31409109131.jpg",
  5. imageWidth:"10000",
  6. property:[
  7. {
  8. longitude:"116.380338",
  9. latitude:"39.92235"
  10. },
  11. {
  12. longitude:"116.414977",
  13. latitude:"39.947246"
  14. }
  15. ],
  16. transparency:"0.8"
  17. };
  18. var jsonStr=JSON.stringify(data)
  19. uexBaiduMap.addGroundOverlay(jsonStr);

addTextOverlay 添加文字覆盖物

uexBaiduMap.addTextOverlay(textInfo);

说明

添加文字覆盖物

参数

  1. textInfo:(String类型) 必选添加到地图上的文字覆盖物信息的集合。该字符串为JSON格式
  2. var textInfo = {
  3. id:,
  4. bgColor:,
  5. fontSize:,
  6. fontColor:,
  7. text:,
  8. rotate:,
  9. longitude:,
  10. latitude:
  11. }

各字段含义如下

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

平台支持

Android2.2+

版本支持

3.0.0+

示例

  1. var data={
  2. bgColor: "#FFFF00",
  3. fontSize: "24",
  4. id: "156",
  5. longitude: "116.400244",
  6. latitude: "39.963175",
  7. rotate: "-30",
  8. text: "baidu map"
  9. };
  10. var jsonStr=JSON.stringify(data);
  11. uexBaiduMap.addTextOverlay(jsonStr);

removeMakersOverlay 移除标注

uexBaiduMap.removeMakersOverlay(ids);

说明

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

参数

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

平台支持

Android2.2+
iOS6.0+

版本支持

3.0.0+

示例

  1. var ids='["150","151"]';
  2. uexBaiduMap.removeMakersOverlay(ids);

removeOverlay 移除覆盖物

uexBaiduMap.removeOverlay(id);

说明

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

参数

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

平台支持

Android2.2+
iOS6.0+

版本支持

3.0.0+

示例

  1. uexBaiduMap.removeMakersOverlay("150");

poiSearchInCity 城市内检索

uexBaiduMap.poiSearchInCity(json);

说明

根据单个关键字在指定城市内搜索兴趣点
回调 cbPoiSearchResult

参数

  1. json:(String类型) 必选搜索所需要的信息。该字符串为JSON格式
  2. var json={
  3. city:,
  4. searchKey:,
  5. pageNum:
  6. }

各字段含义如下

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

平台支持

Android2.2+
iOS6.0+

版本支持

3.0.0+

示例

  1. var data={
  2. city: "北京",
  3. searchKey: "114",
  4. pageNum: "0"
  5. };
  6. var jsonStr=JSON.stringify(data);
  7. uexBaiduMap.poiSearchInCity(jsonStr);

poiNearbySearch 周边检索

uexBaiduMap.poiNearbySearch(json);

说明

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

参数

  1. json:(String类型) 必选搜索所需要的信息。该字符串为JSON格式
  2. var json={
  3. longitude:,
  4. latitude:,
  5. radius:,
  6. searchKey:,
  7. pageNum:
  8. }

各字段含义如下

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

平台支持

Android2.2+
iOS6.0+

版本支持

3.0.0+

示例

  1. var data ={
  2. longitude: "116.309",
  3. latitude: "39.977",
  4. radius: "1000",
  5. searchKey: "电影院",
  6. pageNum: "0"
  7. };
  8. var jsonStr=JSON.stringify(data);
  9. uexBaiduMap. poiNearbySearch (jsonStr);

poiBoundSearch 区域检索

uexBaiduMap.poiBoundSearch(json);

说明

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

参数

  1. json:(String类型) 必选搜索所需要的信息。该字符串为JSON格式
  2. var json={
  3. searchKey:,
  4. pageNum:,
  5. northeast:{
  6. longitude:,
  7. latitude:
  8. },
  9. southwest:{
  10. longitude:,
  11. latitude:
  12. }
  13. }

各字段含义如下

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

平台支持

Android2.2+
iOS6.0+

版本支持

3.0.0+

示例

  1. var data={
  2. searchKey: "电影院",
  3. pageNum: "0",
  4. northeast: {
  5. longitude: "116.326664",
  6. latitude: "39.991418"
  7. },
  8. southwest: {
  9. longitude: "116.312705",
  10. latitude: "39.981730"
  11. }
  12. };
  13. var jsonStr=JSON.stringify(data);
  14. uexBaiduMap.poiBoundSearch(jsonstr);

busLineSearch 公交线路检索

uexBaiduMap.busLineSearch(json);

说明

根据公交线路编号在指定城市范围内搜索公交线路详情
回调 cbBusLineSearchResult

参数

  1. json:(String类型) 必选索所需要的信息。该字符串为JSON格式。
  2. var json={
  3. city:,
  4. busLineName:
  5. }

各字段含义如下

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

平台支持

Android2.2+
iOS6.0+

版本支持

3.0.0+

示例

  1. var data={
  2. city: "北京",
  3. busLineName: "114"
  4. };
  5. var jsonStr=JSON.stringify(data);
  6. uexBaiduMap.busLineSearch(jsonStr);

removeBusLine 清除公交线路

uexBaiduMap.removeBusLine();

说明

清除公交线路

参数

平台支持

Android2.2+
iOS6.0+

版本支持

3.0.0+

示例

  1. uexBaiduMap.removeBusLine();

preBusLineNode 显示上一个公交站点

uexBaiduMap.preBusLineNode();

说明

显示公交线路中当前站点的上一个站点,起始站点无效

参数

平台支持

Android2.2+
iOS不支持

版本支持

3.0.0+

示例

  1. uexBaiduMap.preBusLineNode();

nextBusLineNode 显示下一个公交站点

uexBaiduMap.nextBusLineNode();

说明

显示公交线路中当前站点的下一个站点,终点站点无效

参数

平台支持

Android2.2+
iOS不支持

版本支持

3.0.0+

示例

  1. uexBaiduMap.nextBusLineNode();

searchRoutePlan 规划并显示路线

uexBaiduMap.searchRoutePlan(json);

说明

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

参数

  1. json:(String类型) 必选规划路线所需要的信息。该字符串为JSON格式。
  2. var json={
  3. id:,
  4. type:,
  5. start:{
  6. city:,
  7. name:,
  8. longitude:,
  9. latitude:
  10. },
  11. end:{
  12. city:,
  13. name:,
  14. longitude:,
  15. latitude:
  16. }
  17. }

各字段含义如下

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

平台支持

Android2.2+
iOS6.0+

版本支持

3.0.0+

示例

  1. var data = {
  2. id: "rp345",
  3. type: "0",
  4. start: {
  5. city: "北京",
  6. name: "天安门"
  7. },
  8. end:{
  9. city: "北京",
  10. name: "百度大厦",
  11. longitude: "116.307827",
  12. latitude: "40.056957"
  13. }
  14. };
  15. var jsonStr=JSON.stringify(data);
  16. uexBaiduMap.searchRoutePlan(jsonStr);

preRouteNode 显示上一个线路节点

uexBaiduMap.preRouteNode();

说明

显示线路规划中当前节点的上一个节点,起始节点无效

参数

平台支持

Android2.2+
iOS 不支持

版本支持

3.0.0+

示例

  1. uexBaiduMap.preRouteNode();

removeRoutePlan 清除线路规划

uexBaiduMap.removeRoutePlan(id);

说明

清除线路规划

参数

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

平台支持

Android2.2+
iOS6.0+

版本支持

3.0.0+

示例

  1. uexBaiduMap.removeRoutePlan("rp345");

nextRouteNode 显示下一个线路节点

uexBaiduMap.nextRouteNode();

说明

显示线路规划中当前节点的下一个节点,终点节点无效

参数

平台支持

Android2.2+
iOS6不支持

版本支持

3.0.0+

示例

  1. uexBaiduMap.nextRouteNode();

geocode 地理编码

uexBaiduMap.geocode(json)

说明

根据地址获取经纬度信息
回调 cbGeoCodeResult

参数

  1. json:(String类型) 必选地址该字符串为JSON格式
  2. var json={
  3. city:,
  4. address:
  5. }

各字段含义如下

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

平台支持

Android2.2+
iOS6.0+

版本支持

3.0.0+

示例

  1. var data=
  2. {
  3. city: "北京",
  4. address: "东长安街33号"
  5. };
  6. uexBaiduMap.geocode(jsonstr);

reverseGeocode 反地理编码

uexBaiduMap.reverseGeocode(json)

说明

根据经纬度获取地址信息
回调 cbReverseGeoCodeResult

参数

  1. json:(String类型) 必选经纬度该字符串为JSON格式。如下{longitude:"116.307827",latitude:"40.056957"}

各字段含义如下

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

平台支持

Android2.2+
iOS6.0+

版本支持

3.0.0+

示例

  1. var data={
  2. longitude: "116.307827",
  3. latitude: "40.056957"
  4. };
  5. var jsonStr=JSON.stringify(data);
  6. uexBaiduMap.reverseGeocode(jsonStr);

getCurrentLocation 获取当前位置

uexBaiduMap.getCurrentLocation()

说明

获取当前的位置信息,仅定位一次
回调 cbCurrentLocation

参数

平台支持

Android2.2+
iOS6.0+

版本支持

3.0.0+

示例

  1. uexBaiduMap.getCurrentLocation();

startLocation 开始连续定位

uexBaiduMap.startLocation()

说明

开始连续定位

参数

平台支持

Android2.2+
iOS6.0+

版本支持

3.0.0+

示例

  1. uexBaiduMap.startLocation();

stopLocation 停止连续定位

uexBaiduMap.stopLocation()

说明

停止连续定位

参数

平台支持

Android2.2+
iOS6.0+

版本支持

3.0.0+

示例

  1. uexBaiduMap.stopLocation();

setMyLocationEnable 显示或隐藏用户位置

uexBaiduMap.setMyLocationEnable(type)

说明

显示或隐藏用户位置

参数

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

平台支持

Android2.2+
iOS6.0+

版本支持

3.0.0+

示例

  1. uexBaiduMap.setMyLocationEnable(1);

setUserTrackingMode 设置跟踪模式

uexBaiduMap.setUserTrackingMode(mode)

说明

设置定位时的跟踪模式

参数

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

平台支持

Android2.2+
iOS6.0+

版本支持

3.0.0+

示例

  1. uexBaiduMap.setUserTrackingMode(0);

zoomControlsEnabled 显示或隐藏缩放控件

uexBaiduMap.zoomControlsEnabled(mode)

说明

显示或隐藏缩放控件

参数

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

平台支持

Android2.2+

版本支持

3.0.0+

示例

  1. uexBaiduMap.zoomControlsEnabled(0)

2.2、监听方法

onMapClickListener 点击地图的监听方法

uexBaiduMap.onMapClickListener(data)

参数

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

各字段含义如下

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

版本支持

3.0.0+

onMapDoubleClickListener 双击地图的监听方法

uexBaiduMap.onMapDoubleClickListener(data)

参数

同onMapClickListener

版本支持

3.0.0+

onMapLongClickListener 长按地图的监听方法

uexBaiduMap.onMapLongClickListener(data)

参数

同onMapClickListener

版本支持

3.0.0+

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

uexBaiduMap.onMapStatusChangeListener(json);

参数

  1. var json = {
  2. center: { // 地图中心点改变时返回值,回调改变后的中心点坐标
  3. longitude:, //经度
  4. latitude: //纬度
  5. },
  6. zoom:{ // 地图缩放级别改变时返回值,回调改变前后的缩放级别
  7. oldZoom:, // 地图状态改变前的缩放级别
  8. newZoom: // 地图状态改变后的缩放级别
  9. }
  10. overlook: {//地图倾斜度改变时返回值,回调改变前后的倾斜度
  11. oldOverlook:, // 地图状态改变前的倾斜度
  12. newOverlook: // 地图状态改变后的倾斜度
  13. },
  14. northeast: {//地图东北角坐标改变时返回值,回调改变后的东北角坐标值
  15. longitude:, // 经度
  16. latitude: // 纬度
  17. },
  18. southwest: {//地图西南角坐标改变时返回值,回调改变后的西南角坐标值
  19. longitude:, // 经度
  20. latitude: // 纬度
  21. },
  22. rotate: {//地图旋转角度改变时返回值,回调改变前后的旋转角度
  23. oldRotate:, // 地图状态改变前的旋转角度
  24. newRotate: // 地图状态改变后的旋转角度
  25. }
  26. }

平台支持

Android2.2+

版本支持

3.0.0+

示例

  1. uexBaiduMap.onMapStatusChangeListener = function(data){
  2. alert(data);
  3. }

onMarkerClickListener 点击标注的监听方法

uexBaiduMap.onMarkerClickListener(markerId)

参数

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

版本支持

3.0.0+

示例

  1. uexBaiduMap.onMarkerClickListener = function(data){
  2. alert(data);
  3. }

onMarkerBubbleClickListener 点击标注气泡的监听方法

uexBaiduMap.onMarkerBubbleClickListener(markerId)

参数

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

版本支持

3.0.0+

示例

  1. uexBaiduMap.onMarkerBubbleClickListener = function(data){
  2. alert(data);
  3. }

onSDKReceiverError 初始化地图时,key非法、网络错误时的监听方法

uexBaiduMap.onSDKReceiverError(data)

参数

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

版本支持

3.0.0+

示例

  1. uexBaiduMap.onSDKReceiverError = function(data){
  2. alert(data);
  3. }

onReceiveLocation 开始定位后的监听方法

uexBaiduMap.onReceiveLocation(data)

参数

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

各字段含义如下

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

版本支持

3.0.0+

示例

  1. uexBaiduMap.onReceiveLocation = function(data){
  2. alert(data);
  3. }

onSearchRoutePlan 线路规划搜索结果的监听

uexBaiduMap.onSearchRoutePlan(status)

参数

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

版本支持

3.0.0+
示例:

  1. uexBaiduMap.onSearchRoutePlan = function(status){
  2. alert(status);
  3. }

onZoomLevelChangeListener 缩放级别改变时,获取缩放级别和中心点的监听方法

uexBaiduMap.onZoomLevelChangeListener(level,latitude,longitude)

参数

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

版本支持

3.0.0+

示例

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

2.3 回调方法

cbOpen 加载地图完成的回调方法

uexBaiduMap.cbOpen();

参数

版本支持

3.0.0+

cbCurrentLocation 获取到当前位置的回调方法

uexBaiduMap.cbCurrentLocation(data)

参数

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

各字段含义如下

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

版本支持

3.0.0+

示例

  1. uexBaiduMap.cbCurrentLocation = function(data){
  2. alert(data);
  3. }

cbGeoCodeResult 地理编码返回结果的回调方法

uexBaiduMap.cbGeoCodeResult(data)

参数

  1. data:(String类型) 必选 经纬度该字符串为JSON格式。
  2. var data={
  3. longitude:,
  4. latitude:
  5. }

各字段含义如下

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

版本支持

3.0.0+

示例

  1. uexBaiduMap.cbGeoCodeResult = function(data){
  2. alert(data);
  3. }

cbReverseGeoCodeResult 反地理编码返回结果的回调方法

uexBaiduMap.cbReverseGeoCodeResult(data)

参数

  1. data:(String类型) 必选 地址该字符串为JSON格式。
  2. var data={
  3. address:
  4. }

示例

  1. uexBaiduMap.cbReverseGeoCodeResult = function(data){
  2. alert(data);
  3. }

版本支持

3.0.0+

cbPoiSearchResult:poiSearchInCity、poiNearbySearch、poiBoundSearch的回调方法

uexBaiduMap.cbPoiSearchResult(data)

参数

  1. data:(String类型) 必选 POI列表信息。该字符串为JSON格式
  2. var data={
  3. totalPoiNum:,
  4. totalPageNum:,
  5. currentPageNum:,
  6. currentPageCapacity:,
  7. poiInfo:[
  8. {
  9. uid:,
  10. poiType:,
  11. phoneNum:,
  12. address:,
  13. name:,
  14. longitude:,
  15. latitude:,
  16. city:,
  17. postCode:
  18. }
  19. ]
  20. }

各字段含义如下

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

版本支持

3.0.0+

示例

  1. uexBaiduMap.cbPoiSearchResult = function(data){
  2. alert(data);
  3. }

cbBusLineSearchResult 公交线路搜索的回调方法

uexBaiduMap.cbBusLineSearchResult(data)

参数

  1. data:(String类型) 必选 公交线路的详细信息该字符串为JSON格式
  2. var data={
  3. busLineName:,
  4. busCompany:,
  5. startTime:,
  6. endTime:,
  7. busStation:[
  8. {
  9. title:"史各庄(辛庄桥西)",
  10. longitude:116.297604,
  11. latitude:40.099629
  12. }
  13. ]
  14. }

各字段含义如下

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

版本支持

3.0.0+

示例

  1. uexBaiduMap.cbBusLineSearchResult = function(data){
  2. alert(data);
  3. }

3、更新历史

API 版本:uexBaiduMap-3.1.19(iOS) uexBaiduMap-3.2.38(Android)

最近更新时间:2016-08-05

历史发布版本 iOS更新 安卓更新
3.2.38 解决搜索结果总数被覆盖的问题
3.2.37 更新SDK,增加getCenter得到地图中心点方法
3.2.36 优化了getDistance的算法,使用新版本SDK自带工具类DistanceUtil进行计算,使计算值更为精准
3.2.35 更新SDK后appkey验证广播机制改变,由于onSDKReceiverError回调只为前端开发者所提供,所以使用Toast替代
3.2.34 修复了getCurrentLocation必须open才能使用的问题;修复了地理编码、反地理编码必须open才能使用的问题
3.2.33 更新SDK版本,将百度地图所有库导入
3.2.32 增加了getDistance得到两点间直线距离方法,在回调方法cbPoiSearchResult中增加distance字段,返回距离;修复了文档中cbGetDistance代码case说明不对的问题
3.2.31 增加了,当不打开地图View时,也可以调用poi搜索功能(目前支持城市检索,周边检索,区域检索),修复了打开地图再关闭地图,搜索poi无效的问题
3.2.30 修复了前端调用open方法时传入小数时抛出NumberFormatException的问题
3.2.29 修复了持续定位时cbCurrentLocation回调不生效的问题
3.2.28 修复open接口传入的中心点不生效的问题
3.2.27 修改插件,使其支持config配置APIKey
3.1.26 去掉插件中的ActivityGroup,配合引擎升级
3.1.25 国际化
3.1.24 修改百度地图中引用的jar包,解除与百度导航插件之间的打包冲突问题
3.1.23 修复地理编码接口当地址错误时程序崩溃的问题
3.1.22 修复加入百度地图插件后 uexLocation.openLocation()中的onchange事件不能 使用问题
3.1.21 规避百度地图SDK的BitmapDescriptorFactory中fromView 方法重复调用crash问题
3.1.20 修复点击路径规划中的起终点标注 时,应用崩溃的问题
3.0.19 修复点击标注很难触发监听的bug 解决百度地图上箭头不转动的问题
3.0.18 升级SDK3.0.0-支持IPv6 增加onMapStatusChangeListener监听 方法监听地图状态改变,以及添加标注时增加 气泡属性
3.0.17 修复removeMakersOverlay接口传不当参数会闪退的问题 修复打开百度地图闪黑屏问题
3.0.16 增加对多种类型参数的识别,支持3.3引擎 增加onMarkerClickListener和 onMarker BubbleClickListener接口
3.0.15 修改插件,使其支持config配置APIKey 增加onZoomLevelChangeListener地 图缩放级别改变时,获取缩放级别和中心点的 监听
3.0.14 删去info.plist 增加zoomControlsEnabled显示或隐藏缩 放控件
3.0.13 国际化 增加hideMap(隐藏地图)和showMap(显示 地图) 的接口
3.1.12 修复onMapLongClickListener回调结果异常的bug 修改添加相同url标注,标注不显示的问题
3.1.11 修改uexBaiduMap.plist文件NSLocation WhenInUseUsageDescription字段对应value 的类型为字符串 修改cbOpen和onSearchRoutePlan的JS回 调方式
3.1.10 新增onMarkerClickListener和onMarker BubbleClickListener监听方法 增加加载地图完成的cbOpen回调和线路规划搜 索结果返回时的监听onSearchRoutePlan
3.1.9 增加onZoomLevelChangeListener地图缩放 级别 改变时,获取缩放级别和中心点的监听 移动插件包中的定位jar包和so文件至引擎中
3.1.8 增加隐藏地图hideMap和显示地图showMap的接 口 修改在百度地图窗口打开新窗口报错问题
3.1.7 修复onMapClickListener和onMapDoubleClick Listener的回调错误, 添加cbOpen方法,添加onSearchRoutePlan方法 修改获取当前位置时返回结果错误问题
3.1.6 修复手势问题 增加setUserTrackingMode接口
3.1.5 修复新SDK定位失败问题 修改点击显示线路和添加标注按钮无反应问题
3.1.4 更新百度地图iOS_SDK_2.6.0 修改点击标注空指针异常问题
3.1.3 修复公交路线搜索失败的问题 修改地理编码和反地理编码JSON回调方法名称
3.1.2 修复cbPoiSearchResult接口回调信息不完整问题 添加标注支持网络图片的功能
3.1.1 与安卓统一回调接口的参数 增加清除公交线路和清除线路规划接口