导航：首页 > 开发技术 >

微信小程序如何创建并返回map上下文mapContext对象

发表于：2026-10-30 作者：千家信息网编辑

千家信息网最后更新 2026年10月30日，这篇文章主要介绍了微信小程序如何创建并返回map上下文mapContext对象的相关知识，内容详细易懂，操作简单快捷，具有一定借鉴价值，相信大家阅读完这篇微信小程序如何创建并返回map上下文mapCo

千家信息网最后更新 2026年10月30日微信小程序如何创建并返回map上下文mapContext对象

这篇文章主要介绍了微信小程序如何创建并返回map上下文mapContext对象的相关知识，内容详细易懂，操作简单快捷，具有一定借鉴价值，相信大家阅读完这篇微信小程序如何创建并返回map上下文mapContext对象文章都会有所收获，下面我们一起来看看吧。

wx.createMapContext(mapId)

创建并返回 map 上下文 mapContext 对象。在自定义组件下，第二个参数传入组件实例this，以操作组件内组件

mapContext

mapContext通过 mapId 跟一个组件绑定，通过它可以操作对应的组件。

mapContext 对象的方法列表

方法	参数	说明	最低版本
getCenterLocation	OBJECT	获取当前地图中心的经纬度，返回的是 gcj02 坐标系，可以用于 `wx.openLocation`
moveToLocation	无	将地图中心移动到当前定位点，需要配合map组件的show-location使用
translateMarker	OBJECT	平移marker，带动画	1.2.0
includePoints	OBJECT	缩放视野展示所有经纬度	1.2.0
getRegion	OBJECT	获取当前地图的视野范围	1.4.0
getScale	OBJECT	获取当前地图的缩放级别	1.4.0

getCenterLocation 的 OBJECT 参数列表

参数	类型	必填	说明
success	Function	否	接口调用成功的回调函数，res = { longitude: "经度", latitude: "纬度"}
fail	Function	否	接口调用失败的回调函数
complete	Function	否	接口调用结束的回调函数（调用成功、失败都会执行）

translateMarker 的 OBJECT 参数列表

参数	类型	必填	说明
markerId	Number	是	指定marker
destination	Object	是	指定marker移动到的目标点
autoRotate	Boolean	是	移动过程中是否自动旋转marker
rotate	Number	是	marker的旋转角度
duration	Number	否	动画持续时长，默认值1000ms，平移与旋转分别计算
animationEnd	Function	否	动画结束回调函数
fail	Function	否	接口调用失败的回调函数

includePoints 的 OBJECT 参数列表

参数	类型	必填	说明
points	Array	是	要显示在可视区域内的坐标点列表，[{latitude, longitude}]
padding	Array	否	坐标点形成的矩形边缘到地图边缘的距离，单位像素。格式为[上,右,下,左]，安卓上只能识别数组第一项，上下左右的padding一致。开发者工具暂不支持padding参数。

getRegion 的 OBJECT 参数列表

参数	类型	必填	说明
success	Function	否	接口调用成功的回调函数，res = {southwest, northeast}，西南角与东北角的经纬度
fail	Function	否	接口调用失败的回调函数
complete	Function	否	接口调用结束的回调函数（调用成功、失败都会执行）

getScale 的 OBJECT 参数列表

参数	类型	必填	说明
success	Function	否	接口调用成功的回调函数，res = {scale}
fail	Function	否	接口调用失败的回调函数
complete	Function	否	接口调用结束的回调函数（调用成功、失败都会执行）

示例代码：

// map.jsPage({  onReady: function (e) {    // 使用 wx.createMapContext 获取 map 上下文    this.mapCtx = wx.createMapContext('myMap')  },  getCenterLocation: function () {    this.mapCtx.getCenterLocation({      success: function(res){        console.log(res.longitude)        console.log(res.latitude)      }    })  },  moveToLocation: function () {    this.mapCtx.moveToLocation()  },  translateMarker: function() {    this.mapCtx.translateMarker({      markerId: 0,      autoRotate: true,      duration: 1000,      destination: {        latitude:23.10229,        longitude:113.3345211,      },      animationEnd() {        console.log('animation end')      }    })  },  includePoints: function() {    this.mapCtx.includePoints({      padding: [10],      points: [{        latitude:23.10229,        longitude:113.3345211,      }, {        latitude:23.00229,        longitude:113.3345211,      }]    })  }})

关于"微信小程序如何创建并返回map上下文mapContext对象"这篇文章的内容就介绍到这里，感谢各位的阅读！相信大家对"微信小程序如何创建并返回map上下文mapContext对象"知识都有一定的了解，大家如果还想学习更多知识，欢迎关注行业资讯频道。

很赞哦！