@system.geolocation (地理位置)

本模块仅提供GNSS定位、网络定位等基本功能。

说明： - 本模块首批接口从API version 3开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 - 从API Version 9开始，该接口不再维护，推荐使用新接口geoLocationManager。

导入模块

import geolocation from '@system.geolocation';

权限列表

ohos.permission.LOCATION

geolocation.getLocation^(deprecated)

getLocation(options?: GetLocationOption): void

获取设备的地理位置。

说明：
从API version 9开始废弃，建议使用geoLocationManager.getCurrentLocation替代。

需要权限：ohos.permission.LOCATION

系统能力： SystemCapability.Location.Location.Lite

参数:

示例：

export default {    
  getLocation() {        
    geolocation.getLocation({            
      success: function(data) {                
        console.log('success get location data. latitude:' + data.latitude);            
      },            
      fail: function(data, code) {                
        console.log('fail to get location. code:' + code + ', data:' + data);            
      }
    });    
  }
}

geolocation.getLocationType^(deprecated)

getLocationType(options?: GetLocationTypeOption): void

获取当前设备支持的定位类型。

说明：
从API version 9开始废弃。位置服务子系统仅支持gnss和network两种定位类型，后续不再提供接口查询支持的定位类型。

系统能力： SystemCapability.Location.Location.Lite

参数：

示例：

export default {    
  getLocationType() {        
    geolocation.getLocationType({            
      success: function(data) {                
        console.log('success get location type:' + data.types[0]);            
      },            
      fail: function(data, code) {                
        console.log('fail to get location. code:' + code + ', data:' + data);            
       },        
     });    
  },
}

geolocation.subscribe^(deprecated)

subscribe(options: SubscribeLocationOption): void

订阅设备的地理位置信息。多次调用的话，只有最后一次的调用生效。

说明：
从API version 9开始废弃，建议使用geoLocationManager.on(‘locationChange’)替代。

需要权限：ohos.permission.LOCATION

系统能力： SystemCapability.Location.Location.Lite

参数：

示例：

export default {    
  subscribe() {        
    geolocation.subscribe({            
      success: function(data) {                
        console.log('get location. latitude:' + data.latitude);            
      },            
      fail: function(data, code) {                
        console.log('fail to get location. code:' + code + ', data:' + data);            
      },        
    });    
  },
}

geolocation.unsubscribe^(deprecated)

unsubscribe(): void

取消订阅设备的地理位置信息。

说明：
从API version 9开始废弃，建议使用geoLocationManager.off(‘locationChange’)替代。

需要权限：ohos.permission.LOCATION

系统能力： SystemCapability.Location.Location.Lite

示例：

export default {    
  unsubscribe() {        
    geolocation.unsubscribe();    
  }
}

geolocation.getSupportedCoordTypes^(deprecated)

getSupportedCoordTypes(): Array<string>

获取设备支持的坐标系类型。

说明：
从API version 9开始废弃。位置服务子系统仅支持wgs84坐标系，后续不再提供接口查询支持的坐标系类型。

系统能力： SystemCapability.Location.Location.Lite

返回值：

示例：

export default {    
  getSupportedCoordTypes() {       
    var types = geolocation.getSupportedCoordTypes();    
  },
}

GetLocationOption^(deprecated)

单次定位请求的配置参数。

说明：
从API version 9开始废弃，建议使用geoLocationManager.CurrentLocationRequest替代。

需要权限：ohos.permission.LOCATION

系统能力：SystemCapability.Location.Location.Lite

fail返回错误代码：

GeolocationResponse^(deprecated)

位置信息，包含经度、纬度、定位精度等信息。

说明：
从API version 9开始废弃，建议使用geoLocationManager.Location替代。

系统能力：SystemCapability.Location.Location.Lite

GetLocationTypeOption^(deprecated)

查询定位类型接口的入参，用于存放回调函数，在查询成功或者失败时接收查询结果。

说明：
从API version 9开始废弃。

系统能力：SystemCapability.Location.Location.Lite

GetLocationTypeResponse^(deprecated)

当前设备支持的定位类型列表

说明：
从API version 9开始废弃。

系统能力：SystemCapability.Location.Location.Lite

SubscribeLocationOption^(deprecated)

持续定位请求的配置参数。

说明：
从API version 9开始废弃，建议使用geoLocationManager.CurrentLocationRequest替代。

需要权限：ohos.permission.LOCATION

系统能力：SystemCapability.Location.Location.Lite

fail返回错误代码：

你可能感兴趣的鸿蒙文章

harmony 鸿蒙接口

harmony 鸿蒙系统公共事件定义(待停用)

harmony 鸿蒙系统公共事件定义

harmony 鸿蒙开发说明

harmony 鸿蒙企业设备管理概述（仅对系统应用开放）

harmony 鸿蒙BundleStatusCallback

harmony 鸿蒙@ohos.bundle.innerBundleManager (innerBundleManager模块)

harmony 鸿蒙@ohos.distributedBundle (分布式包管理)

harmony 鸿蒙@ohos.bundle (Bundle模块)

harmony 鸿蒙@ohos.enterprise.EnterpriseAdminExtensionAbility (企业设备管理扩展能力)