微信小程序开发文档微信小程序API 地图组件控制

2024-02-25 开发教程微信小程序开发文档匿名 2℃

wx.createMapContext(mapId)

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

mapContext

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

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.wxml -->
<map id="myMap" show-location />
<button type="primary" bindtap="getCenterLocation">获取位置</button>
<button type="primary" bindtap="moveToLocation">移动位置</button>
<button type="primary" bindtap="translateMarker">移动标注</button>
<button type="primary" bindtap="includePoints">缩放视野展示所有经纬度</button>

// map.js
Page({
  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,
      }]
    })
  }
})

上一节：微信小程序API 查看位置

下一节：微信小程序API 监听实时地理位置

"微信小程序开发文档"的目录

微信小程序开发文档 微信小程序API 地图组件控制

wx.createMapContext(mapId)

微信小程序开发文档微信小程序API 地图组件控制