地理位置 geolocation

接口声明

{ "name": "system.geolocation" }

导入模块

import geolocation from '@system.geolocation' 或 const geolocation = require('@system.geolocation')

接口定义

geolocation.getLocation(OBJECT)

获取地理位置

权限要求

精确设备定位

参数：

success 返回值：

fail 返回错误代码

示例：

geolocation.getLocation({
  success: function(data) {
    console.log(
      `handling success: longitude = ${data.longitude}, latitude = ${
        data.latitude
      }`
    )
  },
  fail: function(data, code) {
    console.log(`handling fail, code = ${code}, errorMsg=${data}`)
  }
})

geolocation.openLocation(OBJECT) 1070+

使用快应用内置地图查看位置，并且允许拉起第三方地图应用发起导航

权限要求

精确设备定位

参数：

fail 返回错误代码

示例：

geolocation.openLocation({
  latitude: 22.553594050274,
  longitude: 114.0586290118,
  success: function() {
    console.log(`open location success`)
  },
  fail: function(data, code) {
    console.log(`open location fail, code = ${code}, errorMsg=${data}`)
  },
  complete: function() {
    console.log(`open location complete`)
  }
})

geolocation.chooseLocation(OBJECT) 1070+

打开快应用内置地图选择位置

权限要求

精确设备定位

参数：

success 返回值：

fail 返回错误代码

示例：

geolocation.chooseLocation({
  success: function(data) {
    console.log(
      `choose location success: name = ${data.name}, address = ${data.address}, coordType = ${data.coordType}, latitude = ${data.latitude}, longitude = ${data.longitude}`
    )
  },
  fail: function(data, code) {
    console.log(`handling fail, code = ${code}, errorMsg=${data}`)
  },
  complete: function() {
    console.log(`choose location complete`)
  }
})

geolocation.getLocationType(OBJECT) 1010+

获取系统当前支持的定位类型

权限要求

精确设备定位

参数：

success 返回值：

示例：

geolocation.getLocationType({
  success: function(data) {
    console.log(`handling success: locationType = ${data.types}`)
  },
  fail: function(data, code) {
    console.log(`handling fail, code = ${code}, errorMsg=${data}`)  }
})

geolocation.subscribe(OBJECT)

监听地理位置。如果多次调用，仅最后一次调用生效

权限要求

精确设备定位

参数：

callback 返回值：

fail 返回错误代码

示例：

geolocation.subscribe({
  callback: function(data) {
    console.log(
      `handling success: longitude = ${data.longitude}, latitude = ${
        data.latitude
      }`
    )
  },
  fail: function(data, code) {
    console.log(`handling fail, code = ${code}, errorMsg=${data}`)
  }
})

geolocation.unsubscribe()

取消监听地理位置

参数：

无

示例：

geolocation.unsubscribe()

geolocation.getSupportedCoordTypes() 1050+

获取支持的坐标系类型

参数：

无

返回值：

字符串数组。当前支持的坐标系类型，如['wgs84']

示例：

var types = geolocation.getSupportedCoordTypes()

geolocation.geocodeQuery(OBJECT) 1080+

地理编码，只支持国内地理位置

权限要求

无

参数：

success 返回值：

示例：

geolocation.geocodeQuery({
        city: "武汉",
        address: "华中科技大学",
        success: function (ret) {
           console.info(`### geolocation.geocodeQuery ### ${ret.latitude}: ${ret.longitude}`)
        },
        fail: function (erromsg, errocode) {
          console.info(`### geolocation.geocodeQuery ### ${errocode}: ${erromsg}`)
        }
      })

geolocation.reverseGeocodeQuery(OBJECT) 1080+

逆地理编码，只支持国内地理位置

权限要求

无

参数：

success 返回值：

poiInfoList 中 OBJECT 参数

示例：

geolocation.reverseGeocodeQuery({
        latitude: 30.513070973744515,
        longitude: 114.41322124959942,
        coordType: "gcj02",
        includePoiInfo:true,
        success: function (ret) {
          console.info(`### geolocation.reverseGeocodeQuery ###` + JSON.stringify(ret))
        },
        fail: function (erromsg, errocode) {
          console.info(`### geolocation.reverseGeocodeQuery ### ${errocode}: ${erromsg}`)
        }
      })

后台运行限制

manifest 中申请后可用。 后台运行详细用法参见后台运行 脚本。