From a2ea058403bdf0ca7aebbd869ca0cb3fcccaf0c3 Mon Sep 17 00:00:00 2001 From: liu-binjun Date: Wed, 23 Mar 2022 17:50:30 +0800 Subject: [PATCH] fix location bug Signed-off-by: liu-binjun --- .../reference/apis/js-apis-geolocation.md | 261 +++++++++++++++--- 1 file changed, 229 insertions(+), 32 deletions(-) diff --git a/zh-cn/application-dev/reference/apis/js-apis-geolocation.md b/zh-cn/application-dev/reference/apis/js-apis-geolocation.md index 3225563479..b19f83454e 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-geolocation.md +++ b/zh-cn/application-dev/reference/apis/js-apis-geolocation.md @@ -12,14 +12,6 @@ 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 @@ -33,6 +25,10 @@ on(type: 'locationChange', request: LocationRequest, callback: Callback<Locat | request | LocationRequest | 是 | 设置位置请求参数。 | | callback | Callback<[Location](#location)> | 是 | 接收位置变化状态变化监听。 | +**权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + - 示例： ``` @@ -56,6 +52,10 @@ off(type: 'locationChange', callback?: Callback<Location>) : void | type | string | 是 | 设置事件类型。type为“locationChange”，表示位置变化。 | | callback | Callback<[Location](#location)> | 否 | 接收位置变化状态变化监听。 | +**权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + - 示例： ``` @@ -80,6 +80,10 @@ on(type: 'locationServiceState', callback: Callback<boolean>) : void | type | string | 是 | 设置事件类型。type为“locationServiceState”，表示位置服务状态。 | | callback | Callback<boolean> | 是 | 接收位置服务状态变化监听。 | +**权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + - 示例： ``` @@ -102,6 +106,10 @@ off(type: 'locationServiceState', callback?: Callback<boolean>) : void; | type | string | 是 | 设置事件类型。type为“locationServiceState”，表示位置服务状态。 | | callback | Callback<boolean> | 否 | 接收位置服务状态变化监听。 | +**权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + - 示例： ``` @@ -113,7 +121,7 @@ off(type: 'locationServiceState', callback?: Callback<boolean>) : void; ``` -## geolocation.on('cachedGnssLocationsReporting') +## geolocation.on('cachedGnssLocationsReporting')8+ on(type: 'cachedGnssLocationsReporting', request: CachedGnssLocationsRequest, callback: Callback<Array<Location>>) : void; @@ -126,6 +134,10 @@ on(type: 'cachedGnssLocationsReporting', request: CachedGnssLocationsRequest, ca | request | CachedGnssLocationsRequest | 是 | GNSS缓存功能配置参数 | | callback | Callback<boolean> | 是 | 接收GNSS缓存位置上报。 | +**权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + - 示例： ``` @@ -137,7 +149,7 @@ on(type: 'cachedGnssLocationsReporting', request: CachedGnssLocationsRequest, ca ``` -## geolocation.off('cachedGnssLocationsReporting') +## geolocation.off('cachedGnssLocationsReporting')8+ off(type: 'cachedGnssLocationsReporting', callback?: Callback<Array<Location>>) : void; @@ -149,6 +161,10 @@ off(type: 'cachedGnssLocationsReporting', callback?: Callback<Array<Locati | type | string | 是 | 设置事件类型。type为“cachedGnssLocationsReporting”，表示GNSS缓存定位结果上报。 | | callback | Callback<boolean> | 否 | 接收GNSS缓存位置上报。 | +**权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + - 示例： ``` @@ -161,7 +177,7 @@ off(type: 'cachedGnssLocationsReporting', callback?: Callback<Array<Locati ``` -## geolocation.on('gnssStatusChange') +## geolocation.on('gnssStatusChange')8+ on(type: 'gnssStatusChange', callback: Callback<SatelliteStatusInfo>) : void; @@ -173,6 +189,10 @@ on(type: 'gnssStatusChange', callback: Callback<SatelliteStatusInfo>) : vo | type | string | 是 | 设置事件类型。type为“gnssStatusChange”，表示订阅GNSS卫星状态信息上报。 | | callback | Callback<SatelliteStatusInfo> | 是 | 接收GNSS卫星状态信息上报。 | +**权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + - 示例： ``` @@ -183,7 +203,7 @@ on(type: 'gnssStatusChange', callback: Callback<SatelliteStatusInfo>) : vo ``` -## geolocation.off('gnssStatusChange') +## geolocation.off('gnssStatusChange')8+ off(type: 'gnssStatusChange', callback?: Callback<SatelliteStatusInfo>) : void; @@ -195,6 +215,10 @@ off(type: 'gnssStatusChange', callback?: Callback<SatelliteStatusInfo>) : | type | string | 是 | 设置事件类型。type为“gnssStatusChange”，表示订阅GNSS卫星状态信息上报。 | | callback | Callback<SatelliteStatusInfo> | 否 | 接收GNSS卫星状态信息上报。 | +**权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + - 示例： ``` @@ -206,7 +230,7 @@ off(type: 'gnssStatusChange', callback?: Callback<SatelliteStatusInfo>) : ``` -## geolocation.on('nmeaMessageChange') +## geolocation.on('nmeaMessageChange')8+ on(type: 'nmeaMessageChange', callback: Callback<string>) : void; @@ -218,6 +242,10 @@ on(type: 'nmeaMessageChange', callback: Callback<string>) : void; | type | string | 是 | 设置事件类型。type为“nmeaMessageChange”，表示订阅GNSS NMEA信息上报。 | | callback | Callback<string> | 是 | 接收GNSS NMEA信息上报。 | +**权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + - 示例： ``` @@ -228,7 +256,7 @@ on(type: 'nmeaMessageChange', callback: Callback<string>) : void; ``` -## geolocation.off('nmeaMessageChange') +## geolocation.off('nmeaMessageChange')8+ off(type: 'nmeaMessageChange', callback?: Callback<string>) : void; @@ -240,6 +268,10 @@ off(type: 'nmeaMessageChange', callback?: Callback<string>) : void; | type | string | 是 | 设置事件类型。type为“nmeaMessageChange”，表示订阅GNSS NMEA信息上报。 | | callback | Callback<string> | 否 | 接收GNSS NMEA信息上报。 | +**权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + - 示例： ``` @@ -251,7 +283,7 @@ off(type: 'nmeaMessageChange', callback?: Callback<string>) : void; ``` -## geolocation.on('fenceStatusChange') +## geolocation.on('fenceStatusChange')8+ on(type: 'fenceStatusChange', request: GeofenceRequest, want: WantAgent) : void; @@ -264,6 +296,10 @@ on(type: 'fenceStatusChange', request: GeofenceRequest, want: WantAgent) : void; | request | GeofenceRequest | 是 | 围栏的配置参数。 | | want | WantAgent | 是 | 用于接收地理围栏事件上报（进出围栏）。 | +**权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + - 示例： ``` @@ -313,7 +349,7 @@ on(type: 'fenceStatusChange', request: GeofenceRequest, want: WantAgent) : void; ``` -## geolocation.off('fenceStatusChange') +## geolocation.off('fenceStatusChange')8+ off(type: 'fenceStatusChange', request: GeofenceRequest, want: WantAgent) : void; @@ -326,6 +362,10 @@ off(type: 'fenceStatusChange', request: GeofenceRequest, want: WantAgent) : void | request | GeofenceRequest | 是 | 围栏的配置参数。 | | want | WantAgent | 是 | 用于接收地理围栏事件上报（进出围栏）。 | +**权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + - 示例： ``` @@ -390,6 +430,10 @@ getCurrentLocation(request: CurrentLocationRequest, callback: AsyncCallback<L | request | [CurrentLocationRequest](#currentlocationrequest) | 否 | 设置位置请求参数。 | | callback | AsyncCallback<[Location](#location)> | 是 | 用来接收位置信息的回调。 | +**权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + - 示例： ``` @@ -420,6 +464,10 @@ getCurrentLocation(request?: CurrentLocationRequest) : Promise<Location> | -------- | -------- | | Promise<[Location](#location)> | 返回位置信息。 | +**权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + - 示例： ``` @@ -441,6 +489,10 @@ getLastLocation(callback: AsyncCallback<Location>) : void | -------- | -------- | -------- | -------- | | callback | AsyncCallback<[Location](#location)> | 是 | 用来接收上次位置的回调。 | +**权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + - 示例： ``` @@ -461,6 +513,10 @@ getLastLocation() : Promise<Location> | -------- | -------- | | Promise<[Location](#location)> | 返回上次位置信息。 | +**权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + - 示例： ``` @@ -483,6 +539,10 @@ isLocationEnabled(callback: AsyncCallback<boolean>) : void | -------- | -------- | -------- | -------- | | callback | AsyncCallback<boolean> | 是 | 用来接收位置服务状态的回调。 | +**权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + - 示例： ``` @@ -503,6 +563,10 @@ isLocationEnabled() : Promise<boolean> | -------- | -------- | | Promise<boolean> | 返回位置服务是否可用的状态。 | +**权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + - 示例： ``` @@ -525,6 +589,10 @@ requestEnableLocation(callback: AsyncCallback<boolean>) : void | -------- | -------- | -------- | -------- | | callback | AsyncCallback<boolean> | 是 | 用来接收位置服务状态的回调。 | +**权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + - 示例： ``` @@ -545,6 +613,10 @@ requestEnableLocation() : Promise<boolean> | -------- | -------- | | Promise<boolean> | 返回位置服务是否可用。 | +**权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + - 示例： ``` @@ -565,6 +637,10 @@ isGeoServiceAvailable(callback: AsyncCallback<boolean>) : void | -------- | -------- | -------- | -------- | | callback | AsyncCallback<boolean> | 是 | 用来接收地理编码服务状态的回调。 | +**权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + - 示例： ``` @@ -585,6 +661,10 @@ isGeoServiceAvailable() : Promise<boolean> | -------- | -------- | | Promise<boolean> | 返回地理编码服务是否可用的状态。 | +**权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + - 示例： ``` @@ -607,6 +687,10 @@ getAddressesFromLocation(request: ReverseGeoCodeRequest, callback: AsyncCallback | request | [ReverseGeoCodeRequest](#reversegeocoderequest) | 是 | 设置逆地理编码请求的相关参数。 | | callback | AsyncCallback<Array<[GeoAddress](#geoaddress)>> | 是 | 设置接收逆地理编码请求的回调参数。 | +**权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + - 示例： ``` @@ -628,6 +712,10 @@ getAddressesFromLocation(request: ReverseGeoCodeRequest) : Promise<Array<G | -------- | -------- | -------- | -------- | | request | [ReverseGeoCodeRequest](#reversegeocoderequest) | 是 | 设置逆地理编码请求的相关参数。 | +**权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + - 返回值： | 参数名 | 说明 | | -------- | -------- | @@ -655,6 +743,10 @@ getAddressesFromLocationName(request: GeoCodeRequest, callback: AsyncCallback< | request | [GeoCodeRequest](#geocoderequest) | 是 | 设置地理编码请求的相关参数。 | | callback | AsyncCallback<Array<[GeoAddress](#geoaddress)>> | 是 | 设置接收地理编码请求的回调参数。 | +**权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + - 示例： ``` @@ -671,6 +763,10 @@ getAddressesFromLocationName(request: GeoCodeRequest) : Promise<Array<GeoA 调用地理编码服务，将地理描述转换为具体坐标，使用Promise方式异步返回结果。 +**权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + - 参数： | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | @@ -692,12 +788,16 @@ getAddressesFromLocationName(request: GeoCodeRequest) : Promise<Array<GeoA -## geolocation.getCachedGnssLocationsSize +## geolocation.getCachedGnssLocationsSize8+ getCachedGnssLocationsSize(callback: AsyncCallback<number>) : void; 获取GNSS芯片缓存位置的个数。 +**权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + - 参数： | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | @@ -712,12 +812,16 @@ getCachedGnssLocationsSize(callback: AsyncCallback<number>) : void; ``` -## geolocation.getCachedGnssLocationsSize +## geolocation.getCachedGnssLocationsSize8+ getCachedGnssLocationsSize() : Promise<number>; 获取GNSS芯片缓存位置的个数。 +**权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + - 返回值： | 参数名 | 说明 | | -------- | -------- | @@ -732,12 +836,16 @@ getCachedGnssLocationsSize() : Promise<number>; ``` -## geolocation.flushCachedGnssLocations +## geolocation.flushCachedGnssLocations8+ flushCachedGnssLocations(callback: AsyncCallback<boolean>) : void; 读取并清空GNSS芯片所有缓存位置。 +**权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + - 参数： | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | @@ -752,12 +860,16 @@ flushCachedGnssLocations(callback: AsyncCallback<boolean>) : void; ``` -## geolocation.flushCachedGnssLocations +## geolocation.flushCachedGnssLocations8+ flushCachedGnssLocations() : Promise<boolean>; 读取并清空GNSS芯片所有缓存位置。 +**权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + - 返回值： | 参数名 | 说明 | | -------- | -------- | @@ -772,12 +884,16 @@ flushCachedGnssLocations() : Promise<boolean>; ``` -## geolocation.sendCommand +## geolocation.sendCommand8+ sendCommand(command: LocationCommand, callback: AsyncCallback<boolean>) : void; 给位置服务子系统的各个部件发送扩展命令。只有系统应用才能调用。 +**权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + - 参数： | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | @@ -794,12 +910,16 @@ sendCommand(command: LocationCommand, callback: AsyncCallback<boolean>) : ``` -## geolocation.sendCommand +## geolocation.sendCommand8+ sendCommand(command: LocationCommand) : Promise<boolean>; 给位置服务子系统的各个部件发送扩展命令。只有系统应用才能调用。 +**权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + - 参数： | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | @@ -820,12 +940,16 @@ sendCommand(command: LocationCommand) : Promise<boolean>; ``` -## geolocation.isLocationPrivacyConfirmed +## geolocation.isLocationPrivacyConfirmed8+ isLocationPrivacyConfirmed(type : LocationPrivacyType, callback: AsyncCallback<boolean>) : void; 查询用户是否同意定位服务隐私申明，是否同意启用定位服务。只有系统应用才能调用。 +**权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + - 参数： | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | @@ -841,12 +965,16 @@ isLocationPrivacyConfirmed(type : LocationPrivacyType, callback: AsyncCallback&l ``` -## geolocation.isLocationPrivacyConfirmed +## geolocation.isLocationPrivacyConfirmed8+ isLocationPrivacyConfirmed(type : LocationPrivacyType,) : Promise<boolean>; 查询用户是否同意定位服务隐私申明，是否同意启用定位服务。只有系统应用才能调用。 +**权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + - 参数： | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | @@ -866,12 +994,16 @@ isLocationPrivacyConfirmed(type : LocationPrivacyType,) : Promise<boolean> ``` -## geolocation.setLocationPrivacyConfirmStatus +## geolocation.setLocationPrivacyConfirmStatus8+ setLocationPrivacyConfirmStatus(type : LocationPrivacyType, isConfirmed: boolean, callback: AsyncCallback<boolean>) : void; 设置用户勾选定位服务隐私申明的状态，记录用户是否同意启用定位服务。只有系统应用才能调用。 +**权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + - 参数： | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | @@ -888,12 +1020,16 @@ setLocationPrivacyConfirmStatus(type : LocationPrivacyType, isConfirmed: boolean ``` -## geolocation.setLocationPrivacyConfirmStatus +## geolocation.setLocationPrivacyConfirmStatus8+ setLocationPrivacyConfirmStatus(type : LocationPrivacyType, isConfirmed : boolean) : Promise<boolean>; 设置用户勾选定位服务隐私申明的状态，记录用户是否同意启用定位服务。只有系统应用才能调用。 +**权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + - 参数： | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | @@ -919,6 +1055,10 @@ setLocationPrivacyConfirmStatus(type : LocationPrivacyType, isConfirmed : boolea 位置请求中位置信息优先级设置。 +**权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + | 名称 | 默认值 | 说明 | | -------- | -------- | -------- | | UNSET | 0x200 | 表示未设置优先级。 | @@ -930,6 +1070,11 @@ setLocationPrivacyConfirmStatus(type : LocationPrivacyType, isConfirmed : boolea ## LocationRequestScenario 位置请求中定位场景设置。 + +**权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + | 名称 | 默认值 | 说明 | | -------- | -------- | -------- | | UNSET | 0x300 | 表示未设置场景信息。 | @@ -944,6 +1089,10 @@ setLocationPrivacyConfirmStatus(type : LocationPrivacyType, isConfirmed : boolea 位置服务中的错误码信息。 +**权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + | 名称 | 默认值 | 说明 | | -------- | -------- | -------- | | INPUT_PARAMS_ERROR | 101 | 表示输入参数错误。 | @@ -959,6 +1108,10 @@ setLocationPrivacyConfirmStatus(type : LocationPrivacyType, isConfirmed : boolea 逆地理编码请求接口。 +**权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + | 名称 | 参数类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | locale | string | 否 | 指定位置描述信息的语言，“zh”代表中文，“en”代表英文。 | @@ -971,6 +1124,10 @@ setLocationPrivacyConfirmStatus(type : LocationPrivacyType, isConfirmed : boolea 地理编码请求接口。 +**权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + | 名称 | 参数类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | locale | string | 否 | 表示位置描述信息的语言，“zh”代表中文，“en”代表英文。 | @@ -986,6 +1143,10 @@ setLocationPrivacyConfirmStatus(type : LocationPrivacyType, isConfirmed : boolea 地理编码类型。 +**权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + | 名称 | 参数类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | latitude | number | 否 | 表示纬度信息，正值表示北纬，负值表示南纬。 | @@ -1012,6 +1173,10 @@ setLocationPrivacyConfirmStatus(type : LocationPrivacyType, isConfirmed : boolea 位置信息请求类型。 +**权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + | 名称 | 参数类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | priority | [LocationRequestPriority](#locationrequestpriority) | 否 | 表示优先级信息。 | @@ -1025,6 +1190,10 @@ setLocationPrivacyConfirmStatus(type : LocationPrivacyType, isConfirmed : boolea 当前位置信息请求类型。 +**权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + | 名称 | 参数类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | priority | [LocationRequestPriority](#locationrequestpriority) | 否 | 表示优先级信息。 | @@ -1033,10 +1202,14 @@ setLocationPrivacyConfirmStatus(type : LocationPrivacyType, isConfirmed : boolea | timeoutMs | number | 否 | 表示超时时间，单位是毫秒，最小为1000毫秒。 | -## SatelliteStatusInfo +## SatelliteStatusInfo8+ 卫星状态信息。 +**权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + | 名称 | 参数类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | satellitesNumber | number | 是 | 表示卫星个数。 | @@ -1047,20 +1220,28 @@ setLocationPrivacyConfirmStatus(type : LocationPrivacyType, isConfirmed : boolea | carrierFrequencies | Array<number> | 是 | 表示载波频率。 | -## CachedGnssLocationsRequest +## CachedGnssLocationsRequest8+ 请求订阅GNSS缓存位置上报功能接口的配置参数。 +**权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + | 名称 | 参数类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | reportingPeriodSec | number | 是 | 表示GNSS缓存位置上报的周期，单位是毫秒。 | | wakeUpCacheQueueFull | boolean | 是 | true表示GNSS芯片底层缓存队列满之后会主动唤醒AP芯片，并把缓存位置上报给应用。
false表示GNSS芯片底层缓存队列满之后不会主动唤醒AP芯片，会把缓存位置直接丢弃。 | -## Geofence +## Geofence8+ GNSS围栏的配置参数。目前只支持圆形围栏。 +**权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + | 名称 | 参数类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | latitude | number | 是 | 表示纬度。 | @@ -1069,10 +1250,14 @@ GNSS围栏的配置参数。目前只支持圆形围栏。 | expiration | number | 是 | 围栏存活的时间，单位是毫秒。 | -## GeofenceRequest +## GeofenceRequest8+ 请求添加GNSS围栏消息中携带的参数，包括定位优先级、定位场景和围栏信息。 +**权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + | 名称 | 参数类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | priority | LocationRequestPriority | 是 | 表示位置信息优先级。 | @@ -1080,10 +1265,14 @@ GNSS围栏的配置参数。目前只支持圆形围栏。 | geofence | Geofence | 是 | 表示围栏信息。 | -## LocationPrivacyType +## LocationPrivacyType8+ 定位服务隐私协议类型。 +**权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + | 名称 | 默认值 | 说明 | | -------- | -------- | -------- | | OTHERS | 0 | 其他场景。 | @@ -1091,10 +1280,14 @@ GNSS围栏的配置参数。目前只支持圆形围栏。 | CORE_LOCATION | 2 | 开启网络定位时弹出的隐私协议。 | -## LocationCommand +## LocationCommand8+ 扩展命令结构体。 +**权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + | 名称 | 参数类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | scenario | LocationRequestScenario | 是 | 表示定位场景。 | @@ -1105,6 +1298,10 @@ GNSS围栏的配置参数。目前只支持圆形围栏。 位置信息类型。 +**权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + | 名称 | 参数类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | latitude | number | 是 | 表示纬度信息，正值表示北纬，负值表示南纬。 | -- GitLab