MapContext

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

方法

getCenterLocation

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

参考文档

(option?: GetCenterLocationOption) => void

参数	类型
option	GetCenterLocationOption

API 支持度

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

getRegion

获取当前地图的视野范围

参考文档

(option?: GetRegionOption) => void

参数	类型
option	GetRegionOption

API 支持度

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

getRotate

获取当前地图的旋转角

参考文档

(option?: GetRotateOption) => void

参数	类型
option	GetRotateOption

API 支持度

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

getScale

获取当前地图的缩放级别

参考文档

(option?: GetScaleOption) => void

参数	类型
option	GetScaleOption

API 支持度

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

getSkew

获取当前地图的倾斜角

参考文档

(option?: GetSkewOption) => void

参数	类型
option	GetSkewOption

API 支持度

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

includePoints

缩放视野展示所有经纬度

参考文档

(option: IncludePointsOption) => void

参数	类型
option	IncludePointsOption

API 支持度

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

moveToLocation

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

参考文档

(option: MoveToLocationOption) => void

参数	类型
option	MoveToLocationOption

API 支持度

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

translateMarker

平移marker，带动画

参考文档

(option: TranslateMarkerOption) => void

参数	类型
option	TranslateMarkerOption

API 支持度

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

参数

GetCenterLocationOption

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

GetCenterLocationSuccessCallback

接口调用成功的回调函数

(result: GetCenterLocationSuccessCallbackResult) => void

参数	类型
result	GetCenterLocationSuccessCallbackResult

GetCenterLocationSuccessCallbackResult

参数	类型	说明
latitude	number	纬度
longitude	number	经度
errMsg	string	调用结果

GetRegionOption

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

GetRegionSuccessCallback

接口调用成功的回调函数

(result: GetRegionSuccessCallbackResult) => void

参数	类型
result	GetRegionSuccessCallbackResult

GetRegionSuccessCallbackResult

参数	类型	说明
northeast	number	东北角经纬度
southwest	number	西南角经纬度
errMsg	string	调用结果

GetRotateOption

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

GetRotateSuccessCallback

接口调用成功的回调函数

(result: GetRotateSuccessCallbackResult) => void

参数	类型
result	GetRotateSuccessCallbackResult

GetRotateSuccessCallbackResult

参数	类型	说明
rotate	number	旋转角
errMsg	string	调用结果

GetScaleOption

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

GetScaleSuccessCallback

接口调用成功的回调函数

(result: GetScaleSuccessCallbackResult) => void

参数	类型
result	GetScaleSuccessCallbackResult

GetScaleSuccessCallbackResult

参数	类型	说明
scale	number	缩放值
errMsg	string	调用结果

GetSkewOption

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

GetSkewSuccessCallback

接口调用成功的回调函数

(result: GetSkewSuccessCallbackResult) => void

参数	类型
result	GetSkewSuccessCallbackResult

GetSkewSuccessCallbackResult

参数	类型	说明
skew	number	倾斜角
errMsg	string	调用结果

IncludePointsOption

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

MapPostion

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

参数	类型	说明
latitude	number	纬度
longitude	number	经度

MoveToLocationOption

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

TranslateMarkerOption

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

DestinationOption

参数	类型	说明
latitude	number	纬度
longitude	number	经度

API 支持度

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