Skip to content

D
Docs

OpenHarmony / Docs
大约 1 年 前同步成功

通知 159
Star 292
Fork 28
D
Docs
切换分支/标签
查找文件 普通视图历史永久链接Permalink
changelogs-geolocation.md 9.0 KB
Newer Older
L
add change log  
liu-binjun 已提交
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 
# 位置服务子系统ChangeLog

## cl.location.1 系统API和API9接口迁移到新增的@ohos.geoLocationManager.d.ts

@ohos.geolocation.d.ts接口不支持抛出错误码，而API9和systemApi都需要支持抛出错误码，为了支持该功能，把@ohos.geolocation.d.ts中systemApi和API9所有接口，迁移到新增的@ohos.geoLocationManager.d.ts中，并增加错误码描述。

后续需要import @ohos.geoLocationManager才能使用位置服务的系统API和API9接口：

import geoLocationManager from '@ohos.geoLocationManager';


**变更影响**

仅对系统API和API9所有接口的使用有影响，需要import @ohos.geoLocationManager才能使用位置服务的系统API和API9接口：

import geoLocationManager from '@ohos.geoLocationManager';

对于其他接口无影响。

**关键的接口/组件变更**

| 类名 | 接口类型 | 接口声明 | 变更类型 | 
|  -- | -- | -- | -- |
|geolocation| namespace | declare namespacegeolocation| API9接口变更，迁移到@ohos.geoLocationManager.d.ts | 
|geolocation | interface | export interface ReverseGeocodingMockInfo  | API9接口变更，迁移到@ohos.geoLocationManager.d.ts | 
|geolocation | interface | export interface LocationMockConfig  | API9接口变更，迁移到@ohos.geoLocationManager.d.ts | 
|geolocation | interface | export interface CountryCode   | API9接口变更，迁移到@ohos.geoLocationManager.d.ts | 
|geolocation | enum | export enum CountryCodeType   | API9接口变更，迁移到@ohos.geoLocationManager.d.ts | 
|geolocation.GeoAddress | field | isFromMock?: Boolean; | API9接口变更，迁移到@ohos.geoLocationManager.d.ts | 
|geolocation.Location  | field | isFromMock?: Boolean; | API9接口变更，迁移到@ohos.geoLocationManager.d.ts | 
|geolocation.GeoLocationErrorCode  | field | NOT_SUPPORTED = 100 | API9接口变更，迁移到@ohos.geoLocationManager.d.ts | 
|geolocation.GeoLocationErrorCode  | field | QUERY_COUNTRY_CODE_ERROR | API9接口变更，迁移到@ohos.geoLocationManager.d.ts | 
|geolocation| method | function on(type: 'countryCodeChange', callback: Callback<CountryCode>): void; | API9接口变更，迁移到@ohos.geoLocationManager.d.ts | 
|geolocation| method | function off(type: 'countryCodeChange', callback?: Callback<CountryCode>): void; | API9接口变更，迁移到@ohos.geoLocationManager.d.ts | 
|geolocation| method | function getCountryCode(callback: AsyncCallback<CountryCode>): void; | API9接口变更，迁移到@ohos.geoLocationManager.d.ts | 
|geolocation| method | function getCountryCode(): Promise<CountryCode>; | API9接口变更，迁移到@ohos.geoLocationManager.d.ts | 
|geolocation| method | function enableLocationMock(scenario: LocationRequestScenario, callback: AsyncCallback<void>): void; | API9接口变更，该接口删除。 | 
|geolocation| method | function enableLocationMock(callback: AsyncCallback<void>): void; | API9接口变更，迁移到@ohos.geoLocationManager.d.ts | 
|geolocation| method | function enableLocationMock(scenario: LocationRequestScenario): Promise<void>; | API9接口变更，该接口删除。 | 
|geolocation| method | function enableLocationMock(): Promise<void>; |  API9接口变更，迁移到@ohos.geoLocationManager.d.ts | 
|geolocation| method | function disableLocationMock(scenario: LocationRequestScenario, callback: AsyncCallback<void>): void; | API9接口变更，该接口删除。 | 
|geolocation| method | function disableLocationMock(callback: AsyncCallback<void>): void; | API9接口变更，迁移到@ohos.geoLocationManager.d.ts  | 
|geolocation| method | function disableLocationMock(scenario: LocationRequestScenario): Promise<void>; | API9接口变更，该接口删除。 | 
|geolocation| method | function disableLocationMock(): Promise<void>; | API9接口变更，迁移到@ohos.geoLocationManager.d.ts  | 
|geolocation| method | function setMockedLocations(config: LocationMockConfig, callback: AsyncCallback<void>): void; | API9接口变更，迁移到@ohos.geoLocationManager.d.ts  | 
|geolocation| method | function setMockedLocations(config: LocationMockConfig): Promise<void>; | API9接口变更，迁移到@ohos.geoLocationManager.d.ts  | 
|geolocation| method | function enableReverseGeocodingMock(callback: AsyncCallback<void>): void; | API9接口变更，迁移到@ohos.geoLocationManager.d.ts  | 
|geolocation| method | function enableReverseGeocodingMock(): Promise<void>; | API9接口变更，迁移到@ohos.geoLocationManager.d.ts  | 
|geolocation| method | function disableReverseGeocodingMock(callback: AsyncCallback<void>): void; | API9接口变更，迁移到@ohos.geoLocationManager.d.ts  | 
|geolocation| method | function disableReverseGeocodingMock(): Promise<void>; | API9接口变更，迁移到@ohos.geoLocationManager.d.ts  |
|geolocation| method | function setReverseGeocodingMockInfo(mockInfos: Array<ReverseGeocodingMockInfo>, callback: AsyncCallback<void>): void; | API9接口变更，迁移到@ohos.geoLocationManager.d.ts  |
|geolocation| method | function setReverseGeocodingMockInfo(mockInfos: Array<ReverseGeocodingMockInfo>): Promise<void>; | API9接口变更，迁移到@ohos.geoLocationManager.d.ts  |
|geolocation| method | function isLocationPrivacyConfirmed(type: LocationPrivacyType, callback: AsyncCallback<boolean>): void; | API9接口变更，迁移到@ohos.geoLocationManager.d.ts  |
|geolocation| method | function isLocationPrivacyConfirmed(type: LocationPrivacyType): Promise<boolean>; | API9接口变更，迁移到@ohos.geoLocationManager.d.ts  |
|geolocation| method | function setLocationPrivacyConfirmStatus(type: LocationPrivacyType, isConfirmed: boolean, callback: AsyncCallback<boolean>): void; | API9接口变更，迁移到@ohos.geoLocationManager.d.ts，callback返回值改为void。  |
|geolocation| method | function setLocationPrivacyConfirmStatus(type: LocationPrivacyType, isConfirmed: boolean): Promise<boolean>; | API9接口变更，迁移到@ohos.geoLocationManager.d.ts，promise返回值改为void。  |

