API
Class

com.justep.cordova.plugin.baiduMapBase (com.justep.cordova.plugin.baiduMapBase)

使用范围：Native

Contents

class com.justep.cordova.plugin.baiduMapBase (com.justep.cordova.plugin.baiduMapBase)

百度地图插件基础版本

Constructor Top

  baiduMapBase ()

Static Properties & Enumerations Top

Number annotationColor

大头针标注的颜色
String baiduMapEvent

地图相关事件的名称

Static Methods Top

void addAnnotations (Array args, Function success, Function error)
void addArc (Object args)
void addCircle (Object args)
void addLine (Object args)
void addPolygon (Object args)
void annotationExist (Number args, Function success, Function error)
void close ()
void getAnnotationCoords (Number args, Function success, Function error)
Object getCenter (Function success, Function error)
Number getDistance (Object args, Function success, Function error)
Object getLocationFromName (Object args, Function success, Function error)
Object getNameFromLocation (Object args, Function success, Function error)
Object getRegion (Function success, Function error)
void offLineMapInit ()
void open (Object args, Function success, Function error)
void removeAllAnno ()
void removeAnnotations (Array args)
void removeEventListener (String args)
void removeOverlay (Number args)
void setBuilding (Boolean args)
void setCenter (Object args)
void setCompass (Object args)
void setHeatMap (Boolean args)
void setMapAttr (Object args)
void setOverlook (Number args)
void setPosition (Object args)
void setRegion (Object args)
void setRotation (Number args)
void setScaleBar (Object args)
void setTraffic (Boolean args)
void setZoomLevel (Number args)
void showCurrentLocation (Object args)
Object transCoords (Object args, Function success, Function error)
void updateAnnotationCoords (Object args)
void zoomIn ()
void zoomOut ()

Constructor details Top

public baiduMapBase ()

百度地图插件基础版本

Static Properties & Enumerations Detail Top

static public Number annotationColor

大头针标注的颜色

static public String baiduMapEvent

地图相关事件的名称

Static Methods Detail Top

static public void addAnnotations (Array args, Function success, Function error)

在地图上添加标注

Parameters

Array args


参数格式：

[ {id:1,title:"标题",subTitle:"子标题",lon:20.1,lat:12.3,draggable:true,color:navigator.baiduMap.annotationColor.Red,bgImgPath:"可选参数，背景图片的路径，要求必须是本地路径，不传则显示为默认的大头针"} ]

Function success

成功回调
Function error

失败回调

Return Value

void

static public void addArc (Object args)

在地图上添加弧形

Parameters

Object args


参数格式：

{ "id" :Number - 弧形id, "points" :Array - 弧形的各个点（弧形两端点和弧形中间点）组成的数组,例如:[{lon:116.297,lat:40.109}], "styles" :Object - 弧形的样式,例如:{borderColor:'#000', borderWidth:3} }

Return Value

void

static public void addCircle (Object args)

在地图上添加圆

Parameters

Object args


参数格式：

{ "id" :Number - 圆id, "center" :Object - 圆形中心点的经纬度,例如:{lon:116.297,lat:40.109}, "radius" :Number - 圆的半径, "styles" :Object - 圆的样式,例如:{borderColor:'#000', alpha:0.5,fillColor:'#000',borderWidth:3} }

Return Value

void

static public void addLine (Object args)

在地图上添加折线

Parameters

Object args


参数格式：

{ "id" :Number - 折线id, "points" :Array - 折线的多个点组成的数组,例如:[{lon:116.297,lat:40.109}], "styles" :Object - 折线的样式,例如:{borderColor:'#000', borderWidth:3} }

Return Value

void

static public void addPolygon (Object args)

在地图上添加多边形

Parameters

Object args


参数格式：

{ "id" :Number - 多边形id, "points" :Array - 多边形的多个点组成的数组,例如:[{lon:116.297,lat:40.109}], "styles" :Object - 多边形的样式,例如:{borderColor:'#000',fillColor: '#000',alpha:0.5, borderWidth:3} }

Return Value

void

static public void annotationExist (Number args, Function success, Function error)

判断某个标注是否存在

Parameters

Number args

标注的id
Function success

