harmony 鸿蒙@ohos.geoLocationManager (Geolocation Manager)

  • 2022-12-22
  • 浏览 (840)

@ohos.geoLocationManager (Geolocation Manager)

The geoLocationManager module provides location services such as Global Navigation Satellite System (GNSS)-based positioning, network positioning, geofencing, as well as geocoding and reverse geocoding.

NOTE

The initial APIs of this module are supported since API version 9. Newly added APIs will be marked with a superscript to indicate their earliest API version.

Applying for Permissions

Before using basic location capabilities, check whether your application has been granted the permission to access the device location information. If not, your application needs to obtain the permission from the user as described below.

The system provides the following location permissions: - ohos.permission.LOCATION

  • ohos.permission.APPROXIMATELY_LOCATION

  • ohos.permission.LOCATION_IN_BACKGROUND

If your application needs to access the device location information, it must first apply for required permissions. Specifically speaking:

API versions earlier than 9: Apply for ohos.permission.LOCATION.

API version 9 and later: Apply for ohos.permission.APPROXIMATELY_LOCATION, or apply for ohos.permission.APPROXIMATELY_LOCATION and ohos.permission.LOCATION. Note that ohos.permission.LOCATION cannot be applied for separately.

API Version Location Permission Permission Application Result Location Accuracy
Earlier than 9 ohos.permission.LOCATION Success Location accurate to meters
9 and later ohos.permission.LOCATION Failure No location obtained
9 and later ohos.permission.APPROXIMATELY_LOCATION Success Location accurate to 5 kilometers
9 and later ohos.permission.APPROXIMATELY_LOCATION and ohos.permission.LOCATION Success Location accurate to meters

If your application needs to access the device location information when running in the background, it must be configured to be able to run in the background and be granted the ohos.permission.LOCATION_IN_BACKGROUND permission. In this way, the system continues to report device location information after your application moves to the background.

You can declare the required permission in your application’s configuration file. For details, see Access Control (Permission) Development.

Modules to Import

import geoLocationManager from '@ohos.geoLocationManager';

ReverseGeoCodeRequest

Defines a reverse geocoding request.

System capability: SystemCapability.Location.Location.Geocoder

Name Type Readable Writable Description
locale string Yes Yes Language used for the location description. zh indicates Chinese, and en indicates English.
latitude number Yes Yes Latitude information. A positive value indicates north latitude, and a negative value indicates south latitude. The value ranges from -90 to 90.
longitude number Yes Yes Longitude information. A positive value indicates east longitude , and a negative value indicates west longitude . The value ranges from -180 to 180.
maxItems number Yes Yes Maximum number of location records to be returned. The specified value must be greater than or equal to 0. A value smaller than 10 is recommended.

GeoCodeRequest

Defines a geocoding request.

System capability: SystemCapability.Location.Location.Geocoder

Name Type Readable Writable Description
locale string Yes Yes Language used for the location description. zh indicates Chinese, and en indicates English.
description string Yes Yes Location description, for example, No. xx, xx Road, Pudong New District, Shanghai.
maxItems number Yes Yes Maximum number of location records to be returned. The specified value must be greater than or equal to 0. A value smaller than 10 is recommended.
minLatitude number Yes Yes Minimum latitude. This parameter is used with minLongitude, maxLatitude, and maxLongitude to specify the latitude and longitude ranges. The value ranges from -90 to 90.
minLongitude number Yes Yes Minimum longitude. The value ranges from -180 to 180.
maxLatitude number Yes Yes Maximum latitude. The value ranges from -90 to 90.
maxLongitude number Yes Yes Maximum longitude. The value ranges from -180 to 180.

GeoAddress

Defines a geographic location.

System capability: SystemCapability.Location.Location.Geocoder

Name Type Readable Writable Description
latitude number Yes No Latitude information. A positive value indicates north latitude, and a negative value indicates south latitude. The value ranges from -90 to 90.
longitude number Yes No Longitude information. A positive value indicates east longitude , and a negative value indicates west longitude . The value ranges from -180 to 180.
locale string Yes No Language used for the location description. zh indicates Chinese, and en indicates English.
placeName string Yes No Landmark of the location.
countryCode string Yes No Country code.
countryName string Yes No Country name.
administrativeArea string Yes No Administrative region name.
subAdministrativeArea string Yes No Sub-administrative region name.
locality string Yes No Locality information.
subLocality string Yes No Sub-locality information.
roadName string Yes No Road name.
subRoadName string Yes No Auxiliary road information.
premises string Yes No House information.
postalCode string Yes No Postal code.
phoneNumber string Yes No Phone number.
addressUrl string Yes No Website URL.
descriptions Array<string> Yes No Additional descriptions.
descriptionsSize number Yes No Total number of additional descriptions. The specified value must be greater than or equal to 0. A value smaller than 10 is recommended.
isFromMock Boolean Yes No Whether the geographical name is from the mock reverse geocoding function.
System API: This is a system API.

LocationRequest

Defines a location request.

System capability: SystemCapability.Location.Location.Core

Name Type Readable Writable Description
priority LocationRequestPriority Yes Yes Priority of the location request. This parameter is effective only when scenario is set to UNSET. If this parameter and scenario are set to UNSET, the attempt to initiate a location request will fail. For details about the value range, see LocationRequestPriority.
scenario LocationRequestScenario Yes Yes Scenario of the location request. The priority parameter is effective only when this parameter is set to UNSET. If this parameter and priority are set to UNSET, the attempt to initiate a location request will fail. For details about the value range, see LocationRequestScenario.
timeInterval number Yes Yes Time interval at which location information is reported, in seconds. The specified value must be greater than or equal to 0. The default value is 1.
distanceInterval number Yes Yes Distance interval at which location information is reported, in meters. The specified value must be greater than or equal to 0. The default value is 0.
maxAccuracy number Yes Yes Location accuracy, in meters. This parameter is valid only when the precise location function is enabled, and is invalid when the approximate location function is enabled. The specified value must be greater than or equal to 0. The default value is 0.

CurrentLocationRequest

Defines the current location request.

System capability: SystemCapability.Location.Location.Core

Name Type Readable Writable Description
priority LocationRequestPriority Yes Yes Priority of the location request. This parameter is effective only when scenario is set to UNSET. If this parameter and scenario are set to UNSET, the attempt to initiate a location request will fail. For details about the value range, see LocationRequestPriority.
scenario LocationRequestScenario Yes Yes Scenario of the location request. The priority parameter is effective only when this parameter is set to UNSET. If this parameter and priority are set to UNSET, the attempt to initiate a location request will fail. For details about the value range, see LocationRequestScenario.
maxAccuracy number Yes Yes Location accuracy, in meters. This parameter is valid only when the precise location function is enabled, and is invalid when the approximate location function is enabled. The specified value must be greater than or equal to 0. The default value is 0.
timeoutMs number Yes Yes Timeout duration, in milliseconds. The minimum value is 1000. The specified value must be greater than or equal to 1000.

SatelliteStatusInfo

Defines the satellite status information.

System capability: SystemCapability.Location.Location.Gnss

Name Type Readable Writable Description
satellitesNumber number Yes No Number of satellites. The specified value must be greater than or equal to 0.
satelliteIds Array<number> Yes No Array of satellite IDs. The specified value must be greater than or equal to 0.
carrierToNoiseDensitys Array<number> Yes No Carrier-to-noise density ratio, that is, cn0. The specified value must be greater than 0.
altitudes Array<number> Yes No Satellite altitude angle information. The value ranges from -90 to 90, in degrees.
azimuths Array<number> Yes No Azimuth information. The value ranges from 0 to 360, in degrees.
carrierFrequencies Array<number> Yes No Carrier frequency, in Hz. The specified value must be greater than or equal to 0.

CachedGnssLocationsRequest

Defines a request for reporting cached GNSS locations.

System capability: SystemCapability.Location.Location.Gnss

Name Type Readable Writable Description
reportingPeriodSec number Yes Yes Interval for reporting the cached GNSS locations, in milliseconds. The specified value must be greater than 0.
wakeUpCacheQueueFull boolean Yes Yes true: reports the cached GNSS locations to the application when the cache queue is full.
false: discards the cached GNSS locations when the cache queue is full.

Geofence

Defines a GNSS geofence. Currently, only circular geofences are supported.

System capability: SystemCapability.Location.Location.Geofence

Name Type Readable Writable Description
latitude number Yes Yes Latitude information. The value ranges from -90 to 90.
longitude number Yes Yes Longitude information. The value ranges from -180 to 180.
radius number Yes Yes Radius of a circular geofence, in meters. The specified value must be greater than 0.
expiration number Yes Yes Expiration period of a geofence, in milliseconds. The specified value must be greater than 0.

GeofenceRequest

Defines a GNSS geofencing request.

System capability: SystemCapability.Location.Location.Geofence

Name Type Readable Writable Description
scenario LocationRequestScenario Yes Yes Location scenario.
geofence Geofence Yes Yes Geofence information.

LocationCommand

Defines an extended command.

System capability: SystemCapability.Location.Location.Core

Name Type Readable Writable Description
scenario LocationRequestScenario Yes Yes Location scenario.
command string Yes Yes Extended command, in the string format.

Location

Defines a location.

System capability: SystemCapability.Location.Location.Core

