harmony 鸿蒙Location Subsystem Changelog

2023-06-24
浏览 (357)

Location Subsystem Changelog

cl.location.1 API Migration from @system.geolocation.d.ts to @ohos.geoLocationManager.d.ts

APIs in @system.geolocation.d.ts do not support throwing error codes. To support this function, all APIs in @system.geolocation.d.ts are migrated to the newly added @ohos.geoLocationManager.d.ts file, and corresponding error code description is added.

To use APIs of the location subsystem, you need to import @ohos.geoLocationManager.

import geoLocationManager from ‘@ohos.geoLocationManager’;

Change Impact

All APIs of the location subsystem are affected. To ensure normal use of these APIs, you need to import @ohos.geoLocationManager.

import geoLocationManager from ‘@ohos.geoLocationManager’;

Key API/Component Changes

|Class|API Type|Declaration|Change Type| | –|–|–|–| |Geolocation|class|Geolocation|Migrated to @ohos.geoLocationManager.d.ts and replaced by ohos.geoLocationManager/geoLocationManager.| |Geolocation|interface|static getLocation(options?: GetLocationOption): void;|Migrated to @ohos.geoLocationManager.d.ts and replaced by ohos.geoLocationManager/geoLocationManager.getCurrentLocation.| |Geolocation|interface|static getLocationType(options?: GetLocationTypeOption): void;|Deprecated.| |Geolocation|interface|static subscribe(options: SubscribeLocationOption): void;| Migrated to @ohos.geoLocationManager.d.ts and replaced by ohos.geoLocationManager/geoLocationManager.on#event:locationChange.| |Geolocation|interface|static unsubscribe(): void;| Migrated to @ohos.geoLocationManager.d.ts and replaced by ohos.geoLocationManager/geoLocationManager.off#event:locationChange.| |Geolocation|interface|static getSupportedCoordTypes(): Array;| Deprecated.| ||interface|GeolocationResponse|Migrated to @ohos.geoLocationManager.d.ts and replaced by ohos.geoLocationManager/geoLocationManager.Location.| ||interface|GetLocationOption|Migrated to @ohos.geoLocationManager.d.ts and replaced by ohos.geoLocationManager/geoLocationManager.CurrentLocationRequest.| ||interface|GetLocationTypeResponse|Deprecated.| ||interface|GetLocationTypeOption|Deprecated.| ||interface|SubscribeLocationOption|Migrated to @ohos.geoLocationManager.d.ts and replaced by ohos.geoLocationManager/geoLocationManager.LocationRequest.|

(Optional) Adaptation Guide

The following sample code shows how to call enableLocation in the new version:

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