教程 其他 框架 组件 接口

地理位置

接口声明

{ "name": "system.geolocation" }

导入模块

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

接口定义

geolocation.getLocation(OBJECT)

获取地理位置

权限要求

精确设备定位

参数:

参数名类型必填说明
timeoutLong设置超时时间,单位是 ms,默认值为 30000。在权限被系统拒绝或者定位设置不当的情况下,有可能永远不能返回结果,因而需要设置超时。超时后会使用 fail 回调
successFunction成功回调
failFunction失败回调,原因可能是用户拒绝
completeFunction执行结束后的回调
success 返回值:
参数名类型说明
longitudeNumber经度
latitudeNumber纬度
fail 返回错误代码
错误码说明
201用户拒绝,获取定位权限失败
204超时返回
1000 1000+系统位置开关关闭

示例:

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}`)
  }
})

geolocation.getLocationType(OBJECT) 1010+

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

权限要求

精确设备定位

参数:

参数名类型必填说明
successFunction成功回调
failFunction失败回调
completeFunction执行结束后的回调
success 返回值:
参数名类型说明
typesArray支持的类型['gps','network']

示例:

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

geolocation.subscribe(OBJECT)

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

权限要求

精确设备定位

参数:

参数名类型必填说明
callbackFunction每次位置信息发生变化,都会被回调
failFunction失败回调,原因可能是用户拒绝
callback 返回值:
参数名类型说明
longitudeNumber经度
latitudeNumber纬度
fail 返回错误代码
错误码说明
201用户拒绝,获取定位权限失败
1000 1000+系统位置开关关闭

示例:

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}`)
  }
})

geolocation.unsubscribe()

取消监听地理位置

参数:

示例:

geolocation.unsubscribe()

条匹配 "" 的结果

    没有搜索到与 "" 相关的内容