**适配指导（可选，不涉及则可以删除）**

以enableLocation为例，在新版本上需要使用如下方式进行调用：

  ```ts
  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);
  }
L
bugfix:Modify the problem of wrong format  
liu-binjun 已提交
73 
  ```
L
add change log  
liu-binjun 已提交
74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 

## cl.location.2 位置服务权限变更

从API9开始，增加ohos.permission.APPROXIMATELY_LOCATION，表示模糊位置权限。

如果应用开发者使用的API版本大于等于9，则需要同时申请ohos.permission.LOCATION和ohos.permission.APPROXIMATELY_LOCATION，单独申请ohos.permission.LOCATION会失败。

**变更影响**

如果是存量应用（使用的API版本小于9），则无影响。如果使用的API版本大于等于9，位置服务权限申请方式有变更，详情如下：

应用在使用系统能力前，需要检查是否已经获取用户授权访问设备位置信息。如未获得授权，可以向用户申请需要的位置权限，申请方式请参考下文。

系统提供的定位权限有：

- ohos.permission.LOCATION

- ohos.permission.APPROXIMATELY_LOCATION

- ohos.permission.LOCATION_IN_BACKGROUND

访问设备的位置信息，必须申请权限，并且获得用户授权。

API9之前的版本，申请ohos.permission.LOCATION即可。

API9及之后的版本，需要申请ohos.permission.APPROXIMATELY_LOCATION或者同时申请ohos.permission.APPROXIMATELY_LOCATION和ohos.permission.LOCATION；无法单独申请ohos.permission.LOCATION。

| 使用的API版本 | 申请位置权限 | 申请结果 | 位置的精确度 |
| -------- | -------- | -------- | -------- |
| 小于9 | ohos.permission.LOCATION | 成功 | 获取到精准位置，精准度在米级别。 |
| 大于等于9 | ohos.permission.LOCATION | 失败 | 无法获取位置。 |
| 大于等于9 | ohos.permission.APPROXIMATELY_LOCATION | 成功 | 获取到模糊位置，精确度为5公里。 |
| 大于等于9 | ohos.permission.APPROXIMATELY_LOCATION和ohos.permission.LOCATION | 成功 | 获取到精准位置，精准度在米级别。 |

如果应用在后台运行时也需要访问设备位置，除需要将应用声明为允许后台运行外，还必须申请ohos.permission.LOCATION_IN_BACKGROUND权限，这样应用在切入后台之后，系统可以继续上报位置信息。

开发者可以在应用配置文件中声明所需要的权限，具体可参考[授权申请指导](../../../application-dev/security/accesstoken-guidelines.md)。

**关键的接口/组件变更**

如果是存量应用（使用的API版本小于9），则无影响。

如果使用的API版本大于等于9，则在使用@ohos.geolocation和@ohos.geoLocationManager中需要ohos.permission.LOCATION权限的接口时，都需要按照上文所述方式申请对应权限。