Skip to content

D
Docs

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

通知 161
Star 293
Fork 28
D
Docs
未验证 提交 3b018bc6 编写于 作者: O openharmony_ci 提交者： Gitee
浏览文件
操作

!2407 修改location的bug 

Merge pull request !2407 from 刘彬俊/master
上级 38d1809c 7a5f7505
显示空白变更内容
内联 并排
Showing with 358 addition and 32 deletion
zh-cn/application-dev/reference/apis/js-apis-geolocation.md
浏览文件 @ 3b018bc6
......@@ -12,20 +12,16 @@
import geolocation from '@ohos.geolocation';
```
## 权限
ohos.permission.LOCATION
ohos.permission.LOCATION_IN_BACKGROUND
## geolocation.on('locationChange')
on(type: 'locationChange', request: LocationRequest, callback: Callback<Location>) : void
开启位置变化订阅，并发起定位请求。
**需要权限**：ohos.permission.LOCATION
**系统能力**：SystemCapability.Location.Location.Core
- 参数：
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
......@@ -33,6 +29,7 @@ on(type: 'locationChange', request: LocationRequest, callback: Callback<Locat
| request | LocationRequest | 是 | 设置位置请求参数。 |
| callback | Callback<[Location](#location)> | 是 | 接收位置变化状态变化监听。 |
- 示例：
```
......@@ -50,12 +47,17 @@ off(type: 'locationChange', callback?: Callback<Location>) : void
关闭位置变化订阅，并删除对应的定位请求。
**需要权限**：ohos.permission.LOCATION
**系统能力**：SystemCapability.Location.Location.Core
- 参数：
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| type | string | 是 | 设置事件类型。type为“locationChange”，表示位置变化。 |
| callback | Callback<[Location](#location)> | 否 | 接收位置变化状态变化监听。 |
- 示例：
```
......@@ -74,12 +76,17 @@ on(type: 'locationServiceState', callback: Callback<boolean>) : void
订阅位置服务状态变化。
**需要权限**：ohos.permission.LOCATION
**系统能力**：SystemCapability.Location.Location.Core
- 参数：
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| type | string | 是 | 设置事件类型。type为“locationServiceState”，表示位置服务状态。 |
| callback | Callback<boolean> | 是 | 接收位置服务状态变化监听。 |
- 示例：
```
......@@ -96,12 +103,17 @@ off(type: 'locationServiceState', callback?: Callback<boolean>) : void;
取消订阅位置服务状态变化。
**需要权限**：ohos.permission.LOCATION
**系统能力**：SystemCapability.Location.Location.Core
- 参数：
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| type | string | 是 | 设置事件类型。type为“locationServiceState”，表示位置服务状态。 |
| callback | Callback<boolean> | 否 | 接收位置服务状态变化监听。 |
- 示例：
```
......@@ -113,12 +125,16 @@ off(type: 'locationServiceState', callback?: Callback<boolean>) : void;
```
## geolocation.on('cachedGnssLocationsReporting')
## geolocation.on('cachedGnssLocationsReporting')<sup>8+</sup>
on(type: 'cachedGnssLocationsReporting', request: CachedGnssLocationsRequest, callback: Callback&lt;Array&lt;Location&gt;&gt;) : void;
订阅缓存GNSS定位结果上报事件。
**需要权限**：ohos.permission.LOCATION
**系统能力**：SystemCapability.Location.Location.Gnss
- 参数：
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
......@@ -126,6 +142,7 @@ on(type: 'cachedGnssLocationsReporting', request: CachedGnssLocationsRequest, ca
| request | CachedGnssLocationsRequest | 是 | GNSS缓存功能配置参数 |
| callback | Callback&lt;boolean&gt; | 是 | 接收GNSS缓存位置上报。 |
- 示例：
```
......@@ -137,18 +154,23 @@ on(type: 'cachedGnssLocationsReporting', request: CachedGnssLocationsRequest, ca
```
## geolocation.off('cachedGnssLocationsReporting')
## geolocation.off('cachedGnssLocationsReporting')<sup>8+</sup>
off(type: 'cachedGnssLocationsReporting', callback?: Callback&lt;Array&lt;Location&gt;&gt;) : void;
取消订阅缓存GNSS定位结果上报事件。
**需要权限**：ohos.permission.LOCATION
**系统能力**：SystemCapability.Location.Location.Gnss
- 参数：
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| type | string | 是 | 设置事件类型。type为“cachedGnssLocationsReporting”，表示GNSS缓存定位结果上报。 |
| callback | Callback&lt;boolean&gt; | 否 | 接收GNSS缓存位置上报。 |
- 示例：
```
......@@ -161,18 +183,23 @@ off(type: 'cachedGnssLocationsReporting', callback?: Callback&lt;Array&lt;Locati
```
## geolocation.on('gnssStatusChange')
## geolocation.on('gnssStatusChange')<sup>8+</sup>
on(type: 'gnssStatusChange', callback: Callback&lt;SatelliteStatusInfo&gt;) : void;
订阅GNSS卫星状态信息上报事件。
**需要权限**：ohos.permission.LOCATION
**系统能力**：SystemCapability.Location.Location.Gnss
- 参数：
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| type | string | 是 | 设置事件类型。type为“gnssStatusChange”，表示订阅GNSS卫星状态信息上报。 |
| callback | Callback&lt;SatelliteStatusInfo&gt; | 是 | 接收GNSS卫星状态信息上报。 |
- 示例：
```
......@@ -183,12 +210,16 @@ on(type: 'gnssStatusChange', callback: Callback&lt;SatelliteStatusInfo&gt;) : vo
```
## geolocation.off('gnssStatusChange')
## geolocation.off('gnssStatusChange')<sup>8+</sup>
off(type: 'gnssStatusChange', callback?: Callback&lt;SatelliteStatusInfo&gt;) : void;
取消订阅GNSS卫星状态信息上报事件。
**需要权限**：ohos.permission.LOCATION
**系统能力**：SystemCapability.Location.Location.Gnss
- 参数：
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
......@@ -206,18 +237,23 @@ off(type: 'gnssStatusChange', callback?: Callback&lt;SatelliteStatusInfo&gt;) :
```
## geolocation.on('nmeaMessageChange')
## geolocation.on('nmeaMessageChange')<sup>8+</sup>
on(type: 'nmeaMessageChange', callback: Callback&lt;string&gt;) : void;
订阅GNSS NMEA信息上报事件。
**需要权限**：ohos.permission.LOCATION
**系统能力**：SystemCapability.Location.Location.Gnss
- 参数：
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| type | string | 是 | 设置事件类型。type为“nmeaMessageChange”，表示订阅GNSS&nbsp;NMEA信息上报。 |
| callback | Callback&lt;string&gt; | 是 | 接收GNSS&nbsp;NMEA信息上报。 |
- 示例：
```
......@@ -228,18 +264,23 @@ on(type: 'nmeaMessageChange', callback: Callback&lt;string&gt;) : void;
```
## geolocation.off('nmeaMessageChange')
## geolocation.off('nmeaMessageChange')<sup>8+</sup>
off(type: 'nmeaMessageChange', callback?: Callback&lt;string&gt;) : void;
取消订阅GNSS NMEA信息上报事件。
**需要权限**：ohos.permission.LOCATION
**系统能力**：SystemCapability.Location.Location.Gnss
- 参数：
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| type | string | 是 | 设置事件类型。type为“nmeaMessageChange”，表示订阅GNSS&nbsp;NMEA信息上报。 |
| callback | Callback&lt;string&gt; | 否 | 接收GNSS&nbsp;NMEA信息上报。 |
- 示例：
```
......@@ -251,12 +292,16 @@ off(type: 'nmeaMessageChange', callback?: Callback&lt;string&gt;) : void;
```
## geolocation.on('fenceStatusChange')
## geolocation.on('fenceStatusChange')<sup>8+</sup>
on(type: 'fenceStatusChange', request: GeofenceRequest, want: WantAgent) : void;
添加一个围栏，并订阅地理围栏事件。
**需要权限**：ohos.permission.LOCATION
**系统能力**：SystemCapability.Location.Location.Geofence
- 参数：
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
......@@ -264,6 +309,7 @@ on(type: 'fenceStatusChange', request: GeofenceRequest, want: WantAgent) : void;
| request | GeofenceRequest | 是 | 围栏的配置参数。 |
| want | WantAgent | 是 | 用于接收地理围栏事件上报（进出围栏）。 |
- 示例：
```
......@@ -313,12 +359,16 @@ on(type: 'fenceStatusChange', request: GeofenceRequest, want: WantAgent) : void;
```
## geolocation.off('fenceStatusChange')
## geolocation.off('fenceStatusChange')<sup>8+</sup>
off(type: 'fenceStatusChange', request: GeofenceRequest, want: WantAgent) : void;
删除一个围栏，并取消订阅该围栏事件。
**需要权限**：ohos.permission.LOCATION
**系统能力**：SystemCapability.Location.Location.Geofence
- 参数：
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
......@@ -383,6 +433,9 @@ getCurrentLocation(request: CurrentLocationRequest, callback: AsyncCallback&lt;L
获取当前位置，使用callback回调异步返回结果。
**需要权限**：ohos.permission.LOCATION
**系统能力**：SystemCapability.Location.Location.Core
- 参数：
| 参数名 | 类型 | 必填 | 说明 |
......@@ -409,6 +462,9 @@ getCurrentLocation(request?: CurrentLocationRequest) : Promise&lt;Location&gt;
获取当前位置，使用Promise方式异步返回结果。
**需要权限**：ohos.permission.LOCATION
**系统能力**：SystemCapability.Location.Location.Core
- 参数：
| 参数名 | 类型 | 必填 | 说明 |
......@@ -420,6 +476,7 @@ getCurrentLocation(request?: CurrentLocationRequest) : Promise&lt;Location&gt;
| -------- | -------- |
| Promise&lt;[Location](#location)&gt; | 返回位置信息。 |
- 示例：
```
......@@ -436,11 +493,16 @@ getLastLocation(callback: AsyncCallback&lt;Location&gt;) : void
获取上一次位置，使用callback回调异步返回结果。
**需要权限**：ohos.permission.LOCATION
**系统能力**：SystemCapability.Location.Location.Core
- 参数：
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| callback | AsyncCallback&lt;[Location](#location)&gt; | 是 | 用来接收上次位置的回调。 |
- 示例：
```
......@@ -456,11 +518,16 @@ getLastLocation() : Promise&lt;Location&gt;
获取上一次位置，使用Promise方式异步返回结果。
**需要权限**：ohos.permission.LOCATION
**系统能力**：SystemCapability.Location.Location.Core
- 返回值：
| 参数名 | 说明 |
| -------- | -------- |
| Promise&lt;[Location](#location)&gt; | 返回上次位置信息。 |
- 示例：
```
......@@ -477,12 +544,16 @@ isLocationEnabled(callback: AsyncCallback&lt;boolean&gt;) : void
判断位置服务是否已经打开，使用callback回调异步返回结果。
**需要权限**：ohos.permission.LOCATION
**系统能力**：SystemCapability.Location.Location.Core
- 参数：
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| callback | AsyncCallback&lt;boolean&gt; | 是 | 用来接收位置服务状态的回调。 |
- 示例：
```
......@@ -498,6 +569,10 @@ isLocationEnabled() : Promise&lt;boolean&gt;
判断位置服务是否已经开启，使用Promise方式异步返回结果。
**需要权限**：ohos.permission.LOCATION
**系统能力**：SystemCapability.Location.Location.Core
- 返回值：
| 参数名 | 说明 |
| -------- | -------- |
......@@ -519,12 +594,16 @@ requestEnableLocation(callback: AsyncCallback&lt;boolean&gt;) : void
请求打开位置服务，使用callback回调异步返回结果。
**需要权限**：ohos.permission.LOCATION
**系统能力**：SystemCapability.Location.Location.Core
- 参数：
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| callback | AsyncCallback&lt;boolean&gt; | 是 | 用来接收位置服务状态的回调。 |
- 示例：
```
......@@ -540,11 +619,16 @@ requestEnableLocation() : Promise&lt;boolean&gt;
请求打开位置服务，使用Promise方式异步返回结果。
**需要权限**：ohos.permission.LOCATION
**系统能力**：SystemCapability.Location.Location.Core
- 返回值：
| 参数名 | 说明 |
| -------- | -------- |
| Promise&lt;boolean&gt; | 返回位置服务是否可用。 |
- 示例：
```
......@@ -554,17 +638,128 @@ requestEnableLocation() : Promise&lt;boolean&gt;
```
## geolocation.enableLocation
enableLocation(callback: AsyncCallback&lt;boolean&gt;) : void;
打开位置服务，使用callback回调异步返回结果。
**系统API**：此接口为系统接口，三方应用不支持调用。
**需要权限**：ohos.permission.LOCATION
**系统能力**：SystemCapability.Location.Location.Core
- 参数：
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| callback | AsyncCallback&lt;boolean&gt; | 是 | 用来接收位置服务状态的回调。 |
- 示例：
```
geolocation.enableLocation((err, data) => {
console.log('enableLocation: ' + err + " data: " + data);
});
```
## geolocation.enableLocation
enableLocation() : Promise&lt;boolean&gt;
打开位置服务，使用Promise方式异步返回结果。
**系统API**：此接口为系统接口，三方应用不支持调用。
**需要权限**：ohos.permission.LOCATION
**系统能力**：SystemCapability.Location.Location.Core
- 返回值：
| 参数名 | 说明 |
| -------- | -------- |
| Promise&lt;boolean&gt; | 返回位置服务是否可用。 |
- 示例：
```
geolocation.enableLocation().then((result) => {
console.log('promise, enableLocation: ' + result);
});
```
## geolocation.disableLocation
disableLocation(callback: AsyncCallback&lt;boolean&gt;) : void;
打开位置服务，使用callback回调异步返回结果。
**系统API**：此接口为系统接口，三方应用不支持调用。
**需要权限**：ohos.permission.LOCATION
**系统能力**：SystemCapability.Location.Location.Core
- 参数：
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| callback | AsyncCallback&lt;boolean&gt; | 是 | 用来接收位置服务状态的回调。 |
- 示例：
```
geolocation.disableLocation((err, data) => {
console.log('disableLocation: ' + err + " data: " + data);
});
```
## geolocation.disableLocation
disableLocation() : Promise&lt;boolean&gt;
打开位置服务，使用Promise方式异步返回结果。
**系统API**：此接口为系统接口，三方应用不支持调用。
**需要权限**：ohos.permission.LOCATION
**系统能力**：SystemCapability.Location.Location.Core
- 返回值：
| 参数名 | 说明 |
| -------- | -------- |
| Promise&lt;boolean&gt; | 返回位置服务是否可用。 |
- 示例：
```
geolocation.disableLocation().then((result) => {
console.log('promise, disableLocation: ' + result);
});
```
## geolocation.isGeoServiceAvailable
isGeoServiceAvailable(callback: AsyncCallback&lt;boolean&gt;) : void
判断（逆）地理编码服务状态，使用callback回调异步返回结果。
**需要权限**：ohos.permission.LOCATION
**系统能力**：SystemCapability.Location.Location.Geocoder
- 参数：
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| callback | AsyncCallback&lt;boolean&gt; | 是 | 用来接收地理编码服务状态的回调。 |
- 示例：
```
......@@ -580,11 +775,16 @@ isGeoServiceAvailable() : Promise&lt;boolean&gt;
判断（逆）地理编码服务状态，使用Promise方式异步返回结果。
**需要权限**：ohos.permission.LOCATION
**系统能力**：SystemCapability.Location.Location.Geocoder
- 返回值：
| 参数名 | 说明 |
| -------- | -------- |
| Promise&lt;boolean&gt; | 返回地理编码服务是否可用的状态。 |
- 示例：
```
......@@ -601,6 +801,10 @@ getAddressesFromLocation(request: ReverseGeoCodeRequest, callback: AsyncCallback
调用逆地理编码服务，将坐标转换为地理描述，使用callback回调异步返回结果。
**需要权限**：ohos.permission.LOCATION
**系统能力**：SystemCapability.Location.Location.Geocoder
- 参数：
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
......@@ -623,6 +827,10 @@ getAddressesFromLocation(request: ReverseGeoCodeRequest) : Promise&lt;Array&lt;G
调用逆地理编码服务，将坐标转换为地理描述，使用Promise方式异步返回结果。
**需要权限**：ohos.permission.LOCATION
**系统能力**：SystemCapability.Location.Location.Geocoder
- 参数：
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
......@@ -649,12 +857,17 @@ getAddressesFromLocationName(request: GeoCodeRequest, callback: AsyncCallback&lt
调用地理编码服务，将地理描述转换为具体坐标，使用callback回调异步返回结果。
**需要权限**：ohos.permission.LOCATION
**系统能力**：SystemCapability.Location.Location.Geocoder
- 参数：
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| request | [GeoCodeRequest](#geocoderequest) | 是 | 设置地理编码请求的相关参数。 |
| callback | AsyncCallback&lt;Array&lt;[GeoAddress](#geoaddress)&gt;&gt; | 是 | 设置接收地理编码请求的回调参数。 |
- 示例：
```
......@@ -671,6 +884,10 @@ getAddressesFromLocationName(request: GeoCodeRequest) : Promise&lt;Array&lt;GeoA
调用地理编码服务，将地理描述转换为具体坐标，使用Promise方式异步返回结果。
**需要权限**：ohos.permission.LOCATION
**系统能力**：SystemCapability.Location.Location.Geocoder
- 参数：
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
......@@ -692,12 +909,16 @@ getAddressesFromLocationName(request: GeoCodeRequest) : Promise&lt;Array&lt;GeoA
## geolocation.getCachedGnssLocationsSize
## geolocation.getCachedGnssLocationsSize<sup>8+</sup>
getCachedGnssLocationsSize(callback: AsyncCallback&lt;number&gt;) : void;
获取GNSS芯片缓存位置的个数。
**需要权限**：ohos.permission.LOCATION
**系统能力**：SystemCapability.Location.Location.Gnss
- 参数：
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
......@@ -712,12 +933,16 @@ getCachedGnssLocationsSize(callback: AsyncCallback&lt;number&gt;) : void;
```
## geolocation.getCachedGnssLocationsSize
## geolocation.getCachedGnssLocationsSize<sup>8+</sup>
getCachedGnssLocationsSize() : Promise&lt;number&gt;;
获取GNSS芯片缓存位置的个数。
**需要权限**：ohos.permission.LOCATION
**系统能力**：SystemCapability.Location.Location.Gnss
- 返回值：
| 参数名 | 说明 |
| -------- | -------- |
......@@ -732,12 +957,16 @@ getCachedGnssLocationsSize() : Promise&lt;number&gt;;
```
## geolocation.flushCachedGnssLocations
## geolocation.flushCachedGnssLocations<sup>8+</sup>
flushCachedGnssLocations(callback: AsyncCallback&lt;boolean&gt;) : void;
读取并清空GNSS芯片所有缓存位置。
**需要权限**：ohos.permission.LOCATION
**系统能力**：SystemCapability.Location.Location.Gnss
- 参数：
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
......@@ -752,12 +981,16 @@ flushCachedGnssLocations(callback: AsyncCallback&lt;boolean&gt;) : void;
```
## geolocation.flushCachedGnssLocations
## geolocation.flushCachedGnssLocations<sup>8+</sup>
flushCachedGnssLocations() : Promise&lt;boolean&gt;;
读取并清空GNSS芯片所有缓存位置。
**需要权限**：ohos.permission.LOCATION
**系统能力**：SystemCapability.Location.Location.Gnss
- 返回值：
| 参数名 | 说明 |
| -------- | -------- |
......@@ -772,12 +1005,16 @@ flushCachedGnssLocations() : Promise&lt;boolean&gt;;
```
## geolocation.sendCommand
## geolocation.sendCommand<sup>8+</sup>
sendCommand(command: LocationCommand, callback: AsyncCallback&lt;boolean&gt;) : void;
给位置服务子系统的各个部件发送扩展命令。只有系统应用才能调用。
**需要权限**：ohos.permission.LOCATION
**系统能力**：SystemCapability.Location.Location.Core
- 参数：
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
......@@ -794,12 +1031,16 @@ sendCommand(command: LocationCommand, callback: AsyncCallback&lt;boolean&gt;) :
```
## geolocation.sendCommand
## geolocation.sendCommand<sup>8+</sup>
sendCommand(command: LocationCommand) : Promise&lt;boolean&gt;;
给位置服务子系统的各个部件发送扩展命令。只有系统应用才能调用。
**需要权限**：ohos.permission.LOCATION
**系统能力**：SystemCapability.Location.Location.Core
- 参数：
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
......@@ -820,12 +1061,18 @@ sendCommand(command: LocationCommand) : Promise&lt;boolean&gt;;
```
## geolocation.isLocationPrivacyConfirmed
## geolocation.isLocationPrivacyConfirmed<sup>8+</sup>
isLocationPrivacyConfirmed(type : LocationPrivacyType, callback: AsyncCallback&lt;boolean&gt;) : void;
查询用户是否同意定位服务隐私申明，是否同意启用定位服务。只有系统应用才能调用。
**系统API**：此接口为系统接口，三方应用不支持调用。
**需要权限**：ohos.permission.LOCATION
**系统能力**：SystemCapability.Location.Location.Core
- 参数：
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
......@@ -841,12 +1088,18 @@ isLocationPrivacyConfirmed(type : LocationPrivacyType, callback: AsyncCallback&l
```
## geolocation.isLocationPrivacyConfirmed
## geolocation.isLocationPrivacyConfirmed<sup>8+</sup>
isLocationPrivacyConfirmed(type : LocationPrivacyType,) : Promise&lt;boolean&gt;;
查询用户是否同意定位服务隐私申明，是否同意启用定位服务。只有系统应用才能调用。
**系统API**：此接口为系统接口，三方应用不支持调用。
**需要权限**：ohos.permission.LOCATION
**系统能力**：SystemCapability.Location.Location.Core
- 参数：
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
......@@ -866,12 +1119,18 @@ isLocationPrivacyConfirmed(type : LocationPrivacyType,) : Promise&lt;boolean&gt;
```
## geolocation.setLocationPrivacyConfirmStatus
## geolocation.setLocationPrivacyConfirmStatus<sup>8+</sup>
setLocationPrivacyConfirmStatus(type : LocationPrivacyType, isConfirmed: boolean, callback: AsyncCallback&lt;boolean&gt;) : void;
设置用户勾选定位服务隐私申明的状态，记录用户是否同意启用定位服务。只有系统应用才能调用。
**系统API**：此接口为系统接口，三方应用不支持调用。
**需要权限**：ohos.permission.LOCATION
**系统能力**：SystemCapability.Location.Location.Core
- 参数：
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
......@@ -888,12 +1147,18 @@ setLocationPrivacyConfirmStatus(type : LocationPrivacyType, isConfirmed: boolean
```
## geolocation.setLocationPrivacyConfirmStatus
## geolocation.setLocationPrivacyConfirmStatus<sup>8+</sup>
setLocationPrivacyConfirmStatus(type : LocationPrivacyType, isConfirmed : boolean) : Promise&lt;boolean&gt;;
设置用户勾选定位服务隐私申明的状态，记录用户是否同意启用定位服务。只有系统应用才能调用。
**系统API**：此接口为系统接口，三方应用不支持调用。
**需要权限**：ohos.permission.LOCATION
**系统能力**：SystemCapability.Location.Location.Core
- 参数：
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
......@@ -919,6 +1184,10 @@ setLocationPrivacyConfirmStatus(type : LocationPrivacyType, isConfirmed : boolea
位置请求中位置信息优先级设置。
**需要权限**：ohos.permission.LOCATION
**系统能力**：SystemCapability.Location.Location.Core
| 名称 | 默认值 | 说明 |
| -------- | -------- | -------- |
| UNSET | 0x200 | 表示未设置优先级。 |
......@@ -930,6 +1199,11 @@ setLocationPrivacyConfirmStatus(type : LocationPrivacyType, isConfirmed : boolea
## LocationRequestScenario
位置请求中定位场景设置。
**需要权限**：ohos.permission.LOCATION
**系统能力**：SystemCapability.Location.Location.Core
| 名称 | 默认值 | 说明 |
| -------- | -------- | -------- |
| UNSET | 0x300 | 表示未设置场景信息。 |
......@@ -944,6 +1218,10 @@ setLocationPrivacyConfirmStatus(type : LocationPrivacyType, isConfirmed : boolea
位置服务中的错误码信息。
**需要权限**：ohos.permission.LOCATION
**系统能力**：SystemCapability.Location.Location.Core
| 名称 | 默认值 | 说明 |
| -------- | -------- | -------- |
| INPUT_PARAMS_ERROR | 101 | 表示输入参数错误。 |
......@@ -959,6 +1237,10 @@ setLocationPrivacyConfirmStatus(type : LocationPrivacyType, isConfirmed : boolea
逆地理编码请求接口。
**需要权限**：ohos.permission.LOCATION
**系统能力**：SystemCapability.Location.Location.Geocoder
| 名称 | 参数类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| locale | string | 否 | 指定位置描述信息的语言，“zh”代表中文，“en”代表英文。 |
......@@ -971,6 +1253,10 @@ setLocationPrivacyConfirmStatus(type : LocationPrivacyType, isConfirmed : boolea
地理编码请求接口。
**需要权限**：ohos.permission.LOCATION
**系统能力**：SystemCapability.Location.Location.Geocoder
| 名称 | 参数类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| locale | string | 否 | 表示位置描述信息的语言，“zh”代表中文，“en”代表英文。 |
......@@ -986,6 +1272,10 @@ setLocationPrivacyConfirmStatus(type : LocationPrivacyType, isConfirmed : boolea
地理编码类型。
**需要权限**：ohos.permission.LOCATION
**系统能力**：SystemCapability.Location.Location.Geocoder
| 名称 | 参数类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| latitude | number | 否 | 表示纬度信息，正值表示北纬，负值表示南纬。 |
......@@ -1012,6 +1302,10 @@ setLocationPrivacyConfirmStatus(type : LocationPrivacyType, isConfirmed : boolea
位置信息请求类型。
**需要权限**：ohos.permission.LOCATION
**系统能力**：SystemCapability.Location.Location.Core
| 名称 | 参数类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| priority | [LocationRequestPriority](#locationrequestpriority) | 否 | 表示优先级信息。 |
......@@ -1025,6 +1319,10 @@ setLocationPrivacyConfirmStatus(type : LocationPrivacyType, isConfirmed : boolea
当前位置信息请求类型。
**需要权限**：ohos.permission.LOCATION
**系统能力**：SystemCapability.Location.Location.Core
| 名称 | 参数类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| priority | [LocationRequestPriority](#locationrequestpriority) | 否 | 表示优先级信息。 |
......@@ -1033,10 +1331,14 @@ setLocationPrivacyConfirmStatus(type : LocationPrivacyType, isConfirmed : boolea
| timeoutMs | number | 否 | 表示超时时间，单位是毫秒，最小为1000毫秒。 |
## SatelliteStatusInfo
## SatelliteStatusInfo<sup>8+</sup>
卫星状态信息。
**需要权限**：ohos.permission.LOCATION
**系统能力**：SystemCapability.Location.Location.Gnss
| 名称 | 参数类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| satellitesNumber | number | 是 | 表示卫星个数。 |
......@@ -1047,20 +1349,28 @@ setLocationPrivacyConfirmStatus(type : LocationPrivacyType, isConfirmed : boolea
| carrierFrequencies | Array&lt;number&gt; | 是 | 表示载波频率。 |
## CachedGnssLocationsRequest
## CachedGnssLocationsRequest<sup>8+</sup>
请求订阅GNSS缓存位置上报功能接口的配置参数。
**需要权限**：ohos.permission.LOCATION
**系统能力**：SystemCapability.Location.Location.Gnss
| 名称 | 参数类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| reportingPeriodSec | number | 是 | 表示GNSS缓存位置上报的周期，单位是毫秒。 |
| wakeUpCacheQueueFull | boolean | 是 | true表示GNSS芯片底层缓存队列满之后会主动唤醒AP芯片，并把缓存位置上报给应用。<br/>false表示GNSS芯片底层缓存队列满之后不会主动唤醒AP芯片，会把缓存位置直接丢弃。 |
## Geofence
## Geofence<sup>8+</sup>
GNSS围栏的配置参数。目前只支持圆形围栏。
**需要权限**：ohos.permission.LOCATION
**系统能力**：SystemCapability.Location.Location.Geofence
| 名称 | 参数类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| latitude | number | 是 | 表示纬度。 |
......@@ -1069,10 +1379,14 @@ GNSS围栏的配置参数。目前只支持圆形围栏。
| expiration | number | 是 | 围栏存活的时间，单位是毫秒。 |
## GeofenceRequest
## GeofenceRequest<sup>8+</sup>
请求添加GNSS围栏消息中携带的参数，包括定位优先级、定位场景和围栏信息。
**需要权限**：ohos.permission.LOCATION
**系统能力**：SystemCapability.Location.Location.Geofence
| 名称 | 参数类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| priority | LocationRequestPriority | 是 | 表示位置信息优先级。 |
......@@ -1080,10 +1394,14 @@ GNSS围栏的配置参数。目前只支持圆形围栏。
| geofence | Geofence | 是 | 表示围栏信息。 |
## LocationPrivacyType
## LocationPrivacyType<sup>8+</sup>
定位服务隐私协议类型。
**需要权限**：ohos.permission.LOCATION
**系统能力**：SystemCapability.Location.Location.Core
| 名称 | 默认值 | 说明 |
| -------- | -------- | -------- |
| OTHERS | 0 | 其他场景。 |
......@@ -1091,10 +1409,14 @@ GNSS围栏的配置参数。目前只支持圆形围栏。
| CORE_LOCATION | 2 | 开启网络定位时弹出的隐私协议。 |
## LocationCommand
## LocationCommand<sup>8+</sup>
扩展命令结构体。
**需要权限**：ohos.permission.LOCATION
**系统能力**：SystemCapability.Location.Location.Core
| 名称 | 参数类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| scenario | LocationRequestScenario | 是 | 表示定位场景。 |
......@@ -1105,6 +1427,10 @@ GNSS围栏的配置参数。目前只支持圆形围栏。
位置信息类型。
**需要权限**：ohos.permission.LOCATION
**系统能力**：SystemCapability.Location.Location.Core
| 名称 | 参数类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| latitude | number | 是 | 表示纬度信息，正值表示北纬，负值表示南纬。 |
......
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或