Version: 下个版本

MapContext

MapContext 实例,可通过 Taro.createMapContext 获取。 MapContext 通过 id 跟一个 map 组件绑定,操作对应的 map 组件。

方法#

getCenterLocation#

获取当前地图中心的经纬度。返回的是 gcj02 坐标系,可以用于 wx.openLocation()

参考文档

(option?: GetCenterLocationOption) => void
参数类型
optionGetCenterLocationOption

API 支持度#

API微信小程序H5React Native
MapContext.getCenterLocation✔️

getRegion#

获取当前地图的视野范围

参考文档

(option?: GetRegionOption) => void
参数类型
optionGetRegionOption

API 支持度#

API微信小程序H5React Native
MapContext.getRegion✔️

getRotate#

获取当前地图的旋转角

参考文档

(option?: GetRotateOption) => void
参数类型
optionGetRotateOption

API 支持度#

API微信小程序H5React Native
MapContext.getRotate✔️

getScale#

获取当前地图的缩放级别

参考文档

(option?: GetScaleOption) => void
参数类型
optionGetScaleOption

API 支持度#

API微信小程序H5React Native
MapContext.getScale✔️

getSkew#

获取当前地图的倾斜角

参考文档

(option?: GetSkewOption) => void
参数类型
optionGetSkewOption

API 支持度#

API微信小程序H5React Native
MapContext.getSkew✔️

includePoints#

缩放视野展示所有经纬度

参考文档

(option: IncludePointsOption) => void
参数类型
optionIncludePointsOption

API 支持度#

API微信小程序H5React Native
MapContext.includePoints✔️

moveToLocation#

将地图中心移置当前定位点,此时需设置地图组件 show-location 为true。

参考文档

(option: MoveToLocationOption) => void
参数类型
optionMoveToLocationOption

API 支持度#

API微信小程序H5React Native
MapContext.moveToLocation✔️

translateMarker#

平移marker,带动画

参考文档

(option: TranslateMarkerOption) => void
参数类型
optionTranslateMarkerOption

API 支持度#

API微信小程序H5React Native
MapContext.translateMarker✔️

参数#

GetCenterLocationOption#

参数类型必填说明
complete(res: CallbackResult) => void接口调用结束的回调函数(调用成功、失败都会执行)
fail(res: CallbackResult) => void接口调用失败的回调函数
successGetCenterLocationSuccessCallback接口调用成功的回调函数

GetCenterLocationSuccessCallback#

接口调用成功的回调函数

(result: GetCenterLocationSuccessCallbackResult) => void
参数类型
resultGetCenterLocationSuccessCallbackResult

GetCenterLocationSuccessCallbackResult#

参数类型说明
latitudenumber纬度
longitudenumber经度
errMsgstring调用结果

GetRegionOption#

参数类型必填说明
complete(res: CallbackResult) => void接口调用结束的回调函数(调用成功、失败都会执行)
fail(res: CallbackResult) => void接口调用失败的回调函数
successGetRegionSuccessCallback接口调用成功的回调函数

GetRegionSuccessCallback#

接口调用成功的回调函数

(result: GetRegionSuccessCallbackResult) => void
参数类型
resultGetRegionSuccessCallbackResult

GetRegionSuccessCallbackResult#

参数类型说明
northeastnumber东北角经纬度
southwestnumber西南角经纬度
errMsgstring调用结果

GetRotateOption#

参数类型必填说明
complete(res: CallbackResult) => void接口调用结束的回调函数(调用成功、失败都会执行)
fail(res: CallbackResult) => void接口调用失败的回调函数
successGetRotateSuccessCallback接口调用成功的回调函数

GetRotateSuccessCallback#

接口调用成功的回调函数

(result: GetRotateSuccessCallbackResult) => void
参数类型
resultGetRotateSuccessCallbackResult

GetRotateSuccessCallbackResult#

参数类型说明
rotatenumber旋转角
errMsgstring调用结果

GetScaleOption#

参数类型必填说明
complete(res: CallbackResult) => void接口调用结束的回调函数(调用成功、失败都会执行)
fail(res: CallbackResult) => void接口调用失败的回调函数
successGetScaleSuccessCallback接口调用成功的回调函数

GetScaleSuccessCallback#

接口调用成功的回调函数

(result: GetScaleSuccessCallbackResult) => void
参数类型
resultGetScaleSuccessCallbackResult

GetScaleSuccessCallbackResult#

参数类型说明
scalenumber缩放值
errMsgstring调用结果

GetSkewOption#

参数类型必填说明
complete(res: CallbackResult) => void接口调用结束的回调函数(调用成功、失败都会执行)
fail(res: CallbackResult) => void接口调用失败的回调函数
successGetSkewSuccessCallback接口调用成功的回调函数

GetSkewSuccessCallback#

接口调用成功的回调函数

(result: GetSkewSuccessCallbackResult) => void
参数类型
resultGetSkewSuccessCallbackResult

GetSkewSuccessCallbackResult#

参数类型说明
skewnumber倾斜角
errMsgstring调用结果

IncludePointsOption#

参数类型必填说明
pointsMapPostion[]要显示在可视区域内的坐标点列表
complete(res: CallbackResult) => void接口调用结束的回调函数(调用成功、失败都会执行)
fail(res: CallbackResult) => void接口调用失败的回调函数
paddingnumber[]坐标点形成的矩形边缘到地图边缘的距离,单位像素。格式为[上,右,下,左],安卓上只能识别数组第一项,上下左右的padding一致。开发者工具暂不支持padding参数。
success(res: CallbackResult) => void接口调用成功的回调函数

MapPostion#

要显示在可视区域内的坐标点列表

参数类型说明
latitudenumber纬度
longitudenumber经度

MoveToLocationOption#

参数类型必填说明
complete(res: CallbackResult) => void接口调用结束的回调函数(调用成功、失败都会执行)
fail(res: CallbackResult) => void接口调用失败的回调函数
latitudenumber纬度
longitudenumber经度
success(res: CallbackResult) => void接口调用成功的回调函数

TranslateMarkerOption#

参数类型必填说明
autoRotateboolean移动过程中是否自动旋转 marker
destinationDestinationOption指定 marker 移动到的目标点
markerIdnumber指定 marker
rotatenumbermarker 的旋转角度
animationEnd(...args: any[]) => any动画结束回调函数
complete(res: CallbackResult) => void接口调用结束的回调函数(调用成功、失败都会执行)
durationnumber动画持续时长,平移与旋转分别计算
fail(res: CallbackResult) => void接口调用失败的回调函数
success(res: CallbackResult) => void接口调用成功的回调函数

DestinationOption#

参数类型说明
latitudenumber纬度
longitudenumber经度

API 支持度#

API微信小程序H5React Native
MapContext.getCenterLocation✔️
MapContext.getRegion✔️
MapContext.getRotate✔️
MapContext.getScale✔️
MapContext.getSkew✔️
MapContext.includePoints✔️
MapContext.moveToLocation✔️
MapContext.translateMarker✔️