Name Type Readable Writable Description
latitude number Yes No Latitude information. A positive value indicates north latitude, and a negative value indicates south latitude. The value ranges from -90 to 90.
longitude number Yes No Longitude information. A positive value indicates east longitude , and a negative value indicates west longitude . The value ranges from -180 to 180.
altitude number Yes No Location altitude, in meters.
accuracy number Yes No Location accuracy, in meters.
speed number Yes No Speed, in m/s.
timeStamp number Yes No Location timestamp in the UTC format.
direction number Yes No Direction information. The value ranges from 0 to 360, in degrees.
timeSinceBoot number Yes No Location timestamp since boot.
additions Array<string> Yes No Additional description.
additionSize number Yes No Number of additional descriptions. The specified value must be greater than or equal to 0.
isFromMock Boolean Yes No Whether the location information is from the mock location function.
System API: This is a system API.

ReverseGeocodingMockInfo

Defines the configuration of the mock reverse geocoding function.

System capability: SystemCapability.Location.Location.Core

System API: This is a system API.

Name Type Readable Writable Description
location ReverseGeoCodeRequest Yes Yes Latitude and longitude information.
geoAddress GeoAddress Yes Yes Geographical name.

LocationMockConfig

Defines the configuration of the mock location function.

System capability: SystemCapability.Location.Location.Core

System API: This is a system API.

Name Type Readable Writable Description
timeInterval number Yes Yes Time interval at which mock locations are reported, in seconds.
locations Array<Location> Yes Yes Array of mocked locations.

CountryCode

Defines the country code information.

System capability: SystemCapability.Location.Location.Core

Name Type Readable Writable Description
country string Yes No Country code.
type CountryCodeType Yes No Country code source.

LocatingRequiredDataConfig10+

Defines the configuration for obtaining the required data of the location service.

System capability: SystemCapability.Location.Location.Core

System API: This is a system API.

Name Type Readable Writable Description
type LocatingRequiredDataType Yes Yes Type of the required data.
needStartScan boolean Yes Yes Whether to initiate scanning.
scanInterval number Yes Yes Scanning interval, in milliseconds. The specified value must be greater than 0. The default value is 10000.
scanTimeout number Yes Yes Scanning timeout interval, in milliseconds. The value ranges from 0 to 600000. The default value is 10000.

LocatingRequiredData10+

Defines the required data of the location service, including the Wi-Fi or Bluetooth scanning result. After obtaining the data, an application can use the data for services such as network positioning.

System capability: SystemCapability.Location.Location.Core

System API: This is a system API.

Name Type Readable Writable Description
wifiData WifiScanInfo Yes No Wi-Fi scanning result.
bluetoothData BluetoothScanInfo Yes No Bluetooth scanning result.

WifiScanInfo10+

Defines the Wi-Fi scanning information, including the SSID, BSSID, and RSSI of the scanned Wi-Fi hotspot.

System capability: SystemCapability.Location.Location.Core

System API: This is a system API.

Name Type Readable Writable Description
ssid string Yes No Service set identifier (SSID) of a Wi-Fi hotspot, in UTF-8 format.
bssid string Yes No Base station subsystem identifier (BSSID) of a Wi-Fi hotspot.
rssi number Yes No Received signal strength indicator (RSSI) of a Wi-Fi hotspot, in dBm.
frequency number Yes No Frequency of a Wi-Fi hotspot.
timestamp number Yes No Scanning timestamp.

BluetoothScanInfo10+

Defines the Bluetooth scanning information.

System capability: SystemCapability.Location.Location.Core

System API: This is a system API.

Name Type Readable Writable Description
deviceName string Yes No Name of a Bluetooth device.
macAddress string Yes No MAC address of a Bluetooth device.
rssi number Yes No Signal strength of a Bluetooth device, in dBm.
timestamp number Yes No Scanning timestamp.

LocationRequestPriority

Sets the priority of the location request.

System capability: SystemCapability.Location.Location.Core

Name Value Description
UNSET 0x200 Priority unspecified.
If this option is used, LocationRequestPriority is invalid.
ACCURACY 0x201 Location accuracy.
This policy mainly uses the GNSS positioning technology. In an open area, the technology can achieve the meter-level location accuracy, depending on the hardware performance of the device. However, in a shielded environment, the location accuracy may significantly decrease.
LOW_POWER 0x202 Power efficiency.
This policy mainly uses the base station positioning, WLAN positioning, and Bluetooth positioning technologies to obtain device location in both indoor and outdoor scenarios. The location accuracy depends on the distribution of surrounding base stations, visible WLANs, and Bluetooth devices and therefore may fluctuate greatly. This policy is recommended and can reduce power consumption when your application does not require high location accuracy or when base stations, visible WLANs, and Bluetooth devices are densely distributed.
FIRST_FIX 0x203 Fast location preferred. Use this option if you want to obtain a location as fast as possible.
This policy uses the GNSS positioning, base station positioning, WLAN positioning, and Bluetooth positioning technologies simultaneously to obtain the device location in both the indoor and outdoor scenarios. When all positioning technologies provide a location result, the system provides the most accurate location result for your application. It can lead to significant hardware resource consumption and power consumption.

LocationRequestScenario

Sets the scenario of the location request.

System capability: SystemCapability.Location.Location.Core

Name Value Description
UNSET 0x300 Scenario unspecified.
If this option is used, LocationRequestScenario is invalid.
NAVIGATION 0x301 Navigation.
This option is applicable when your application needs to obtain the real-time location of a mobile device outdoors, such as navigation for driving or walking.
In this scenario, GNSS positioning is used to provide location services to ensure the optimal location accuracy of the system.
The location result is reported at a minimum interval of 1 second by default.
TRAJECTORY_TRACKING 0x302 Trajectory tracking.
This option is applicable when your application needs to record user trajectories, for example, the track recording function of sports applications. In this scenario, the GNSS positioning technology is mainly used to ensure the location accuracy.
The location result is reported at a minimum interval of 1 second by default.
CAR_HAILING 0x303 Ride hailing.
This option is applicable when your application needs to obtain the current location of a user who is hailing a taxi.
The location result is reported at a minimum interval of 1 second by default.
DAILY_LIFE_SERVICE 0x304 Daily life services.
This option is applicable when your application only needs the approximate user location for recommendations and push notifications in scenarios such as when the user is browsing news, shopping online, and ordering food.
The location result is reported at a minimum interval of 1 second by default.
NO_POWER 0x305 Power efficiency. Your application does not proactively start the location service. When responding to another application requesting the same location service, the system marks a copy of the location result to your application. In this way, your application will not consume extra power for obtaining the user location.

LocationPrivacyType

Defines the privacy statement type.

System capability: SystemCapability.Location.Location.Core

System API: This is a system API.

Name Value Description
OTHERS 0 Other scenarios. Reserved field.
STARTUP 1 Privacy statement displayed in the startup wizard. The user needs to choose whether to agree with the statement.
CORE_LOCATION 2 Privacy statement displayed when enabling the location service.

CountryCodeType

Defines the country code source type.

System capability: SystemCapability.Location.Location.Core

Name Value Description
COUNTRY_CODE_FROM_LOCALE 1 Country code obtained from the language configuration of the globalization module.
COUNTRY_CODE_FROM_SIM 2 Country code obtained from the SIM card.
COUNTRY_CODE_FROM_LOCATION 3 Country code obtained using the reverse geocoding function based on the user’s location information.
COUNTRY_CODE_FROM_NETWORK 4 Country code obtained from the cellular network registration information.

LocatingRequiredDataType10+

Defines the type of the required data of the location service.

System capability: SystemCapability.Location.Location.Core

System API: This is a system API.

Name Value Description
WIFI 1 Wi-Fi scanning information.
BLUETOOTH 2 Bluetooth scanning information.

geoLocationManager.on(‘locationChange’)

on(type: ‘locationChange’, request: LocationRequest, callback: Callback<Location>): void

Subscribes to location change events with a location request initiated.

Permission required: ohos.permission.APPROXIMATELY_LOCATION

System capability: SystemCapability.Location.Location.Core

Parameters

Name Type Mandatory Description
type string Yes Event type. The value locationChange indicates a location change.
request LocationRequest Yes Location request.
callback Callback<Location> Yes Callback used to receive location change events.

Error codes

For details about the error codes, see Location Error Codes.

ID Error Message
3301000 Location service is unavailable.
3301100 The location switch is off.
3301200 Failed to obtain the geographical location.

Example

  import geoLocationManager from '@ohos.geoLocationManager';
  import BusinessError from "@ohos.base";
  let requestInfo:geoLocationManager.LocationRequest = {'priority': geoLocationManager.LocationRequestPriority.FIRST_FIX, 'scenario': geoLocationManager.LocationRequestScenario.UNSET, 'timeInterval': 1, 'distanceInterval': 0, 'maxAccuracy': 0};
  let locationChange = (location:geoLocationManager.Location):void => {
      console.log('locationChanger: data: ' + JSON.stringify(location));
  };
  try {
      geoLocationManager.on('locationChange', requestInfo, locationChange);
  } catch (err) {
      console.error("errCode:" + (err as BusinessError.BusinessError).code + ",errMessage:" + (err as BusinessError.BusinessError).message);
  }
  

geoLocationManager.off(‘locationChange’)

off(type: ‘locationChange’, callback?: Callback<Location>): void

Unsubscribes from location change events with the corresponding location request deleted.

Permission required: ohos.permission.APPROXIMATELY_LOCATION

System capability: SystemCapability.Location.Location.Core

Parameters

Name Type Mandatory Description
type string Yes Event type. The value locationChange indicates a location change.
callback Callback<Location> No Callback to unregister. If this parameter is not specified, all callbacks of the specified event type are unregistered.

Error codes

For details about the error codes, see Location Error Codes.

