发表于 2023-2-16 18:54:51
方法：
- openSysMap: 调用系统第三方程序进行导航
- create: 创建Map对象
- getMapById: 查找已经创建的Map对象
对象：
- Map: 地图控件对象
- MapStyles: 地图控件对象的参数
- GeocodeOptions: 地理编码转换的参数
- CoordinateConvertOptions: 地图坐标转换的参数
- Point: Point对象用于表示地图元素的坐标
- Bounds: 地理区域
- MapType: 地图视图类型
- Overlay: 地图覆盖物基类对象
- Marker: 地图上显示的标点对象
- Bubble: 地图上显示的气泡对象
- Circle: 地图上显示的圆圈对象
- Polyline: 地图上显示的折线对象
- Polygon: 地图上显示的多边形对象
- Search: 地图检索对象
- SearchPolicy: 检索策略类型
- SearchPoiResult: 保存位置检索、周边检索和范围检索返回的结果
- SearchRouteResult: 保存位置检索、周边检索和范围检索返回的结果
- Position: 检索结果的位置点
- Route: 地图中的路线对象
回调方法：
- GeocodeCallback: 地理编码转换成功的回调函数
- CoordinateConvertCallback: 坐标转换成功的回调函数
- DistanceCalculateCallback: 距离计算成功的回调函数
- AreaCalculateCallback: 地理区域面积计算成功的回调函数
- UserLocationCallback: 获取用户当前位置信息成功回调
- ClickEventHandler: 用户点击地图回调事件
- StatusChangedEventHandler: 地图状态变化回调事件
- OverlayClickEventHandler: 用户点击地图覆盖物回调事件
- OverlayDragEventHandler: 用户拖拽覆盖物回调事件
- PoiSearchCallback: 兴趣点检索完成事件
- RouteSearchCallback: 线路检索完成事件
- SuccessCallback: 地图操作成功回调函数
- ErrorCallback: 地图操作失败的回调函数
权限：
permissions
openSysMap
调用系统第三方程序进行导航
参数：
- dst: ( Point ) 必选 导航目的地坐标
要求使用WGS-84坐标系值，即GPS获取的值。
- des: ( String ) 必选 导航目的地描述
要求使用WGS-84坐标系，即GPS获取的值。
- src: ( Point ) 必选 导航起始地描述
返回值：
void : 无示例：
create
创建Map对象
说明：
调用此方法创建后并不会显示，需要调用Webview窗口的append方法将其添加到Webview窗口后才能显示。 注意：此时需要通过styles参数的top/left/width/height属性设置控件的位置及大小。
参数：
- id: ( String ) 必选 地图控件对象的全局标识
可用于通过plus.maps.getMapById()方法查找已经创建的地图控件对象。
- styles: ( MapStyles ) 可选 地图控件的显示参数
设置Map控件的位置及大小等。
返回值：
Map : Map地图控件对象示例：
getMapById
查找已经创建的Map对象
说明：
调用此方法查找指定id的Map对象，如果不存在则返回null。
参数：
- id: ( String ) 必选 Map对象的全局标识
如果存在多个相同标识的Map对象，则返回第一个查找到的Map对象。 如果不存在指定标识的Map对象，则返回null。
返回值：
Map : Map地图控件对象示例：
Map
地图控件对象
构造：
- Map(domId, styles): 创建Map对象
方法：
- calculateArea: 静态方法，计算面积
- calculateDistance: 静态方法，计算距离
- convertCoordinates: 静态方法，坐标转换
- geocode: 静态方法，地理编码
- reverseGeocode: 静态方法，反向地理编码
- addOverlay: 向地图中添加覆盖物
- centerAndZoom: 设置地图初始中心点和缩放级别
- clearOverlays: 清除地图中所有覆盖物对象
- close: 关闭地图控件
- getBounds: 获取当前地图可视范围的地理区域
- getCenter: 获取地图中心点位置
- getCurrentCenter: 获取当前地图显示的地图中心点位置
- getMapType: 获取地图的显示类型
- getUserLocation: 获取用户的当前位置信息
- getZoom: 获取地图的缩放级别
- hide: 隐藏地图控件
- isShowUserLocation: 获取是否显示用户位置
- isShowZoomControls: 获取是否显示地图内置缩放控件
- isTraffic: 获取是否打开地图交通信息图层
- removeOverlay: 从地图中删除覆盖物对象
- reset: 重置地图
- resize: 重设地图控件大小
- setCenter: 设置地图的中心点
- setMapType: 设置地图的视图类型
- setStyles: 设置地图控件的配置参数
- setTraffic: 是否打开地图交通信息图层
- setZoom: 设置地图的缩放级别
- show: 显示地图控件
- showUserLocation: 显示用户位置
- showZoomControls: 设置是否显示地图内置缩放控件
事件：
- onclick: 用户点击地图事件
- onstatuschanged: 地图状态改变事件
Map(domId, styles)
创建Map对象
说明：
创建Map地图控件对象，并指定其在Webview窗口中关联div或object标签的id号。 此时styles参数中的left/top/width/height属性值被忽略，通过DOM标签来确定Map对象的位置及大小。
参数：
- domId: ( String ) 必选 关联到Webview中DOM节点的标识
系统将查找到此id的DOM节点，并将Map地图控件对象的位置和大小与其保持一致。
- styles: ( MapStyles ) 可选 地图控件的显示参数
返回值：
Map : Map地图控件对象示例：
calculateArea
静态方法，计算面积
说明：
计算指定地理区域的面积，单位为平方米。 注：此功能仅百度地图支持，高德地图暂不支持此功能。
参数：
- bounds: ( Bounds ) 必选 要计算的地理区域
- successCallback: ( AreaCalculateCallback ) 可选 计算地理区域面积成功回调
地理区域面积计算成功时触发，并返回计算的面积值。
- errorCallback: ( ErrorCallback ) 可选 计算面积失败回调
地理区域面积计算失败时触发，并返回错误信息。
返回值：
void : 无示例：
calculateDistance
静态方法，计算距离
说明：
计算从pointStart坐标点到pointEnd坐标的实际直线距离，单位为米（m）。
参数：
- pointStart: ( Point ) 必选 起点的坐标
- pointEnd: ( Point ) 可选 终点的坐标
- successCallback: ( DistanceCalculateCallback ) 可选 计算距离成功回调
距离计算成功时触发，并返回计算的距离值。
- errorCallback: ( ErrorCallback ) 可选 计算距离失败回调
距离计算失败时触发，并返回错误信息。
返回值：
void : 无示例：
convertCoordinates
静态方法，坐标转换
说明：
将第三方坐标系坐标转换成当前地图的坐标系坐标。 转换成功通过successCallback返回，转换失败则通过errorCallback返回。
参数：
- point: ( Point ) 必选 要转换的坐标
- options: ( CoordinateConvertOptions ) 可选 坐标转换的参数
- successCallback: ( CoordinateConvertCallback ) 可选 坐标转换成功回调
坐标转换成功时触发，并返回转后的坐标值。
- errorCallback: ( ErrorCallback ) 可选 坐标转换失败回调
坐标转换失败时触发，并返回错误信息。
返回值：
void : 无平台支持：
- Android - 2.3+ (支持) :
仅百度地图支持此功能。
- iOS - 5.1+ (支持) :
仅百度地图支持此功能。
示例：
geocode
静态方法，地理编码
说明：
将地理位置信息转换为坐标点。 转换成功通过successCallback返回，转换失败则通过errorCallback返回。
参数：
- address: ( String ) 必选 要转换的地理位置信息
越详细的地址信息越容易转换，如XX路XX号XX大厦。
- options: ( GeocodeOptions ) 可选 地理编码的参数
- successCallback: ( GeocodeCallback ) 可选 地理编码转换成功回调
地理编码转换成功时触发，并返回转换后的坐标信息。
- errorCallback: ( ErrorCallback ) 可选 地理编码转换失败回调
地理编码转换失败时触发，并返回错误信息。
返回值：
void : 无示例：
reverseGeocode
静态方法，反向地理编码
说明：
将坐标点转换为地理位置信息。 转换成功通过successCallback返回，转换失败则通过errorCallback返回。
参数：
- point: ( Point ) 必选 要转换的坐标
- options: ( GeocodeOptions ) 可选 地理编码的参数
- successCallback: ( GeocodeCallback ) 可选 反向地理编码转换成功回调
反向地理编码转换成功时触发，并返回转换后的地址位置信息。
- errorCallback: ( ErrorCallback ) 可选 反向地理编码转换失败回调
反向地理编码转换失败时触发，并返回错误信息。
返回值：
void : 无示例：
addOverlay
向地图中添加覆盖物
说明：
此方法用于向地图中添加覆盖物。 支持各种从maps.Overlay对象继承的各种覆盖物对象； 如果添加不支持的对象则直接返回false； 同一覆盖物对象只能添加到地图中一次，已在地图中的覆盖物再次添加时则返回false。
参数：
- overlay: ( Overlay ) 必选 在地图中要添加覆盖物
返回值：
Boolean : 添加成功返回true，失败返回false。示例：
centerAndZoom
设置地图初始中心点和缩放级别
说明：
用于设置地图的初始中心点和缩放级别，通常在创建地图后立即调用。 默认中心点为天安门，默认缩放级别为12； 该方法设置的中心点和缩放级别可通过reset()方法恢复； 如果在地图显示后调用将改变地图的中心点和缩放级别并立即更新，并将初始值更新。
参数：
- center: ( Point ) 必选 地图初始化的中心点坐标
- zoom: ( Number ) 必选 地图初始化的缩放级别
返回值：
void : 无示例：
clearOverlays
清除地图中所有覆盖物对象
说明：
此方法用于清除地图中所有覆盖物对象。 清除地图中的覆盖物对象后会自动更新地图视图。
参数：
无
返回值：
void : 无示例：
close
关闭地图控件
说明：
关闭地图控件将会销毁地图使用的资源，不可再使用。
参数：
无
返回值：
void : 无示例：
getBounds
获取当前地图可视范围的地理区域
说明：
当旋转或俯视时，是当前地图可视范围的最大外接矩形地理区域。
参数：
无
返回值：
Bounds : 获取到示例：
getCenter
获取地图中心点位置
说明：
此方法用于获取设置的地图中心点位置（centerAndZoom/setCenter）。
参数：
无
返回值：
Point : 地图中心点坐标示例：
getCurrentCenter
获取当前地图显示的地图中心点位置
说明：
此方法用于获取当前地图显示的地图中心点位置，获取成功后通过callback回调返回。
参数：
- callback: ( UserLocationCallback ) 必选 获取当前地图显示的地图中心点位置完成后执行的通知操作结果方法，在回调函数中返回的point信息为当前地图中心点坐标
提升卡
置顶卡
沉默卡
喧嚣卡
变色卡
千斤顶
照妖镜
