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