ID Error Message
3301000 Location service is unavailable.
3301100 The location switch is off.
3301200 Failed to obtain the geographical location.

Example

  import geoLocationManager from '@ohos.geoLocationManager';
  import BusinessError from "@ohos.base";
  let requestInfo:geoLocationManager.LocationRequest = {'priority': geoLocationManager.LocationRequestPriority.FIRST_FIX, 'scenario': geoLocationManager.LocationRequestScenario.UNSET, 'timeInterval': 1, 'distanceInterval': 0, 'maxAccuracy': 0};
  let locationChange = (location:geoLocationManager.Location):void => {
    console.log('locationChanger: data: ' + JSON.stringify(location));
  };
  try {
      geoLocationManager.on('locationChange', requestInfo, locationChange);
      geoLocationManager.off('locationChange', locationChange);
  } catch (err) {
      console.error("errCode:" + (err as BusinessError.BusinessError).code + ",errMessage:" + (err as BusinessError.BusinessError).message);
  }

geoLocationManager.on(‘locationEnabledChange’)

on(type: ‘locationEnabledChange’, callback: Callback<boolean>): void

Subscribes to location service status change events.

System capability: SystemCapability.Location.Location.Core

Parameters

Name Type Mandatory Description
type string Yes Event type. The value locationEnabledChange indicates a location service status change.
callback Callback<boolean> Yes Callback used to receive location service status change events.

Error codes

For details about the error codes, see Location Error Codes.

ID Error Message
3301000 Location service is unavailable.

Example

  import geoLocationManager from '@ohos.geoLocationManager';
  import BusinessError from "@ohos.base";
  let locationEnabledChange = (state:boolean):void => {
      console.log('locationEnabledChange: ' + JSON.stringify(state));
  }
  try {
      geoLocationManager.on('locationEnabledChange', locationEnabledChange);
  } catch (err) {
      console.error("errCode:" + (err as BusinessError.BusinessError).code + ",errMessage:" + (err as BusinessError.BusinessError).message);
  }

geoLocationManager.off(‘locationEnabledChange’)

off(type: ‘locationEnabledChange’, callback?: Callback<boolean>): void;

Unsubscribes from location service status change events.

System capability: SystemCapability.Location.Location.Core

Parameters

Name Type Mandatory Description
type string Yes Event type. The value locationEnabledChange indicates a location service status change.
callback Callback<boolean> No Callback to unregister. If this parameter is not specified, all callbacks of the specified event type are unregistered.

Error codes

For details about the error codes, see Location Error Codes.

ID Error Message
3301000 Location service is unavailable.

Example

  import geoLocationManager from '@ohos.geoLocationManager';
  import BusinessError from "@ohos.base";
  let locationEnabledChange = (state:boolean):void => {
      console.log('locationEnabledChange: state: ' + JSON.stringify(state));
  }
  try {
      geoLocationManager.on('locationEnabledChange', locationEnabledChange);
      geoLocationManager.off('locationEnabledChange', locationEnabledChange);
  } catch (err) {
      console.error("errCode:" + (err as BusinessError.BusinessError).code + ",errMessage:" + (err as BusinessError.BusinessError).message);
  }

geoLocationManager.on(‘cachedGnssLocationsChange’)

on(type: ‘cachedGnssLocationsChange’, request: CachedGnssLocationsRequest, callback: Callback<Array<Location>>): void;

Subscribes to cached GNSS location reports. This API is supported only by certain GNSS chip models. If the required chip model is not available, error code 801 (Capability not supported) will be reported.

Permission required: ohos.permission.APPROXIMATELY_LOCATION

System capability: SystemCapability.Location.Location.Gnss

Parameters

Name Type Mandatory Description
type string Yes Event type. The value cachedGnssLocationsChange indicates reporting of cached GNSS locations.
request CachedGnssLocationsRequest Yes Request for reporting cached GNSS location.
callback Callback<boolean> Yes Callback used to receive cached GNSS locations.

Error codes

For details about the error codes, see Location Error Codes.

ID Error Message
3301000 Location service is unavailable.
3301100 The location switch is off.
3301200 Failed to obtain the geographical location.

Example

  import geoLocationManager from '@ohos.geoLocationManager';
  import BusinessError from "@ohos.base";
  let cachedLocationsCb = (locations:Array<geoLocationManager.Location>):void => {
      console.log('cachedGnssLocationsChange: locations: ' + JSON.stringify(locations));
  }
  let requestInfo:geoLocationManager.CachedGnssLocationsRequest = {'reportingPeriodSec': 10, 'wakeUpCacheQueueFull': true};
  try {
      geoLocationManager.on('cachedGnssLocationsChange', requestInfo, cachedLocationsCb);
  } catch (err) {
      console.error("errCode:" + (err as BusinessError.BusinessError).code + ",errMessage:" + (err as BusinessError.BusinessError).message);
  }

geoLocationManager.off(‘cachedGnssLocationsChange’)

off(type: ‘cachedGnssLocationsChange’, callback?: Callback&lt;Array&lt;Location&gt;&gt;): void;

Unsubscribes from cached GNSS location reports. This API is supported only by certain GNSS chip models. If the required chip model is not available, error code 801 (Capability not supported) will be reported.

Permission required: ohos.permission.APPROXIMATELY_LOCATION

System capability: SystemCapability.Location.Location.Gnss

Parameters

Name Type Mandatory Description
type string Yes Event type. The value cachedGnssLocationsChange indicates reporting of cached GNSS locations.
callback Callback&lt;boolean&gt; No Callback to unregister. If this parameter is not specified, all callbacks of the specified event type are unregistered.

Error codes

For details about the error codes, see Location Error Codes.

ID Error Message
3301000 Location service is unavailable.
3301100 The location switch is off.
3301200 Failed to obtain the geographical location.

Example

  import geoLocationManager from '@ohos.geoLocationManager';
  import BusinessError from "@ohos.base";
  let cachedLocationsCb = (locations:Array<geoLocationManager.Location>):void => {
      console.log('cachedGnssLocationsChange: locations: ' + JSON.stringify(locations));
  }
  let requestInfo:geoLocationManager.CachedGnssLocationsRequest = {'reportingPeriodSec': 10, 'wakeUpCacheQueueFull': true};
  try {
      geoLocationManager.on('cachedGnssLocationsChange', requestInfo, cachedLocationsCb);
      geoLocationManager.off('cachedGnssLocationsChange');
  } catch (err) {
      console.error("errCode:" + (err as BusinessError.BusinessError).code + ",errMessage:" + (err as BusinessError.BusinessError).message);
  }

geoLocationManager.on(‘satelliteStatusChange’)

on(type: ‘satelliteStatusChange’, callback: Callback&lt;SatelliteStatusInfo&gt;): void;

Subscribes to GNSS satellite status change events.

Permission required: ohos.permission.APPROXIMATELY_LOCATION

System capability: SystemCapability.Location.Location.Gnss

Parameters

Name Type Mandatory Description
type string Yes Event type. The value satelliteStatusChange indicates a GNSS satellite status change.
callback Callback&lt;SatelliteStatusInfo&gt; Yes Callback used to receive GNSS satellite status change events.

Error codes

For details about the error codes, see Location Error Codes.

ID Error Message
3301000 Location service is unavailable.
3301100 The location switch is off.

Example

  import geoLocationManager from '@ohos.geoLocationManager';
  import BusinessError from "@ohos.base";
  let gnssStatusCb = (satelliteStatusInfo:geoLocationManager.SatelliteStatusInfo):void => {
      console.log('satelliteStatusChange: ' + JSON.stringify(satelliteStatusInfo));
  }

  try {
      geoLocationManager.on('satelliteStatusChange', gnssStatusCb);
  } catch (err) {
      console.error("errCode:" + (err as BusinessError.BusinessError).code + ",errMessage:" + (err as BusinessError.BusinessError).message);
  }

geoLocationManager.off(‘satelliteStatusChange’)

off(type: ‘satelliteStatusChange’, callback?: Callback&lt;SatelliteStatusInfo&gt;): void;

Unsubscribes from GNSS satellite status change events.

Permission required: ohos.permission.APPROXIMATELY_LOCATION

System capability: SystemCapability.Location.Location.Gnss

Parameters

Name Type Mandatory Description
type string Yes Event type. The value satelliteStatusChange indicates a GNSS satellite status change.
callback Callback&lt;SatelliteStatusInfo&gt; No Callback to unregister. If this parameter is not specified, all callbacks of the specified event type are unregistered.

Error codes

For details about the error codes, see Location Error Codes.

ID Error Message
3301000 Location service is unavailable.
3301100 The location switch is off.

Example

  import geoLocationManager from '@ohos.geoLocationManager';
  import BusinessError from "@ohos.base";
  let gnssStatusCb = (satelliteStatusInfo:geoLocationManager.SatelliteStatusInfo):void => {
      console.log('satelliteStatusChange: ' + JSON.stringify(satelliteStatusInfo));
  }
  try {
      geoLocationManager.on('satelliteStatusChange', gnssStatusCb);
      geoLocationManager.off('satelliteStatusChange', gnssStatusCb);
  } catch (err) {
      console.error("errCode:" + (err as BusinessError.BusinessError).code + ",errMessage:" + (err as BusinessError.BusinessError).message);
  }

geoLocationManager.on(‘nmeaMessage’)

on(type: ‘nmeaMessage’, callback: Callback&lt;string&gt;): void;

Subscribes to GNSS NMEA message change events.

Required permissions: ohos.permission.LOCATION and ohos.permission.APPROXIMATELY_LOCATION

