接口聲明

{"name": "system.geolocation"}

導(dǎo)入模塊

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

接口定義

geolocation.getLocation(OBJECT)

獲取地理位置

權(quán)限要求

精確設(shè)備定位

參數(shù)：

success返回值：

fail返回錯(cuò)誤代碼

示例：

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.openLocation(OBJECT)

使用快應(yīng)用內(nèi)置地圖查看位置，并且允許拉起第三方地圖應(yīng)用發(fā)起導(dǎo)航

權(quán)限要求

精確設(shè)備定位

參數(shù)：

fail 返回錯(cuò)誤代碼

示例：

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}`)
  },
  complete: function() {
    console.log(`open location complete`)
  }
})

geolocation.chooseLocation(OBJECT) 

打開(kāi)快應(yīng)用內(nèi)置地圖選擇位置

權(quán)限要求

精確設(shè)備定位

參數(shù)：

success 返回值：

fail 返回錯(cuò)誤代碼

示例：

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(`choose location fail, code = ${code}`)
  },
  complete: function() {
    console.log(`choose location complete`)
  }
})

geolocation.getLocationType(OBJECT) 1010+

獲取系統(tǒng)當(dāng)前支持的定位類型

權(quán)限要求

精確設(shè)備定位

參數(shù)：

success返回值：

示例：

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)

監(jiān)聽(tīng)地理位置。如果多次調(diào)用，僅最后一次調(diào)用生效

參數(shù)：

callback返回值：

fail返回錯(cuò)誤代碼

示例：

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()

取消監(jiān)聽(tīng)地理位置

參數(shù)：

無(wú)

示例：

geolocation.unsubscribe()

geolocation.getSupportedCoordTypes()

獲取支持的坐標(biāo)系類型

參數(shù)：

無(wú)

返回值：

字符串?dāng)?shù)組。當(dāng)前支持的坐標(biāo)系類型，如 [ 'wgs84' ]

示例：

var types = geolocation.getSupportedCoordTypes()

后臺(tái)運(yùn)行限制

manifest 中申請(qǐng)后可用。

后臺(tái)運(yùn)行詳細(xì)用法參見(jiàn) 后臺(tái)運(yùn)行腳本。