@system.geolocation (Geolocation)

The geolocation module provides only basic functions such as GNSS positioning and network positioning.

NOTE - The initial APIs of this module are supported since API version 3. Newly added APIs will be marked with a superscript to indicate their earliest API version. - The APIs provided by this module are no longer maintained since API version 9. You are advised to use geoLocationManager instead.

Modules to Import

import geolocation from '@system.geolocation';

Required Permissions

ohos.permission.LOCATION

geolocation.getLocation^(deprecated)

getLocation(options?: GetLocationOption): void

Obtains the geographic location.

NOTE This API is deprecated since API version 9. You are advised to use geoLocationManager.getCurrentLocation.

Required permissions: ohos.permission.LOCATION

System capability: SystemCapability.Location.Location.Lite

Parameters

Example

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

Obtains the supported location types.

NOTE This API is deprecated since API version 9. The location subsystem supports only two location types: GNSS positioning and network positioning. No APIs will be provided to query the supported location types.

System capability: SystemCapability.Location.Location.Lite

Parameters

Example

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

Listens to the geographic location. If this method is called multiple times, the last call takes effect.

NOTE This API is deprecated since API version 9. You are advised to use geoLocationManager.on(‘locationChange’).

Required permissions: ohos.permission.LOCATION

System capability: SystemCapability.Location.Location.Lite

Parameters

Example

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

Cancels listening to the geographic location.

NOTE This API is deprecated since API version 9. You are advised to use geoLocationManager.off(‘locationChange’).

Required permissions: ohos.permission.LOCATION

System capability: SystemCapability.Location.Location.Lite

Example

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

geolocation.getSupportedCoordTypes^(deprecated)

getSupportedCoordTypes(): Array<string>

Obtains coordinate system types supported by the device.

NOTE This API is deprecated since API version 9. The location subsystem supports only the wgs84 coordinate system. No APIs will be provided to query the supported coordinate system types.

System capability: SystemCapability.Location.Location.Lite

Return value

Example

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

GetLocationOption^(deprecated)

Defines the options of a single location request.

NOTE This API is deprecated since API version 9. You are advised to use geoLocationManager.CurrentLocationRequest.

Required permissions: ohos.permission.LOCATION

System capability: SystemCapability.Location.Location.Lite

Return value of fail()

GeolocationResponse^(deprecated)

Defines the location information, including the longitude, latitude, and location precision.

NOTE This API is deprecated since API version 9. You are advised to use geoLocationManager.Location.

System capability: SystemCapability.Location.Location.Lite

GetLocationTypeOption^(deprecated)

Defines the location type option, which holds the callback function used to return the query result.

NOTE This API is deprecated since API version 9.

System capability: SystemCapability.Location.Location.Lite

GetLocationTypeResponse^(deprecated)

Defines the list of location types supported by the current device

NOTE This API is deprecated since API version 9.

System capability: SystemCapability.Location.Location.Lite

SubscribeLocationOption^(deprecated)

Defines the options for continuous location.

NOTE This API is deprecated since API version 9. You are advised to use geoLocationManager.CurrentLocationRequest.

Required permissions: ohos.permission.LOCATION

System capability: SystemCapability.Location.Location.Lite

Return value of fail()

你可能感兴趣的鸿蒙文章

harmony 鸿蒙APIs

harmony 鸿蒙System Common Events (To Be Deprecated Soon)

harmony 鸿蒙System Common Events

harmony 鸿蒙API Reference Document Description

harmony 鸿蒙Enterprise Device Management Overview (for System Applications Only)

harmony 鸿蒙BundleStatusCallback

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

harmony 鸿蒙@ohos.distributedBundle (Distributed Bundle Management)

harmony 鸿蒙@ohos.bundle (Bundle)

harmony 鸿蒙@ohos.enterprise.EnterpriseAdminExtensionAbility (EnterpriseAdminExtensionAbility)