成功回调
Function error

失败回调

Return Value

void

static public void close ()

关闭百度地图

Return Value

void

static public void getAnnotationCoords (Number args, Function success, Function error)

获取指定标注的经纬度

Parameters

Number args

标注的id
Function success

成功回调,返回示例:{lon:xx,lat:xx}
Function error

失败回调

Return Value

void

static public Object getCenter (Function success, Function error)

获取百度地图中心点的经纬度

Parameters

Function success

成功回调
Function error

失败回调

Return Value

Object

中心点的经纬度，返回示例:{lon:xx,lat:xx};

static public Number getDistance (Object args, Function success, Function error)

获取地图两点间的实际距离

Parameters

Object args


参数格式：

{ "start":Object - 起点经纬度,例如:{lon:106.486654, lat:29.490295}, "end":Object - 终点经纬度, }

Function success

成功回调
Function error

失败回调

Return Value

Number

单位m

static public Object getLocationFromName (Object args, Function success, Function error)

根据地址信息获取经纬度

Parameters

Object args


参数格式：

{ "city":String - 地址所在城市, "address":String - 地址信息, }

Function success

成功返回示例：{"lat":39.9151754663074,"lon":116.4039058301959}
Function error

失败回调

Return Value

Object

static public Object getNameFromLocation (Object args, Function success, Function error)

根据经纬度查找地址信息

Parameters

Object args


参数格式：

{ "lon":Number - 经度, "lat":Number - 纬度, }

Function success

成功返回示例：{"status":0,"result":{"location":{"lng":116.3969999999999,"lat":39.91000007743232},"pois":[],"poiRegions":[{"direction_desc":"内","name":"国家大剧院","tag":"休闲娱乐"}],"sematic_description":"国家大剧院内","cityCode":131,"addressComponent":{"adcode":"110102","city":"北京市","country":"中国","distance":"66","district":"西城区","street":"前后井胡同","street_number":"11号","country_code":0,"direction":"南","province":"北京市"},"business":"天安门,和平门,前门","formatted_address":"北京市西城区前后井胡同11号"}}
Function error

失败回调

Return Value

Object

static public Object getRegion (Function success, Function error)

获取地图显示范围(矩形区域),

Parameters

Function success

成功回调
Function error

失败回调

Return Value

Object

返回结构参照setRegion中的参数

static public void offLineMapInit ()

离线地图初始化,使用离线地图之前必须调用此接口

Return Value

void

static public void open (Object args, Function success, Function error)

打开百度地图

Parameters

Object args


参数格式：

{ "position":Object - 地图的位置及尺寸,例如：{x:0, y:0, w:320, h:480},缺省全屏显示, "center":Object - 地图的中心位置,例如：{lon:116.397, lat:39.910},缺省北京天安门 "zoomLevel":Number - 缩放等级，取值范围3-21，缺省10 , "events":Object - 可选参数，要监听的事件以及回调,如{click:func, dbClick:func, longPress:func, viewChange:func}, "model":Object - 可选参数，当前model。如果传入model，则会在model onInActive时判地图是否已经被销毁，如果没有则会自动调用close销毁地图 }

Function success

成功回调
Function error

失败回调

Return Value

void

static public void removeAllAnno ()

在地图上移除所有标注

Return Value

void

static public void removeAnnotations (Array args)

在地图上移除标注

Parameters

Array args


参数格式：

[id1,id2]添加标注时传入的id

Return Value

void

static public void removeEventListener (String args)

停止监听地图相关事件

Parameters

String args

地图相关事件名称,取值范围(click/dbClick/longPress/viewChange)

Return Value

void

static public void removeOverlay (Number args)