System capability: SystemCapability.Location.Location.Gnss

Parameters

Name Type Mandatory Description
type string Yes Event type. The value nmeaMessage indicates a GNSS NMEA message change.
callback Callback&lt;string&gt; Yes Callback used to receive GNSS NMEA message change events.

Error codes

For details about the error codes, see Location Error Codes.

ID Error Message
3301000 Location service is unavailable.
3301100 The location switch is off.

Example

  import geoLocationManager from '@ohos.geoLocationManager';
  import BusinessError from "@ohos.base";
  let nmeaCb = (str:string):void => {
      console.log('nmeaMessage: ' + JSON.stringify(str));
  }

  try {
      geoLocationManager.on('nmeaMessage', nmeaCb );
  } catch (err) {
      console.error("errCode:" + (err as BusinessError.BusinessError).code + ",errMessage:" + (err as BusinessError.BusinessError).message);
  }

geoLocationManager.off(‘nmeaMessage’)

off(type: ‘nmeaMessage’, callback?: Callback&lt;string&gt;): void;

Unsubscribes from GNSS NMEA message change events.

Required permissions: ohos.permission.LOCATION and ohos.permission.APPROXIMATELY_LOCATION

System capability: SystemCapability.Location.Location.Gnss

Parameters

Name Type Mandatory Description
type string Yes Event type. The value nmeaMessage indicates a GNSS NMEA message change.
callback Callback&lt;string&gt; No Callback to unregister. If this parameter is not specified, all callbacks of the specified event type are unregistered.

Error codes

For details about the error codes, see Location Error Codes.

ID Error Message
3301000 Location service is unavailable.
3301100 The location switch is off.

Example

  import geoLocationManager from '@ohos.geoLocationManager';
  import BusinessError from "@ohos.base";
  let nmeaCb = (str:string):void => {
      console.log('nmeaMessage: ' + JSON.stringify(str));
  }

  try {
      geoLocationManager.on('nmeaMessage', nmeaCb);
      geoLocationManager.off('nmeaMessage', nmeaCb);
  } catch (err) {
      console.error("errCode:" + (err as BusinessError.BusinessError).code + ",errMessage:" + (err as BusinessError.BusinessError).message);
  }

geoLocationManager.on(‘gnssFenceStatusChange’)

on(type: ‘gnssFenceStatusChange’, request: GeofenceRequest, want: WantAgent): void;

Subscribes to status change events of the specified geofence. This API is supported only by certain GNSS chip models. If the required chip model is not available, error code 801 (Capability not supported) will be reported.

Permission required: ohos.permission.APPROXIMATELY_LOCATION

System capability: SystemCapability.Location.Location.Geofence

Parameters

Name Type Mandatory Description
type string Yes Event type. The value gnssFenceStatusChange indicates a geofence status change.
request GeofenceRequest Yes Geofencing request.
want WantAgent Yes WantAgent used to receive geofence (entrance or exit) events.

Error codes

For details about the error codes, see Location Error Codes.

ID Error Message
3301000 Location service is unavailable.
3301100 The location switch is off.
3301600 Failed to operate the geofence.

