跳到主要内容
版本:2.x

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✔️