移除指定id的覆盖物(addLine/addPolygon/addArc/addCircle添加的覆盖物）

Parameters

Number args

覆盖物的id

Return Value

void

static public void setBuilding (Boolean args)

设置是否显示3D楼块效果,地图放大,才会有3D楼快效果,倾斜视角3D效果会更明显

Parameters

Boolean args

是否显示3D楼块

Return Value

void

static public void setCenter (Object args)

根据经纬度设置百度地图中心点

Parameters

Object args


参数格式：

{ "lon":Number - 经度, "lat":Number - 纬度, }

Return Value

void

static public void setCompass (Object args)

设置百度地图指南针位置，只有地图旋转或视角变化时才显示指南针

Parameters

Object args


参数格式：

{ "x":Number - 指南针左上角的x坐标 "y":Number - 指南针左上角的y坐标 }

Return Value

void

static public void setHeatMap (Boolean args)

设置是否显示城市热力图

Parameters

Boolean args

是否显示城市热力图

Return Value

void

static public void setMapAttr (Object args)

设置百度地图相关属性

Parameters

Object args


参数格式：

{ "type":String - 设置地图类型,none(空白地图)/standard(标准地图)/satellite(卫星地图) "zoomEnable":Boolean - 捏合手势是否可以缩放地图, "scrollEnable":Boolean -拖动手势是否可以移动地图, }

Return Value

void

static public void setOverlook (Number args)

设置百度地图俯视角度

Parameters

Number args

地图俯视角度，取值范围：-45 - 0

Return Value

void

static public void setPosition (Object args)

重新设置百度地图的显示位置及大小

Parameters

Object args


参数格式：

{ "x":Number - 地图左上角的 x 坐标, "y":Number - 地图左上角的 y 坐标, "w":Number - 地图的宽度, "h":Number - 地图的高度, }

Return Value

void

static public void setRegion (Object args)

设置百度地图显示的矩形区域,可以有两种传入方式，分别为左上右下经纬度/中心点+经纬差，任选其一

Parameters

Object args


参数格式：

{ "lonDelta":Number - 矩形区域经度差, "latDelta":Number - 矩形区域纬度差, "center":Object 中心点的经纬度,例如:{lon:116.397, lat:39.910}, "southwest":Object 左下经纬度，{lon:116.397, lat:39.910}, "northeast":Object 右上经纬度，{lon:116.397, lat:39.910}, "animation":Boolean 设置地图的区域时,是否带动画效果,默认为True }

Return Value

void

static public void setRotation (Number args)

设置百度地图旋转角度

Parameters

Number args

地图旋转角度，取值范围：-180 - 180

Return Value

void

static public void setScaleBar (Object args)

设置百度地图的比例尺

Parameters

Object args


参数格式：

{ "isShow":Boolean - 是否显示比例尺, "position":Object -比例尺的位置，设定坐标以地图左上角为原点,比如:{x:0,y:0}, }

Return Value

void

static public void setTraffic (Boolean args)

设置是否显示交通状况

Parameters

Boolean args

是否显示交通状况

Return Value

void

static public void setZoomLevel (Number args)

设置百度地图缩放等级，此接口自带动画效果

Parameters

Number args

缩放等级 取值范围：3-21级

Return Value

void

static public void showCurrentLocation (Object args)

是否在地图上显示当前位置，并且设置显示的样式

Parameters

Object args


参数格式：

{ "isShow":Boolean - 是否在地图上显示用户位置, "trackingMode":String - 当前位置显示形式,可选值为none(普通定位模式)/follow(定位跟随模式)/compass(定位罗盘模式), }

Return Value

void

static public Object transCoords (Object args, Function success, Function error)

将其它类型的地理坐标转换为百度坐标。无需调用 open 接口即可使用,

Parameters

Object args


参数格式：

{ "type":String - 原始地理坐标类型,gps(GPS设备采集的原始GPS坐标)/common(google地图,soso地图,aliyun地图,mapabc地图和amap地图所用坐标) "lon":Number - 原始地理坐标经度 "lat":Number - 原始地理坐标纬度 }

Function success

成功回调
Function error

失败回调

Return Value

Object

返回示例:{lon:xx,lat:xx},

static public void updateAnnotationCoords (Object args)

设置某个已添加标注的经纬度

Parameters

Object args


参数格式：

{ "id" :Number - 标注的id, "lat" :Number - 纬度值, "lon" :Number - 经度值 }

Return Value

void

static public void zoomIn ()

缩小地图，放大视角，放大一级比例尺，此接口自带动画效果

Return Value

void

static public void zoomOut ()

放大地图，缩小视角，缩小一级比例尺，此接口自带动画效果

Return Value

void