harmony 鸿蒙Location Subsystem ChangeLog

  • 2023-02-17
  • 浏览 (505)

Location Subsystem ChangeLog

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

APIs in @ohos.geolocation.d.ts do not support throwing error codes. To support this function, all APIs in @ohos.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 Impacts

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 method function on(type: ‘locationChange’, request: LocationRequest, callback: Callback): void; Migrated to @ohos.geoLocationManager.d.ts.
geolocation method function off(type: ‘locationChange’, callback?: Callback): void; Migrated to @ohos.geoLocationManager.d.ts.
geolocation method function on(type: ‘locationServiceState’, callback: Callback): void; Migrated to @ohos.geoLocationManager.d.ts and changed type: ‘locationServiceState’ to type: ‘locationEnabledChange’.
geolocation method function off(type: ‘locationServiceState’, callback?: Callback): void; Migrated to @ohos.geoLocationManager.d.ts and changed type: ‘locationServiceState’ to type: ‘locationEnabledChange’.
geolocation method function on(type: ‘cachedGnssLocationsReporting’, request: CachedGnssLocationsRequest, callback: Callback>): void; Migrated to @ohos.geoLocationManager.d.ts and changed type: ‘cachedGnssLocationsReporting’ to type: ‘cachedGnssLocationsChange’.
geolocation method function off(type: ‘cachedGnssLocationsReporting’, callback?: Callback>): void; Migrated to @ohos.geoLocationManager.d.ts and changed type: ‘cachedGnssLocationsReporting’ to type: ‘cachedGnssLocationsChange’.
geolocation method function on(type: ‘gnssStatusChange’, callback: Callback): void; Migrated to @ohos.geoLocationManager.d.ts and changed type: ‘gnssStatusChange’ to type: ‘satelliteStatusChange’.
geolocation method function off(type: ‘gnssStatusChange’, callback?: Callback): void; Migrated to @ohos.geoLocationManager.d.ts and changed type: ‘gnssStatusChange’ to type: ‘satelliteStatusChange’.
geolocation method function on(type: ‘nmeaMessageChange’, callback: Callback): void; Migrated to @ohos.geoLocationManager.d.ts and changed type: ‘nmeaMessageChange’ to type: ‘nmeaMessage’.
geolocation method function off(type: ‘nmeaMessageChange’, callback?: Callback): void; Migrated to @ohos.geoLocationManager.d.ts and changed type: ‘nmeaMessageChange’ to type: ‘nmeaMessage’.
geolocation method function on(type: ‘fenceStatusChange’, request: GeofenceRequest, want: WantAgent): void; Migrated to @ohos.geoLocationManager.d.ts and changed type: ‘fenceStatusChange’ to type: ‘gnssFenceStatusChange’.
geolocation method function off(type: ‘fenceStatusChange’, request: GeofenceRequest, want: WantAgent): void; Migrated to @ohos.geoLocationManager.d.ts and changed type: ‘fenceStatusChange’ to type: ‘gnssFenceStatusChange’.
geolocation method function getCurrentLocation(request: CurrentLocationRequest, callback: AsyncCallback): void; Migrated to @ohos.geoLocationManager.d.ts.
geolocation method function getCurrentLocation(callback: AsyncCallback): void; Migrated to @ohos.geoLocationManager.d.ts.
geolocation method function getCurrentLocation(request?: CurrentLocationRequest): Promise; Migrated to @ohos.geoLocationManager.d.ts.
geolocation method function getLastLocation(callback: AsyncCallback): void; Migrated to @ohos.geoLocationManager.d.ts and changed to function getLastLocation(): Location.
geolocation method function getLastLocation(): Promise; Migrated to @ohos.geoLocationManager.d.ts and changed to function getLastLocation(): Location.
geolocation method function isLocationEnabled(callback: AsyncCallback): void; Migrated to @ohos.geoLocationManager.d.ts and changed to function isLocationEnabled(): boolean.
geolocation method function isLocationEnabled(): Promise; Migrated to @ohos.geoLocationManager.d.ts and changed to function isLocationEnabled(): boolean.
geolocation method function requestEnableLocation(callback: AsyncCallback): void; Deleted.
geolocation method function requestEnableLocation(): Promise; Deleted.
geolocation method function enableLocation(callback: AsyncCallback): void; Migrated to @ohos.geoLocationManager.d.ts.
geolocation method function enableLocation(): Promise; Migrated to @ohos.geoLocationManager.d.ts.
geolocation method function disableLocation(callback: AsyncCallback): void; Migrated to @ohos.geoLocationManager.d.ts and changed to function disableLocation(): void.
geolocation method function disableLocation(): Promise; Migrated to @ohos.geoLocationManager.d.ts and changed to function disableLocation(): void.
geolocation method function getAddressesFromLocation(request: ReverseGeoCodeRequest, callback: AsyncCallback>): void; Migrated to @ohos.geoLocationManager.d.ts.
geolocation method function getAddressesFromLocation(request: ReverseGeoCodeRequest): Promise>; Migrated to @ohos.geoLocationManager.d.ts.
geolocation method function getAddressesFromLocationName(request: GeoCodeRequest, callback: AsyncCallback>): void; Migrated to @ohos.geoLocationManager.d.ts.
geolocation method function getAddressesFromLocationName(request: GeoCodeRequest): Promise>; Migrated to @ohos.geoLocationManager.d.ts.
geolocation method function isGeoServiceAvailable(callback: AsyncCallback): void; Migrated to @ohos.geoLocationManager.d.ts and changed to function isGeocoderAvailable(): boolean.
geolocation method function isGeoServiceAvailable(): Promise; Migrated to @ohos.geoLocationManager.d.ts and changed to function isGeocoderAvailable(): boolean.
geolocation method function getCachedGnssLocationsSize(callback: AsyncCallback): void; Migrated to @ohos.geoLocationManager.d.ts.
geolocation method function getCachedGnssLocationsSize(): Promise; Migrated to @ohos.geoLocationManager.d.ts.
geolocation method function flushCachedGnssLocations(callback: AsyncCallback): void; Migrated to @ohos.geoLocationManager.d.ts.
geolocation method function flushCachedGnssLocations(): Promise; Migrated to @ohos.geoLocationManager.d.ts.
geolocation method function sendCommand(command: LocationCommand, callback: AsyncCallback): void; Migrated to @ohos.geoLocationManager.d.ts.
geolocation method function sendCommand(command: LocationCommand): Promise; Migrated to @ohos.geoLocationManager.d.ts.
geolocation method function enableLocationMock(callback: AsyncCallback): void; Migrated to @ohos.geoLocationManager.d.ts and changed to function enableLocationMock(): void.
geolocation method function enableLocationMock(): Promise; Migrated to @ohos.geoLocationManager.d.ts and changed to function enableLocationMock(): void.
geolocation method function disableLocationMock(callback: AsyncCallback): void; Migrated to @ohos.geoLocationManager.d.ts and changed to function disableLocationMock(): void.
geolocation method function disableLocationMock(): Promise; Migrated to @ohos.geoLocationManager.d.ts and changed to function disableLocationMock(): void.
geolocation method function setMockedLocations(config: LocationMockConfig, callback: AsyncCallback): void; Migrated to @ohos.geoLocationManager.d.ts and changed to function setMockedLocations(config: LocationMockConfig): void.
geolocation method function setMockedLocations(config: LocationMockConfig): Promise; Migrated to @ohos.geoLocationManager.d.ts and changed to function setMockedLocations(config: LocationMockConfig): void.
geolocation method function enableReverseGeocodingMock(callback: AsyncCallback): void; Migrated to @ohos.geoLocationManager.d.ts and changed to function enableReverseGeocodingMock(): void.
geolocation method function enableReverseGeocodingMock(): Promise; Migrated to @ohos.geoLocationManager.d.ts and changed to function enableReverseGeocodingMock(): void.
geolocation method function disableReverseGeocodingMock(callback: AsyncCallback): void; Migrated to @ohos.geoLocationManager.d.ts and changed to function disableReverseGeocodingMock(): void.
geolocation method function disableReverseGeocodingMock(): Promise; Migrated to @ohos.geoLocationManager.d.ts and changed to function disableReverseGeocodingMock(): void.
geolocation method function setReverseGeocodingMockInfo(mockInfos: Array, callback: AsyncCallback): void; Migrated to @ohos.geoLocationManager.d.ts and changed to function setReverseGeocodingMockInfo(mockInfos: Array): void.
geolocation method function setReverseGeocodingMockInfo(mockInfos: Array): Promise; Migrated to @ohos.geoLocationManager.d.ts and changed to function setReverseGeocodingMockInfo(mockInfos: Array): void.
geolocation method function isLocationPrivacyConfirmed(type: LocationPrivacyType, callback: AsyncCallback): void; Migrated to @ohos.geoLocationManager.d.ts and changed to function isLocationPrivacyConfirmed(type: LocationPrivacyType): boolean.
geolocation method function isLocationPrivacyConfirmed(type: LocationPrivacyType,): Promise; Migrated to @ohos.geoLocationManager.d.ts and changed to function isLocationPrivacyConfirmed(type: LocationPrivacyType): boolean.
geolocation method function setLocationPrivacyConfirmStatus(type: LocationPrivacyType, isConfirmed: boolean, callback: AsyncCallback): void; Migrated to @ohos.geoLocationManager.d.ts and changed to function setLocationPrivacyConfirmStatus(type: LocationPrivacyType, isConfirmed: boolean): void.
geolocation method function setLocationPrivacyConfirmStatus(type: LocationPrivacyType, isConfirmed: boolean): Promise; Migrated to @ohos.geoLocationManager.d.ts and changed to function setLocationPrivacyConfirmStatus(type: LocationPrivacyType, isConfirmed: boolean): void.
geolocation interface SatelliteStatusInfo Migrated to @ohos.geoLocationManager.d.ts.
geolocation interface CachedGnssLocationsRequest Migrated to @ohos.geoLocationManager.d.ts.
geolocation interface GeofenceRequest Migrated to @ohos.geoLocationManager.d.ts.
geolocation interface Geofence Migrated to @ohos.geoLocationManager.d.ts.
geolocation interface ReverseGeoCodeRequest Migrated to @ohos.geoLocationManager.d.ts.
geolocation interface GeoCodeRequest Migrated to @ohos.geoLocationManager.d.ts.
geolocation interface GeoAddress Migrated to @ohos.geoLocationManager.d.ts.
geolocation interface LocationRequest Migrated to @ohos.geoLocationManager.d.ts.
geolocation interface CurrentLocationRequest Migrated to @ohos.geoLocationManager.d.ts.
geolocation interface Location Migrated to @ohos.geoLocationManager.d.ts.
geolocation enum LocationRequestPriority Migrated to @ohos.geoLocationManager.d.ts.
geolocation enum LocationRequestScenario Migrated to @ohos.geoLocationManager.d.ts.
geolocation enum GeoLocationErrorCode Deprecated.
geolocation enum LocationPrivacyType Migrated to @ohos.geoLocationManager.d.ts.
geolocation enum LocationCommand Migrated to @ohos.geoLocationManager.d.ts.

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

你可能感兴趣的鸿蒙文章

harmony 鸿蒙Resource Scheduler Subsystem ChangeLog

harmony 鸿蒙ArkUI Subsystem ChangeLog

harmony 鸿蒙Bundle Manager Subsystem ChangeLog

harmony 鸿蒙File Management Subsystem Changelog

harmony 鸿蒙Input Method Framework ChangeLog

harmony 鸿蒙Location Subsystem ChangeLog

harmony 鸿蒙Location Subsystem ChangeLog

harmony 鸿蒙User IAM Subsystem ChangeLog

harmony 鸿蒙Window Subsystem ChangeLog

0  赞