微信小程序8 位置与设备api

位置

wx.getLocation(OBJECT)

获取当前的地理位置、速度。当用户离开小程序后，此接口无法调用；当用户点击“显示在聊天顶部”时，此接口可继续调用

wx.getLocation({
  type: 'wgs84',
  success: function(res) {
    var latitude = res.latitude
    var longitude = res.longitude
    var speed = res.speed
    var accuracy = res.accuracy
  }
})

wx.chooseLocation(OBJECT)

打开地图选择位置。

wx.openLocation(OBJECT)

​使用微信内置地图查看位置。

wx.getLocation({
  type: 'gcj02', //返回可以用于wx.openLocation的经纬度
  success: function(res) {
    var latitude = res.latitude
    var longitude = res.longitude
    wx.openLocation({
      latitude: latitude,
      longitude: longitude,
      scale: 28
    })
  }
})

wx.createMapContext(mapId)

创建并返回 map 上下文 mapContext 对象

<!-- 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,
      }]
    })
  }
})

方法	参数	说明	最低版本
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	获取当前地图的缩放级别

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参数。

设备

wx.getSystemInfo(OBJECT)

获取系统信息。

wx.getSystemInfo({
  success: function(res) {
    console.log(res.model)
    console.log(res.pixelRatio)
    console.log(res.windowWidth)
    console.log(res.windowHeight)
    console.log(res.language)
    console.log(res.version)
    console.log(res.platform)
  }
})

complete

Function

否

接口调用结束的回调函数（调用成功、失败都会执行）

success回调参数说明：

参数	说明	最低版本
brand	手机品牌	1.5.0
model	手机型号
pixelRatio	设备像素比
screenWidth	屏幕宽度	1.1.0
screenHeight	屏幕高度	1.1.0
windowWidth	可使用窗口宽度
windowHeight	可使用窗口高度
language	微信设置的语言
version	微信版本号
system	操作系统版本
platform	客户端平台
fontSizeSetting	用户字体大小设置。以“我-设置-通用-字体大小”中的设置为准，单位：px	1.5.0
SDKVersion	客户端基础库版本	1.1.0

wx.getSystemInfoSync()

获取系统信息同步接口

try {
  var res = wx.getSystemInfoSync()
  console.log(res.model)
  console.log(res.pixelRatio)
  console.log(res.windowWidth)
  console.log(res.windowHeight)
  console.log(res.language)
  console.log(res.version)
  console.log(res.platform)
} catch (e) {
  // Do something when catch error
}