Example

  import geoLocationManager from '@ohos.geoLocationManager';
  import wantAgent from '@ohos.app.ability.wantAgent';
  import BusinessError from "@ohos.base";

  let wantAgentInfo:wantAgent.WantAgentInfo = {
      wants: [
          {
              bundleName: "com.example.myapplication",
              abilityName: "EntryAbility",
              action: "action1"
          }
      ],
      operationType: wantAgent.OperationType.START_ABILITY,
      requestCode: 0,
      wantAgentFlags: [wantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
  };
  
  wantAgent.getWantAgent(wantAgentInfo).then((wantAgentObj) => {
    let requestInfo:geoLocationManager.GeofenceRequest = {'scenario': 0x301, "geofence": {"latitude": 121, "longitude": 26, "radius": 100, "expiration": 10000}};
    try {
        geoLocationManager.on('gnssFenceStatusChange', requestInfo, wantAgentObj);
    } catch (err) {
        console.error("errCode:" + (err as BusinessError.BusinessError).code + ",errMessage:" + (err as BusinessError.BusinessError).message);
    }
  });

geoLocationManager.off(‘gnssFenceStatusChange’)

off(type: ‘gnssFenceStatusChange’, request: GeofenceRequest, want: WantAgent): void;

Unsubscribes from status change events of the specified geofence. This API is supported only by certain GNSS chip models. If the required chip model is not available, error code 801 (Capability not supported) will be reported.

Permission required: ohos.permission.APPROXIMATELY_LOCATION

System capability: SystemCapability.Location.Location.Geofence

Parameters

Name Type Mandatory Description
type string Yes Event type. The value gnssFenceStatusChange indicates a geofence status change.
request GeofenceRequest Yes Geofencing request.
want WantAgent Yes WantAgent used to receive geofence (entrance or exit) events.

Error codes

For details about the error codes, see Location Error Codes.

ID Error Message
3301000 Location service is unavailable.
3301100 The location switch is off.
3301600 Failed to operate the geofence.

Example

  import geoLocationManager from '@ohos.geoLocationManager';
  import wantAgent from '@ohos.app.ability.wantAgent';
  import BusinessError from "@ohos.base";
  
  let wantAgentInfo:wantAgent.WantAgentInfo = {
      wants: [
          {
              bundleName: "com.example.myapplication",
              abilityName: "EntryAbility",
              action: "action1",
          }
      ],
      operationType: wantAgent.OperationType.START_ABILITY,
      requestCode: 0,
      wantAgentFlags: [wantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
  };
  
  wantAgent.getWantAgent(wantAgentInfo).then((wantAgentObj) => {
    let requestInfo:geoLocationManager.GeofenceRequest = {'scenario': 0x301, "geofence": {"latitude": 121, "longitude": 26, "radius": 100, "expiration": 10000}};;
    try {
        geoLocationManager.on('gnssFenceStatusChange', requestInfo, wantAgentObj);
        geoLocationManager.off('gnssFenceStatusChange', requestInfo, wantAgentObj);
    } catch (err) {
        console.error("errCode:" + (err as BusinessError.BusinessError).code + ",errMessage:" + (err as BusinessError.BusinessError).message);
    }
  });

geoLocationManager.on(‘countryCodeChange’)

on(type: ‘countryCodeChange’, callback: Callback&lt;CountryCode&gt;): void;

Subscribes to country code change events.

System capability: SystemCapability.Location.Location.Core

Parameters

Name Type Mandatory Description
type string Yes Event type. The value countryCodeChange indicates a country code change.
callback Callback&lt;CountryCode&gt; Yes Callback used to receive country code change events.

Error codes

For details about the error codes, see Location Error Codes.

ID Error Message
3301000 Location service is unavailable.
3301500 Failed to query the area information.

Example

  import geoLocationManager from '@ohos.geoLocationManager';
  import BusinessError from "@ohos.base";
  let callback = (code:geoLocationManager.CountryCode):void => {
      console.log('countryCodeChange: ' + JSON.stringify(code));
  }

  try {
      geoLocationManager.on('countryCodeChange', callback);
  } catch (err) {
      console.error("errCode:" + (err as BusinessError.BusinessError).code + ",errMessage:" + (err as BusinessError.BusinessError).message);
  }

geoLocationManager.off(‘countryCodeChange’)

off(type: ‘countryCodeChange’, callback?: Callback&lt;CountryCode&gt;): void;

Unsubscribes from country code change events.

System capability: SystemCapability.Location.Location.Core

Parameters

Name Type Mandatory Description
type string Yes Event type. The value countryCodeChange indicates a country code change.
callback Callback&lt;CountryCode&gt; No Callback to unregister. If this parameter is not specified, all callbacks of the specified event type are unregistered.

Error codes

For details about the error codes, see Location Error Codes.

ID Error Message
3301000 Location service is unavailable.
3301500 Failed to query the area information.

Example

  import geoLocationManager from '@ohos.geoLocationManager';
  import BusinessError from "@ohos.base";
  let callback = (code:geoLocationManager.CountryCode):void => {
      console.log('countryCodeChange: ' + JSON.stringify(code));
  }

  try {
      geoLocationManager.on('countryCodeChange', callback);
      geoLocationManager.off('countryCodeChange', callback);
  } catch (err) {
      console.error("errCode:" + (err as BusinessError.BusinessError).code + ",errMessage:" + (err as BusinessError.BusinessError).message);
  }

geoLocationManager.on(‘locatingRequiredDataChange’)10+

on(type: ‘locatingRequiredDataChange’, config: LocatingRequiredDataConfig, callback: Callback&lt;Array&lt;LocatingRequiredData&gt;&gt;): void;

Subscribes to changes in the required data of the location service, including Wi-Fi and Bluetooth scanning information. An application can then determine whether to enable Wi-Fi and Bluetooth scanning based on the return result.

Required permissions: ohos.permission.LOCATION and ohos.permission.APPROXIMATELY_LOCATION

System capability: SystemCapability.Location.Location.Core

System API: This is a system API.

Parameters

Name Type Mandatory Description
type string Yes Event type. The value locatingRequiredDataChange indicates a change in the required data of the location service.
config LocatingRequiredDataConfig Yes Configuration for obtaining the required data of the location service.
callback Callback&lt;Array&lt;LocatingRequiredData&gt;&gt; Yes Callback used to receive the required data of the location service.

Error codes

For details about the error codes, see Location Error Codes.

ID Error Message
3301800 Failed to start WiFi or Bluetooth scanning.

Example

  import geoLocationManager from '@ohos.geoLocationManager';
  import BusinessError from "@ohos.base";
  let callback = (code:Array<geoLocationManager.LocatingRequiredData>):void => {
      console.log('locatingRequiredDataChange: ' + JSON.stringify(code));
  }
  let config:geoLocationManager.LocatingRequiredDataConfig = {'type': 1, 'needStartScan': true, 'scanInterval': 10000};
  try {
      geoLocationManager.on('locatingRequiredDataChange', config, callback);
  } catch (err) {
      console.error("errCode:" + (err as BusinessError.BusinessError).code + ",errMessage:" + (err as BusinessError.BusinessError).message);
  }

geoLocationManager.off(‘locatingRequiredDataChange’)10+

off(type: ‘locatingRequiredDataChange’, callback?: Callback&lt;Array&lt;LocatingRequiredData&gt;&gt;): void;

Unsubscribes from changes in the required data of the location service and stops Wi-Fi and Bluetooth scanning.

Required permissions: ohos.permission.LOCATION and ohos.permission.APPROXIMATELY_LOCATION

System capability: SystemCapability.Location.Location.Core

System API: This is a system API.

Parameters

Name Type Mandatory Description
type string Yes Event type. The value locatingRequiredDataChange indicates a change in the required data of the location service.
callback Callback&lt;Array&lt;LocatingRequiredData&gt;&gt; No Callback to unregister. If this parameter is not specified, all callbacks of the specified event type are unregistered.

Error codes

For details about the error codes, see Location Error Codes.

Example

  import geoLocationManager from '@ohos.geoLocationManager';
  import BusinessError from "@ohos.base";
  let callback = (code:Array<geoLocationManager.LocatingRequiredData>):void => {
      console.log('locatingRequiredDataChange: ' + JSON.stringify(code));
  }
  let config:geoLocationManager.LocatingRequiredDataConfig = {'type': 1, 'needStartScan': true, 'scanInterval': 10000};
  try {
      geoLocationManager.on('locatingRequiredDataChange', config, callback);
      geoLocationManager.off('locatingRequiredDataChange', callback);
  } catch (err) {
      console.error("errCode:" + (err as BusinessError.BusinessError).code + ",errMessage:" + (err as BusinessError.BusinessError).message);
  }

geoLocationManager.getCurrentLocation

getCurrentLocation(request: CurrentLocationRequest, callback: AsyncCallback&lt;Location&gt;): void

Obtains the current location. This API uses an asynchronous callback to return the result.

Permission required: ohos.permission.APPROXIMATELY_LOCATION

System capability: SystemCapability.Location.Location.Core

Parameters

Name Type Mandatory Description
request CurrentLocationRequest Yes Location request.
callback AsyncCallback&lt;Location&gt; Yes Callback used to receive the current location.

Error codes

For details about the error codes, see Location Error Codes.

ID Error Message
3301000 Location service is unavailable.
3301100 The location switch is off.
3301200 Failed to obtain the geographical location.

Example

  import geoLocationManager from '@ohos.geoLocationManager';
  import BusinessError from "@ohos.base";
  let requestInfo:geoLocationManager.CurrentLocationRequest = {'priority': geoLocationManager.LocationRequestPriority.FIRST_FIX, 'scenario': geoLocationManager.LocationRequestScenario.UNSET,'maxAccuracy': 0};
  let locationChange = (err:BusinessError.BusinessError, location:geoLocationManager.Location):void => {
      if (err) {
          console.log('locationChanger: err=' + JSON.stringify(err));
      }
      if (location) {
          console.log('locationChanger: location=' + JSON.stringify(location));
      }
  };

  try {
      geoLocationManager.getCurrentLocation(requestInfo, locationChange);
  } catch (err) {
      console.error("errCode:" + (err as BusinessError.BusinessError).code + ",errMessage:" + (err as BusinessError.BusinessError).message);
  }

geoLocationManager.getCurrentLocation

getCurrentLocation(callback: AsyncCallback&lt;Location&gt;): void;

Obtains the current location. This API uses an asynchronous callback to return the result.

Permission required: ohos.permission.APPROXIMATELY_LOCATION

System capability: SystemCapability.Location.Location.Core

Parameters

Name Type Mandatory Description
callback AsyncCallback&lt;Location&gt; Yes Callback used to receive the current location.

Error codes

For details about the error codes, see Location Error Codes.

ID Error Message
3301000 Location service is unavailable.
3301100 The location switch is off.
3301200 Failed to obtain the geographical location.

Example

  import geoLocationManager from '@ohos.geoLocationManager';
  import BusinessError from "@ohos.base";
  let locationChange = (err:BusinessError.BusinessError, location:geoLocationManager.Location) => {
      if (err) {
          console.log('locationChanger: err=' + JSON.stringify(err));
      }
      if (location) {
          console.log('locationChanger: location=' + JSON.stringify(location));
      }
  };

  try {
      geoLocationManager.getCurrentLocation(locationChange);
  } catch (err) {
      console.error("errCode:" + (err as BusinessError.BusinessError).code + ",errMessage:" + (err as BusinessError.BusinessError).message);
  }

geoLocationManager.getCurrentLocation

getCurrentLocation(request?: CurrentLocationRequest): Promise&lt;Location&gt;

Obtains the current location. This API uses a promise to return the result.

Permission required: ohos.permission.APPROXIMATELY_LOCATION

System capability: SystemCapability.Location.Location.Core

Parameters

Name Type Mandatory Description
request CurrentLocationRequest No Location request.

Return value

Name Type Mandatory Description
Promise&lt;Location&gt; Location NA Promise used to return the current location.

Error codes

For details about the error codes, see Location Error Codes.

ID Error Message
3301000 Location service is unavailable.
3301100 The location switch is off.
3301200 Failed to obtain the geographical location.

Example

  import geoLocationManager from '@ohos.geoLocationManager';
  import BusinessError from "@ohos.base";
  let requestInfo:geoLocationManager.CurrentLocationRequest = {'priority': geoLocationManager.LocationRequestPriority.FIRST_FIX, 'scenario': geoLocationManager.LocationRequestScenario.UNSET,'maxAccuracy': 0};
  try {
      geoLocationManager.getCurrentLocation(requestInfo).then((result) => {
          console.log('current location: ' + JSON.stringify(result));
      })  
      .catch((error:number) => {
          console.log('promise, getCurrentLocation: error=' + JSON.stringify(error));
      });
  } catch (err) {
      console.error("errCode:" + (err as BusinessError.BusinessError).code + ",errMessage:" + (err as BusinessError.BusinessError).message);
  }

geoLocationManager.getLastLocation

getLastLocation(): Location

Obtains the last location.

Permission required: ohos.permission.APPROXIMATELY_LOCATION

System capability: SystemCapability.Location.Location.Core

Return value

Name Type Mandatory Description
Location Location NA Location information.

Error codes

For details about the error codes, see Location Error Codes.

ID Error Message
3301000 Location service is unavailable.
3301100 The location switch is off.
3301200 Failed to obtain the geographical location.

Example

  import geoLocationManager from '@ohos.geoLocationManager';
  import BusinessError from "@ohos.base";
  try {
      let location = geoLocationManager.getLastLocation();
  } catch (err) {
      console.error("errCode:" + (err as BusinessError.BusinessError).code + ",errMessage:" + (err as BusinessError.BusinessError).message);
  }

geoLocationManager.isLocationEnabled

isLocationEnabled(): boolean

Checks whether the location service is enabled.

System capability: SystemCapability.Location.Location.Core

Return value

Name Type Mandatory Description
boolean boolean NA Result indicating whether the location service is enabled.

Error codes

For details about the error codes, see Location Error Codes.

ID Error Message
3301000 Location service is unavailable.

Example

  import geoLocationManager from '@ohos.geoLocationManager';
  import BusinessError from "@ohos.base";
  try {
      let locationEnabled = geoLocationManager.isLocationEnabled();
  } catch (err) {
      console.error("errCode:" + (err as BusinessError.BusinessError).code + ",errMessage:" + (err as BusinessError.BusinessError).message);
  }

geoLocationManager.enableLocation

enableLocation(callback: AsyncCallback&lt;void&gt;): void;

Enables the location service. This API uses an asynchronous callback to return the result.

System API: This is a system API.

Required permissions: ohos.permission.MANAGE_SECURE_SETTINGS

System capability: SystemCapability.Location.Location.Core

Parameters

Name Type Mandatory Description
callback AsyncCallback&lt;void&gt; Yes Callback used to receive the error message.

Error codes

For details about the error codes, see Location Error Codes.

ID Error Message
3301000 Location service is unavailable.

Example

  import geoLocationManager from '@ohos.geoLocationManager';
  import BusinessError from "@ohos.base";
  try {
      geoLocationManager.enableLocation((err, data) => {
          if (err) {
              console.log('enableLocation: err=' + JSON.stringify(err));
          }
      });
  } catch (err) {
      console.error("errCode:" + (err as BusinessError.BusinessError).code + ",errMessage:" + (err as BusinessError.BusinessError).message);
  }

geoLocationManager.enableLocation

enableLocation(): Promise&lt;void&gt;

Enables the location service. This API uses a promise to return the result.

System API: This is a system API.

Required permissions: ohos.permission.MANAGE_SECURE_SETTINGS

System capability: SystemCapability.Location.Location.Core

Return value

Name Type Mandatory Description
Promise&lt;void&gt; void NA Promise used to return the error message.

Error codes

For details about the error codes, see Location Error Codes.

ID Error Message
3301000 Location service is unavailable.

Example

  import geoLocationManager from '@ohos.geoLocationManager';
  import BusinessError from "@ohos.base";
  try {
      geoLocationManager.enableLocation().then((result) => {
          console.log('promise, enableLocation succeed');
      })
      .catch((error:number) => {
          console.log('promise, enableLocation: error=' + JSON.stringify(error));
      });
  } catch (err) {
      console.error("errCode:" + (err as BusinessError.BusinessError).code + ",errMessage:" + (err as BusinessError.BusinessError).message);
  }

geoLocationManager.disableLocation

disableLocation(): void;

Disables the location service.

System API: This is a system API.

Required permissions: ohos.permission.MANAGE_SECURE_SETTINGS

System capability: SystemCapability.Location.Location.Core

Error codes

For details about the error codes, see Location Error Codes.

ID Error Message
3301000 Location service is unavailable.

Example

  import geoLocationManager from '@ohos.geoLocationManager';
  import BusinessError from "@ohos.base";
  try {
      geoLocationManager.disableLocation();
  } catch (err) {
      console.error("errCode:" + (err as BusinessError.BusinessError).code + ",errMessage:" + (err as BusinessError.BusinessError).message);
  }

geoLocationManager.getAddressesFromLocation

getAddressesFromLocation(request: ReverseGeoCodeRequest, callback: AsyncCallback&lt;Array&lt;GeoAddress&gt;&gt;): void

Converts coordinates into geographic description through reverse geocoding. This API uses an asynchronous callback to return the result.

System capability: SystemCapability.Location.Location.Geocoder

Parameters

Name Type Mandatory Description
request ReverseGeoCodeRequest Yes Reverse geocoding request.
callback AsyncCallback&lt;Array&lt;GeoAddress&gt;&gt; Yes Callback used to receive the reverse geocoding result.

Error codes

For details about the error codes, see Location Error Codes.

ID Error Message
3301000 Location service is unavailable.
3301300 Reverse geocoding query failed.

Example

  import geoLocationManager from '@ohos.geoLocationManager';
  import BusinessError from "@ohos.base";
  let reverseGeocodeRequest:geoLocationManager.ReverseGeoCodeRequest = {"latitude": 31.12, "longitude": 121.11, "maxItems": 1};
  try {
      geoLocationManager.getAddressesFromLocation(reverseGeocodeRequest, (err, data) => {
          if (err) {
              console.log('getAddressesFromLocation: err=' + JSON.stringify(err));
          }
          if (data) {
              console.log('getAddressesFromLocation: data=' + JSON.stringify(data));
          }
      });
  } catch (err) {
      console.error("errCode:" + (err as BusinessError.BusinessError).code + ",errMessage:" + (err as BusinessError.BusinessError).message);
  }

geoLocationManager.getAddressesFromLocation

getAddressesFromLocation(request: ReverseGeoCodeRequest): Promise&lt;Array&lt;GeoAddress&gt;&gt;;

Converts coordinates into geographic description through reverse geocoding. This API uses a promise to return the result.

System capability: SystemCapability.Location.Location.Geocoder

Parameters

Name Type Mandatory Description
request ReverseGeoCodeRequest Yes Reverse geocoding request.

Return value

Name Type Mandatory Description
Promise&lt;Array&lt;GeoAddress&gt;&gt; Array&lt;GeoAddress&gt; NA Promise used to return the reverse geocoding result.

Error codes

For details about the error codes, see Location Error Codes.

ID Error Message
3301000 Location service is unavailable.
3301300 Reverse geocoding query failed.

Example

  import geoLocationManager from '@ohos.geoLocationManager';
  import BusinessError from "@ohos.base";
  let reverseGeocodeRequest:geoLocationManager.ReverseGeoCodeRequest = {"latitude": 31.12, "longitude": 121.11, "maxItems": 1};
  try {
      geoLocationManager.getAddressesFromLocation(reverseGeocodeRequest).then((data) => {
          console.log('getAddressesFromLocation: ' + JSON.stringify(data));
      })
      .catch((error:number) => {
          console.log('promise, getAddressesFromLocation: error=' + JSON.stringify(error));
      });
  } catch (err) {
      console.error("errCode:" + (err as BusinessError.BusinessError).code + ",errMessage:" + (err as BusinessError.BusinessError).message);
  }

geoLocationManager.getAddressesFromLocationName

getAddressesFromLocationName(request: GeoCodeRequest, callback: AsyncCallback&lt;Array&lt;GeoAddress&gt;&gt;): void

Converts geographic description into coordinates through geocoding. This API uses an asynchronous callback to return the result.

System capability: SystemCapability.Location.Location.Geocoder

Parameters

Name Type Mandatory Description
request GeoCodeRequest Yes Geocoding request.
callback AsyncCallback&lt;Array&lt;GeoAddress&gt;&gt; Yes Callback used to receive the geocoding result.

Error codes

For details about the error codes, see Location Error Codes.

ID Error Message
3301000 Location service is unavailable.
3301400 Geocoding query failed.

Example

  import geoLocationManager from '@ohos.geoLocationManager';
  import BusinessError from "@ohos.base";
  let geocodeRequest:geoLocationManager.GeoCodeRequest = {"description": "No. xx, xx Road, Pudong District, Shanghai", "maxItems": 1};
  try {
      geoLocationManager.getAddressesFromLocationName(geocodeRequest, (err, data) => {
          if (err) {
              console.log('getAddressesFromLocationName: err=' + JSON.stringify(err));
          }
          if (data) {
              console.log('getAddressesFromLocationName: data=' + JSON.stringify(data));
          }
      });
  } catch (err) {
      console.error("errCode:" + (err as BusinessError.BusinessError).code + ",errMessage:" + (err as BusinessError.BusinessError).message);
  }

geoLocationManager.getAddressesFromLocationName

getAddressesFromLocationName(request: GeoCodeRequest): Promise&lt;Array&lt;GeoAddress&gt;&gt;

Converts geographic description into coordinates through geocoding. This API uses a promise to return the result.

System capability: SystemCapability.Location.Location.Geocoder

Parameters

Name Type Mandatory Description
request GeoCodeRequest Yes Geocoding request.

Return value

Name Type Mandatory Description
Promise&lt;Array&lt;GeoAddress&gt;&gt; Array&lt;GeoAddress&gt; NA Promise used to return the geocoding result.

Error codes

For details about the error codes, see Location Error Codes.

ID Error Message
3301000 Location service is unavailable.
3301400 Geocoding query failed.

Example

  import geoLocationManager from '@ohos.geoLocationManager';
  import BusinessError from "@ohos.base";
  let geocodeRequest:geoLocationManager.GeoCodeRequest = {"description": "No. xx, xx Road, Pudong District, Shanghai", "maxItems": 1};
  try {
      geoLocationManager.getAddressesFromLocationName(geocodeRequest).then((result) => {
          console.log('getAddressesFromLocationName: ' + JSON.stringify(result));
      })
      .catch((error:number) => {
          console.log('promise, getAddressesFromLocationName: error=' + JSON.stringify(error));
      });
  } catch (err) {
      console.error("errCode:" + (err as BusinessError.BusinessError).code + ",errMessage:" + (err as BusinessError.BusinessError).message);
  }

geoLocationManager.isGeocoderAvailable

isGeocoderAvailable(): boolean;

Obtains the (reverse) geocoding service status.

System capability: SystemCapability.Location.Location.Geocoder

Return value

Name Type Mandatory Description
boolean boolean NA Result indicating whether the (reverse) geocoding service is available.

Error codes

For details about the error codes, see Location Error Codes.

ID Error Message
3301000 Location service is unavailable.

Example

  import geoLocationManager from '@ohos.geoLocationManager';
  import BusinessError from "@ohos.base";
  try {
      let isAvailable = geoLocationManager.isGeocoderAvailable();
  } catch (err) {
      console.error("errCode:" + (err as BusinessError.BusinessError).code + ",errMessage:" + (err as BusinessError.BusinessError).message);
  }

geoLocationManager.getCachedGnssLocationsSize

getCachedGnssLocationsSize(callback: AsyncCallback&lt;number&gt;): void;

Obtains the number of cached GNSS locations. This API is supported only by certain GNSS chip models. If the required chip model is not available, error code 801 (Capability not supported) will be reported.

Permission required: ohos.permission.APPROXIMATELY_LOCATION

System capability: SystemCapability.Location.Location.Gnss

Parameters

Name Type Mandatory Description
callback AsyncCallback&lt;number&gt; Yes Callback used to receive the number of cached GNSS locations.

Error codes

For details about the error codes, see Location Error Codes.

ID Error Message
3301000 Location service is unavailable.
3301100 The location switch is off.

Example

  import geoLocationManager from '@ohos.geoLocationManager';
  import BusinessError from "@ohos.base";
  try {
      geoLocationManager.getCachedGnssLocationsSize((err, size) => {
          if (err) {
              console.log('getCachedGnssLocationsSize: err=' + JSON.stringify(err));
          }
          if (size) {
              console.log('getCachedGnssLocationsSize: size=' + JSON.stringify(size));
          }
      });
  } catch (err) {
      console.error("errCode:" + (err as BusinessError.BusinessError).code + ",errMessage:" + (err as BusinessError.BusinessError).message);
  }

geoLocationManager.getCachedGnssLocationsSize

getCachedGnssLocationsSize(): Promise&lt;number&gt;;

Obtains the number of cached GNSS locations. This API is supported only by certain GNSS chip models. If the required chip model is not available, error code 801 (Capability not supported) will be reported.

Permission required: ohos.permission.APPROXIMATELY_LOCATION

System capability: SystemCapability.Location.Location.Gnss

Return value

Name Type Mandatory Description
Promise&lt;number&gt; number NA Promise used to return the number of cached GNSS locations.

Error codes

For details about the error codes, see Location Error Codes.

ID Error Message
3301000 Location service is unavailable.
3301100 The location switch is off.

Example

  import geoLocationManager from '@ohos.geoLocationManager';
  import BusinessError from "@ohos.base";
  try {
      geoLocationManager.getCachedGnssLocationsSize().then((result) => {
          console.log('promise, getCachedGnssLocationsSize: ' + JSON.stringify(result));
      }) 
      .catch((error:number) => {
          console.log('promise, getCachedGnssLocationsSize: error=' + JSON.stringify(error));
      });
  } catch (err) {
      console.error("errCode:" + (err as BusinessError.BusinessError).code + ",errMessage:" + (err as BusinessError.BusinessError).message);
  }

geoLocationManager.flushCachedGnssLocations

flushCachedGnssLocations(callback: AsyncCallback&lt;void&gt;): void;

Obtains all cached GNSS locations and clears the GNSS cache queue. This API is supported only by certain GNSS chip models. If the required chip model is not available, error code 801 (Capability not supported) will be reported.

Permission required: ohos.permission.APPROXIMATELY_LOCATION

System capability: SystemCapability.Location.Location.Gnss

Parameters

Name Type Mandatory Description
callback AsyncCallback&lt;void&gt; Yes Callback used to receive the error message.

Error codes

For details about the error codes, see Location Error Codes.

ID Error Message
3301000 Location service is unavailable.
3301100 The location switch is off.
3301200 Failed to obtain the geographical location.

Example

  import geoLocationManager from '@ohos.geoLocationManager';
  import BusinessError from "@ohos.base";
  try {
      geoLocationManager.flushCachedGnssLocations((err, result) => {
          if (err) {
              console.log('flushCachedGnssLocations: err=' + JSON.stringify(err));
          }
      });
  } catch (err) {
      console.error("errCode:" + (err as BusinessError.BusinessError).code + ",errMessage:" + (err as BusinessError.BusinessError).message);
  }

geoLocationManager.flushCachedGnssLocations

flushCachedGnssLocations(): Promise&lt;void&gt;;

Obtains all cached GNSS locations and clears the GNSS cache queue. This API is supported only by certain GNSS chip models. If the required chip model is not available, error code 801 (Capability not supported) will be reported.

Permission required: ohos.permission.APPROXIMATELY_LOCATION

System capability: SystemCapability.Location.Location.Gnss

Return value

Name Type Mandatory Description
Promise&lt;void&gt; void NA Promise used to receive the error code.

Error codes

For details about the error codes, see Location Error Codes.

ID Error Message
3301000 Location service is unavailable.
3301100 The location switch is off.
3301200 Failed to obtain the geographical location.

Example

  import geoLocationManager from '@ohos.geoLocationManager';
  import BusinessError from "@ohos.base";
  try {
      geoLocationManager.flushCachedGnssLocations().then((result) => {
          console.log('promise, flushCachedGnssLocations success');
      })
      .catch((error:number) => {
          console.log('promise, flushCachedGnssLocations: error=' + JSON.stringify(error));
      });
  } catch (err) {
      console.error("errCode:" + (err as BusinessError.BusinessError).code + ",errMessage:" + (err as BusinessError.BusinessError).message);
  }

geoLocationManager.sendCommand

sendCommand(command: LocationCommand, callback: AsyncCallback&lt;void&gt;): void;

Sends an extended command to the location subsystem.

System capability: SystemCapability.Location.Location.Core

Parameters

Name Type Mandatory Description
command LocationCommand Yes Extended command (string) to be sent.
callback AsyncCallback&lt;void&gt; Yes Callback used to receive the error code.

Error codes

For details about the error codes, see Location Error Codes.

ID Error Message
3301000 Location service is unavailable.

Example

  import geoLocationManager from '@ohos.geoLocationManager';
  import BusinessError from "@ohos.base";
  let requestInfo:geoLocationManager.LocationCommand = {'scenario': 0x301, 'command': "command_1"};
  try {
      geoLocationManager.sendCommand(requestInfo, (err, result) => {
          if (err) {
              console.log('sendCommand: err=' + JSON.stringify(err));
          }
      });
  } catch (err) {
      console.error("errCode:" + (err as BusinessError.BusinessError).code + ",errMessage:" + (err as BusinessError.BusinessError).message);
  }

geoLocationManager.sendCommand

sendCommand(command: LocationCommand): Promise&lt;void&gt;;

Sends an extended command to the location subsystem.

System capability: SystemCapability.Location.Location.Core

Parameters

Name Type Mandatory Description
command LocationCommand Yes Extended command (string) to be sent.

Return value

Name Type Mandatory Description
Promise&lt;void&gt; void NA Promise used to receive the error code.

Error codes

For details about the error codes, see Location Error Codes.

ID Error Message
3301000 Location service is unavailable.

Example

  import geoLocationManager from '@ohos.geoLocationManager';
  import BusinessError from "@ohos.base";
  let requestInfo:geoLocationManager.LocationCommand = {'scenario': 0x301, 'command': "command_1"};
  try {
      geoLocationManager.sendCommand(requestInfo).then((result) => {
          console.log('promise, sendCommand success');
      })  
      .catch((error:number) => {
          console.log('promise, sendCommand: error=' + JSON.stringify(error));
      });
  } catch (err) {
      console.error("errCode:" + (err as BusinessError.BusinessError).code + ",errMessage:" + (err as BusinessError.BusinessError).message);
  }

geoLocationManager.getCountryCode

getCountryCode(callback: AsyncCallback&lt;CountryCode&gt;): void;

Obtains the current country code.

System capability: SystemCapability.Location.Location.Core

Parameters

Name Type Mandatory Description
callback AsyncCallback&lt;CountryCode&gt; Yes Callback used to receive the country code.

Error codes

For details about the error codes, see Location Error Codes.

ID Error Message
3301000 Location service is unavailable.
3301500 Failed to query the area information.

Example

  import geoLocationManager from '@ohos.geoLocationManager';
  import BusinessError from "@ohos.base";
  try {
      geoLocationManager.getCountryCode((err, result) => {
          if (err) {
              console.log('getCountryCode: err=' + JSON.stringify(err));
          }
          if (result) {
              console.log('getCountryCode: result=' + JSON.stringify(result));
          }
      });
  } catch (err) {
      console.error("errCode:" + (err as BusinessError.BusinessError).code + ",errMessage:" + (err as BusinessError.BusinessError).message);
  }

geoLocationManager.getCountryCode

getCountryCode(): Promise&lt;CountryCode&gt;;

Obtains the current country code.

System capability: SystemCapability.Location.Location.Core

Return value

Name Type Mandatory Description
Promise&lt;CountryCode&gt; CountryCode NA Promise used to receive the country code.

Error codes

For details about the error codes, see Location Error Codes.

ID Error Message
3301000 Location service is unavailable.
3301500 Failed to query the area information.

Example

  import geoLocationManager from '@ohos.geoLocationManager';
  import BusinessError from "@ohos.base";
  try {
      geoLocationManager.getCountryCode()
      .then((result) => {
          console.log('promise, getCountryCode: result=' + JSON.stringify(result));
      })
      .catch((error:number) => {
          console.log('promise, getCountryCode: error=' + JSON.stringify(error));
      });
  } catch (err) {
      console.error("errCode:" + (err as BusinessError.BusinessError).code + ",errMessage:" + (err as BusinessError.BusinessError).message);
  }

geoLocationManager.enableLocationMock

enableLocationMock(): void;

Enables the mock location function.

System capability: SystemCapability.Location.Location.Core

System API: This is a system API.

Error codes

For details about the error codes, see Location Error Codes.

ID Error Message
3301000 Location service is unavailable.
3301100 The location switch is off.

Example

  import geoLocationManager from '@ohos.geoLocationManager';
  import BusinessError from "@ohos.base";
  try {
      geoLocationManager.enableLocationMock();
  } catch (err) {
      console.error("errCode:" + (err as BusinessError.BusinessError).code + ",errMessage:" + (err as BusinessError.BusinessError).message);
  }

geoLocationManager.disableLocationMock

disableLocationMock(): void;

Disables the mock location function.

System capability: SystemCapability.Location.Location.Core

System API: This is a system API.

Error codes

For details about the error codes, see Location Error Codes.

ID Error Message
3301000 Location service is unavailable.
3301100 The location switch is off.

Example

  import geoLocationManager from '@ohos.geoLocationManager';
  import BusinessError from "@ohos.base";
  try {
      geoLocationManager.disableLocationMock();
  } catch (err) {
      console.error("errCode:" + (err as BusinessError.BusinessError).code + ",errMessage:" + (err as BusinessError.BusinessError).message);
  }

geoLocationManager.setMockedLocations

setMockedLocations(config: LocationMockConfig): void;

Sets the mock location information. The mock locations will be reported at the interval specified in this API.

This API can be invoked only after geoLocationManager.enableLocationMock is called.

System capability: SystemCapability.Location.Location.Core

System API: This is a system API.

Parameters

Name Type Mandatory Description
config LocationMockConfig Yes Mock location information, including the interval for reporting the mock locations and the array of the mock locations.

Error codes

For details about the error codes, see Location Error Codes.

ID Error Message
3301000 Location service is unavailable.
3301100 The location switch is off.

Example

  import geoLocationManager from '@ohos.geoLocationManager';
  import BusinessError from "@ohos.base";
  let locations:Array<geoLocationManager.Location> = [
      {"latitude": 30.12, "longitude": 120.11, "altitude": 123, "accuracy": 1, "speed": 5.2, "timeStamp": 16594326109, "direction": 123.11, "timeSinceBoot": 1000000000, "additionSize": 0, "isFromMock": true},
      {"latitude": 31.13, "longitude": 121.11, "altitude": 123, "accuracy": 2, "speed": 5.2, "timeStamp": 16594326109, "direction": 123.11, "timeSinceBoot": 2000000000, "additionSize": 0, "isFromMock": true},
      {"latitude": 32.14, "longitude": 122.11, "altitude": 123, "accuracy": 3, "speed": 5.2, "timeStamp": 16594326109, "direction": 123.11, "timeSinceBoot": 3000000000, "additionSize": 0, "isFromMock": true},
      {"latitude": 33.15, "longitude": 123.11, "altitude": 123, "accuracy": 4, "speed": 5.2, "timeStamp": 16594326109, "direction": 123.11, "timeSinceBoot": 4000000000, "additionSize": 0, "isFromMock": true},
      {"latitude": 34.16, "longitude": 124.11, "altitude": 123, "accuracy": 5, "speed": 5.2, "timeStamp": 16594326109, "direction": 123.11, "timeSinceBoot": 5000000000, "additionSize": 0, "isFromMock": true}
  ];
  let config:geoLocationManager.LocationMockConfig = {"timeInterval": 5, "locations": locations};
  try {
      geoLocationManager.enableLocationMock();
      geoLocationManager.setMockedLocations(config);
  } catch (err) {
      console.error("errCode:" + (err as BusinessError.BusinessError).code + ",errMessage:" + (err as BusinessError.BusinessError).message);
  }

geoLocationManager.enableReverseGeocodingMock

enableReverseGeocodingMock(): void;

Enables the mock reverse geocoding function.

System capability: SystemCapability.Location.Location.Core

System API: This is a system API.

Error codes

For details about the error codes, see Location Error Codes.

ID Error Message
3301000 Location service is unavailable.

Example

  import geoLocationManager from '@ohos.geoLocationManager';
  import BusinessError from "@ohos.base";
  try {
      geoLocationManager.enableReverseGeocodingMock();
  } catch (err) {
      console.error("errCode:" + (err as BusinessError.BusinessError).code + ",errMessage:" + (err as BusinessError.BusinessError).message);
  }

geoLocationManager.disableReverseGeocodingMock

disableReverseGeocodingMock(): void;

Disables the mock geocoding function.

System capability: SystemCapability.Location.Location.Core

System API: This is a system API.

Error codes

For details about the error codes, see Location Error Codes.

ID Error Message
3301000 Location service is unavailable.

Example

  import geoLocationManager from '@ohos.geoLocationManager';
  import BusinessError from "@ohos.base";
  try {
      geoLocationManager.disableReverseGeocodingMock();
  } catch (err) {
      console.error("errCode:" + (err as BusinessError.BusinessError).code + ",errMessage:" + (err as BusinessError.BusinessError).message);
  }

geoLocationManager.setReverseGeocodingMockInfo

setReverseGeocodingMockInfo(mockInfos: Array&lt;ReverseGeocodingMockInfo&gt;): void;

Sets information of the mock reverse geocoding function, including the mapping between a location and geographical name. If the location is contained in the configurations during reverse geocoding query, the corresponding geographical name will be returned.

This API can be invoked only after geoLocationManager.enableReverseGeocodingMock is called.

System capability: SystemCapability.Location.Location.Core

System API: This is a system API.

Parameters

Name Type Mandatory Description
mockInfos Array&lt;ReverseGeocodingMockInfo&gt; Yes Array of information of the mock reverse geocoding function, including a location and a geographical name.

Error codes

For details about the error codes, see Location Error Codes.

ID Error Message
3301000 Location service is unavailable.

Example

  import geoLocationManager from '@ohos.geoLocationManager';
  import BusinessError from "@ohos.base";
  let mockInfos:Array<geoLocationManager.ReverseGeocodingMockInfo> = [
      {"location": {"locale": "zh", "latitude": 30.12, "longitude": 120.11, "maxItems": 1}, "geoAddress": {"locale": "zh", "latitude": 30.12, "longitude": 120.11, "isFromMock": true}},
      {"location": {"locale": "zh", "latitude": 31.12, "longitude": 121.11, "maxItems": 1}, "geoAddress": {"locale": "zh", "latitude": 31.12, "longitude": 121.11, "isFromMock": true}},
      {"location": {"locale": "zh", "latitude": 32.12, "longitude": 122.11, "maxItems": 1}, "geoAddress": {"locale": "zh", "latitude": 32.12, "longitude": 122.11, "isFromMock": true}},
      {"location": {"locale": "zh", "latitude": 33.12, "longitude": 123.11, "maxItems": 1}, "geoAddress": {"locale": "zh", "latitude": 33.12, "longitude": 123.11, "isFromMock": true}},
      {"location": {"locale": "zh", "latitude": 34.12, "longitude": 124.11, "maxItems": 1}, "geoAddress": {"locale": "zh", "latitude": 34.12, "longitude": 124.11, "isFromMock": true}},
  ];
  try {
      geoLocationManager.enableReverseGeocodingMock();
      geoLocationManager.setReverseGeocodingMockInfo(mockInfos);
  } catch (err) {
      console.error("errCode:" + (err as BusinessError.BusinessError).code + ",errMessage:" + (err as BusinessError.BusinessError).message);
  }

geoLocationManager.isLocationPrivacyConfirmed

isLocationPrivacyConfirmed(type: LocationPrivacyType): boolean;

Checks whether a user agrees with the privacy statement of the location service. This API can only be called by system applications.

System API: This is a system API.

System capability: SystemCapability.Location.Location.Core

Parameters

Name Type Mandatory Description
type LocationPrivacyType Yes Privacy statement type, for example, privacy statement displayed in the startup wizard or privacy statement displayed when the location service is enabled.

Return value

Name Type Mandatory Description
boolean boolean NA Whether the user agrees with the privacy statement.

Error codes

For details about the error codes, see Location Error Codes.

ID Error Message
3301000 Location service is unavailable.

Example

  import geoLocationManager from '@ohos.geoLocationManager';
  import BusinessError from "@ohos.base";
  try {
      let isConfirmed = geoLocationManager.isLocationPrivacyConfirmed(1);
  } catch (err) {
      console.error("errCode:" + (err as BusinessError.BusinessError).code + ",errMessage:" + (err as BusinessError.BusinessError).message);
  }

geoLocationManager.setLocationPrivacyConfirmStatus

setLocationPrivacyConfirmStatus(type: LocationPrivacyType, isConfirmed: boolean): void;

Sets the user confirmation status for the privacy statement of the location service. This API can only be called by system applications.

System API: This is a system API.

Required permissions: ohos.permission.MANAGE_SECURE_SETTINGS

System capability: SystemCapability.Location.Location.Core

Parameters

Name Type Mandatory Description
type LocationPrivacyType Yes Privacy statement type, for example, privacy statement displayed in the startup wizard or privacy statement displayed when the location service is enabled.
isConfirmed boolean Yes Whether the user agrees with the privacy statement.

Error codes

For details about the error codes, see Location Error Codes.

ID Error Message
3301000 Location service is unavailable.

Example

  import geoLocationManager from '@ohos.geoLocationManager';
  import BusinessError from "@ohos.base";
  try {
      geoLocationManager.setLocationPrivacyConfirmStatus(1, true);
  } catch (err) {
      console.error("errCode:" + (err as BusinessError.BusinessError).code + ",errMessage:" + (err as BusinessError.BusinessError).message);
  }

geoLocationManager.getLocatingRequiredData10+

getLocatingRequiredData(config: LocatingRequiredDataConfig): Promise&lt;Array&lt;LocatingRequiredData&gt;&gt;;

Obtains the required data of the location service. This API uses a promise to return the result.

Required permissions: ohos.permission.LOCATION and ohos.permission.APPROXIMATELY_LOCATION

System capability: SystemCapability.Location.Location.Core

System API: This is a system API.

Parameters

Name Type Mandatory Description
config LocatingRequiredDataConfig Yes Configuration for obtaining the required data of the location service.

Return value

Name Type Mandatory Description
Promise&lt;Array&lt;LocatingRequiredData&gt;&gt; LocatingRequiredData NA Promise used to receive the required data of the location service, such as the Wi-Fi and Bluetooth scanning information.

Error codes

For details about the error codes, see Location Error Codes.

ID Error Message
3301800 Failed to start WiFi or Bluetooth scanning.

Example

  import geoLocationManager from '@ohos.geoLocationManager';
  import BusinessError from "@ohos.base";
  let config:geoLocationManager.LocatingRequiredDataConfig = {'type': 1, 'needStartScan': true, 'scanInterval': 10000};
  try {
      geoLocationManager.getLocatingRequiredData(config).then((result) => {
          console.log('getLocatingRequiredData return: ' + JSON.stringify(result));
      })  
      .catch((error:number) => {
          console.log('promise, getLocatingRequiredData: error=' + JSON.stringify(error));
      });
  } catch (err) {
      console.error("errCode:" + (err as BusinessError.BusinessError).code + ",errMessage:" + (err as BusinessError.BusinessError).message);
  }

你可能感兴趣的鸿蒙文章

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)

0  赞