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 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|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 鸿蒙Readme

harmony 鸿蒙Example Subsystem Changelog

harmony 鸿蒙Ability Framework Changelog

harmony 鸿蒙Account Subsystem Changelog

harmony 鸿蒙ArkUI Subsystem ChangeLog

harmony 鸿蒙Multimedia Subsystem Changelog

harmony 鸿蒙Common Library Subsystem Changelog

harmony 鸿蒙Distributed Data Management Subsystem JS API Changelog

harmony 鸿蒙File Management Subsystem Changelog

harmony 鸿蒙Input Method Framework ChangeLog