• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# 位置服务子系统ChangeLog
2
3## cl.location.1 @system.geolocation.d.ts接口迁移到新增的@ohos.geoLocationManager.d.ts
4
5@system.geolocation.d.ts接口不支持抛出错误码，为了支持错误码功能，把@system.geolocation.d.ts中所有接口，迁移到新增的@ohos.geoLocationManager.d.ts中，并增加错误码描述。
6
7后续需要import @ohos.geoLocationManager才能使用位置服务的接口：
8
9import geoLocationManager from '@ohos.geoLocationManager';
10
11
12**变更影响**
13
14对位置服务所有接口的使用有影响，需要import @ohos.geoLocationManager才能使用位置服务接口：
15
16import geoLocationManager from '@ohos.geoLocationManager';
17
18**关键的接口/组件变更**
19
20| 类名 | 接口类型 | 接口声明 | 变更类型 |
21|  -- | -- | -- | -- |
22|Geolocation| class | Geolocation | 接口迁移到@ohos.geoLocationManager.d.ts，使用ohos.geoLocationManager/geoLocationManager代替 |
23|Geolocation| interface | static getLocation(options?: GetLocationOption): void; | 接口迁移到@ohos.geoLocationManager.d.ts，使用ohos.geoLocationManager/geoLocationManager.getCurrentLocation代替 |
24|Geolocation| interface | static getLocationType(options?: GetLocationTypeOption): void; | 接口废弃 |
25|Geolocation| interface | static subscribe(options: SubscribeLocationOption): void; |  接口迁移到@ohos.geoLocationManager.d.ts，使用ohos.geoLocationManager/geoLocationManager.on#event:locationChange代替 |
26|Geolocation| interface | static unsubscribe(): void; |  接口迁移到@ohos.geoLocationManager.d.ts，使用ohos.geoLocationManager/geoLocationManager.off#event:locationChange代替 |
27|Geolocation| interface | static getSupportedCoordTypes(): Array<string>; |  接口废弃 |
28|| interface | GeolocationResponse| 迁移到@ohos.geoLocationManager.d.ts，使用ohos.geoLocationManager/geoLocationManager.Location代替 |
29|| interface | GetLocationOption | 接口迁移到@ohos.geoLocationManager.d.ts，使用ohos.geoLocationManager/geoLocationManager.CurrentLocationRequest代替 |
30|| interface | GetLocationTypeResponse | 接口废弃 |
31|| interface | GetLocationTypeOption | 接口废弃 |
32|| interface | SubscribeLocationOption | 接口迁移到@ohos.geoLocationManager.d.ts，使用ohos.geoLocationManager/geoLocationManager.LocationRequest代替 |
33
34
35**适配指导（可选，不涉及则可以删除）**
36
37以enableLocation为例，在新版本上需要使用如下方式进行调用：
38
39  ```ts
40  import geoLocationManager from '@ohos.geoLocationManager';
41  try {
42      geoLocationManager.enableLocation((err, data) => {
43          if (err) {
44              console.log('enableLocation: err=' + JSON.stringify(err));
45          }
46      });
47  } catch (err) {
48      console.error("errCode:" + err.code + ",errMessage:" + err.message);
49  }
50  ```