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 32255634797b229d1751b45b1d70832368f233d8..171e328299e74745451fb536f7a58004b1d99cba 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-geolocation.md +++ b/zh-cn/application-dev/reference/apis/js-apis-geolocation.md @@ -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')8+ on(type: 'cachedGnssLocationsReporting', request: CachedGnssLocationsRequest, callback: Callback<Array<Location>>) : void; 订阅缓存GNSS定位结果上报事件。 +**需要权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Gnss + - 参数： | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | @@ -126,6 +142,7 @@ on(type: 'cachedGnssLocationsReporting', request: CachedGnssLocationsRequest, ca | request | CachedGnssLocationsRequest | 是 | GNSS缓存功能配置参数 | | callback | Callback<boolean> | 是 | 接收GNSS缓存位置上报。 | + - 示例： ``` @@ -137,18 +154,23 @@ on(type: 'cachedGnssLocationsReporting', request: CachedGnssLocationsRequest, ca ``` -## geolocation.off('cachedGnssLocationsReporting') +## geolocation.off('cachedGnssLocationsReporting')8+ off(type: 'cachedGnssLocationsReporting', callback?: Callback<Array<Location>>) : void; 取消订阅缓存GNSS定位结果上报事件。 +**需要权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Gnss + - 参数： | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | type | string | 是 | 设置事件类型。type为“cachedGnssLocationsReporting”，表示GNSS缓存定位结果上报。 | | callback | Callback<boolean> | 否 | 接收GNSS缓存位置上报。 | + - 示例： ``` @@ -161,18 +183,23 @@ off(type: 'cachedGnssLocationsReporting', callback?: Callback<Array<Locati ``` -## geolocation.on('gnssStatusChange') +## geolocation.on('gnssStatusChange')8+ on(type: 'gnssStatusChange', callback: Callback<SatelliteStatusInfo>) : void; 订阅GNSS卫星状态信息上报事件。 +**需要权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Gnss + - 参数： | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | type | string | 是 | 设置事件类型。type为“gnssStatusChange”，表示订阅GNSS卫星状态信息上报。 | | callback | Callback<SatelliteStatusInfo> | 是 | 接收GNSS卫星状态信息上报。 | + - 示例： ``` @@ -183,12 +210,16 @@ on(type: 'gnssStatusChange', callback: Callback<SatelliteStatusInfo>) : vo ``` -## geolocation.off('gnssStatusChange') +## geolocation.off('gnssStatusChange')8+ off(type: 'gnssStatusChange', callback?: Callback<SatelliteStatusInfo>) : void; 取消订阅GNSS卫星状态信息上报事件。 +**需要权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Gnss + - 参数： | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | @@ -206,18 +237,23 @@ off(type: 'gnssStatusChange', callback?: Callback<SatelliteStatusInfo>) : ``` -## geolocation.on('nmeaMessageChange') +## geolocation.on('nmeaMessageChange')8+ on(type: 'nmeaMessageChange', callback: Callback<string>) : void; 订阅GNSS NMEA信息上报事件。 +**需要权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Gnss + - 参数： | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | type | string | 是 | 设置事件类型。type为“nmeaMessageChange”，表示订阅GNSS NMEA信息上报。 | | callback | Callback<string> | 是 | 接收GNSS NMEA信息上报。 | + - 示例： ``` @@ -228,18 +264,23 @@ on(type: 'nmeaMessageChange', callback: Callback<string>) : void; ``` -## geolocation.off('nmeaMessageChange') +## geolocation.off('nmeaMessageChange')8+ off(type: 'nmeaMessageChange', callback?: Callback<string>) : void; 取消订阅GNSS NMEA信息上报事件。 +**需要权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Gnss + - 参数： | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | type | string | 是 | 设置事件类型。type为“nmeaMessageChange”，表示订阅GNSS NMEA信息上报。 | | callback | Callback<string> | 否 | 接收GNSS NMEA信息上报。 | + - 示例： ``` @@ -251,12 +292,16 @@ off(type: 'nmeaMessageChange', callback?: Callback<string>) : void; ``` -## geolocation.on('fenceStatusChange') +## geolocation.on('fenceStatusChange')8+ 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')8+ off(type: 'fenceStatusChange', request: GeofenceRequest, want: WantAgent) : void; 删除一个围栏，并取消订阅该围栏事件。 +**需要权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Geofence + - 参数： | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | @@ -383,6 +433,9 @@ getCurrentLocation(request: CurrentLocationRequest, callback: AsyncCallback<L 获取当前位置，使用callback回调异步返回结果。 +**需要权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core - 参数： | 参数名 | 类型 | 必填 | 说明 | @@ -409,6 +462,9 @@ getCurrentLocation(request?: CurrentLocationRequest) : Promise<Location> 获取当前位置，使用Promise方式异步返回结果。 +**需要权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core - 参数： | 参数名 | 类型 | 必填 | 说明 | @@ -420,6 +476,7 @@ getCurrentLocation(request?: CurrentLocationRequest) : Promise<Location> | -------- | -------- | | Promise<[Location](#location)> | 返回位置信息。 | + - 示例： ``` @@ -436,11 +493,16 @@ getLastLocation(callback: AsyncCallback<Location>) : void 获取上一次位置，使用callback回调异步返回结果。 +**需要权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + - 参数： | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | callback | AsyncCallback<[Location](#location)> | 是 | 用来接收上次位置的回调。 | + - 示例： ``` @@ -456,11 +518,16 @@ getLastLocation() : Promise<Location> 获取上一次位置，使用Promise方式异步返回结果。 +**需要权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + - 返回值： | 参数名 | 说明 | | -------- | -------- | | Promise<[Location](#location)> | 返回上次位置信息。 | + - 示例： ``` @@ -477,12 +544,16 @@ isLocationEnabled(callback: AsyncCallback<boolean>) : void 判断位置服务是否已经打开，使用callback回调异步返回结果。 +**需要权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core - 参数： | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | callback | AsyncCallback<boolean> | 是 | 用来接收位置服务状态的回调。 | + - 示例： ``` @@ -498,6 +569,10 @@ isLocationEnabled() : Promise<boolean> 判断位置服务是否已经开启，使用Promise方式异步返回结果。 +**需要权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + - 返回值： | 参数名 | 说明 | | -------- | -------- | @@ -519,12 +594,16 @@ requestEnableLocation(callback: AsyncCallback<boolean>) : void 请求打开位置服务，使用callback回调异步返回结果。 +**需要权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core - 参数： | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | callback | AsyncCallback<boolean> | 是 | 用来接收位置服务状态的回调。 | + - 示例： ``` @@ -540,11 +619,16 @@ requestEnableLocation() : Promise<boolean> 请求打开位置服务，使用Promise方式异步返回结果。 +**需要权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + - 返回值： | 参数名 | 说明 | | -------- | -------- | | Promise<boolean> | 返回位置服务是否可用。 | + - 示例： ``` @@ -554,17 +638,128 @@ requestEnableLocation() : Promise<boolean> ``` +## geolocation.enableLocation + +enableLocation(callback: AsyncCallback<boolean>) : void; + +打开位置服务，使用callback回调异步返回结果。 + +**系统API**：此接口为系统接口，三方应用不支持调用。 + +**需要权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + +- 参数： + | 参数名 | 类型 | 必填 | 说明 | + | -------- | -------- | -------- | -------- | + | callback | AsyncCallback<boolean> | 是 | 用来接收位置服务状态的回调。 | + + +- 示例： + + ``` + geolocation.enableLocation((err, data) => { + console.log('enableLocation: ' + err + " data: " + data); + }); + ``` + + +## geolocation.enableLocation + +enableLocation() : Promise<boolean> + +打开位置服务，使用Promise方式异步返回结果。 + +**系统API**：此接口为系统接口，三方应用不支持调用。 + +**需要权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + +- 返回值： + | 参数名 | 说明 | + | -------- | -------- | + | Promise<boolean> | 返回位置服务是否可用。 | + + +- 示例： + + ``` + geolocation.enableLocation().then((result) => { + console.log('promise, enableLocation: ' + result); + }); + ``` + +## geolocation.disableLocation + +disableLocation(callback: AsyncCallback<boolean>) : void; + +打开位置服务，使用callback回调异步返回结果。 + +**系统API**：此接口为系统接口，三方应用不支持调用。 + +**需要权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + +- 参数： + | 参数名 | 类型 | 必填 | 说明 | + | -------- | -------- | -------- | -------- | + | callback | AsyncCallback<boolean> | 是 | 用来接收位置服务状态的回调。 | + + +- 示例： + + ``` + geolocation.disableLocation((err, data) => { + console.log('disableLocation: ' + err + " data: " + data); + }); + ``` + + +## geolocation.disableLocation + +disableLocation() : Promise<boolean> + +打开位置服务，使用Promise方式异步返回结果。 + +**系统API**：此接口为系统接口，三方应用不支持调用。 + +**需要权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + +- 返回值： + | 参数名 | 说明 | + | -------- | -------- | + | Promise<boolean> | 返回位置服务是否可用。 | + + +- 示例： + + ``` + geolocation.disableLocation().then((result) => { + console.log('promise, disableLocation: ' + result); + }); + ``` + ## geolocation.isGeoServiceAvailable isGeoServiceAvailable(callback: AsyncCallback<boolean>) : void 判断（逆）地理编码服务状态，使用callback回调异步返回结果。 +**需要权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Geocoder + - 参数： | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | callback | AsyncCallback<boolean> | 是 | 用来接收地理编码服务状态的回调。 | + - 示例： ``` @@ -580,11 +775,16 @@ isGeoServiceAvailable() : Promise<boolean> 判断（逆）地理编码服务状态，使用Promise方式异步返回结果。 +**需要权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Geocoder + - 返回值： | 参数名 | 说明 | | -------- | -------- | | Promise<boolean> | 返回地理编码服务是否可用的状态。 | + - 示例： ``` @@ -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<Array<G 调用逆地理编码服务，将坐标转换为地理描述，使用Promise方式异步返回结果。 +**需要权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Geocoder + - 参数： | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | @@ -649,12 +857,17 @@ getAddressesFromLocationName(request: GeoCodeRequest, callback: AsyncCallback< 调用地理编码服务，将地理描述转换为具体坐标，使用callback回调异步返回结果。 +**需要权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Geocoder + - 参数： | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | request | [GeoCodeRequest](#geocoderequest) | 是 | 设置地理编码请求的相关参数。 | | callback | AsyncCallback<Array<[GeoAddress](#geoaddress)>> | 是 | 设置接收地理编码请求的回调参数。 | + - 示例： ``` @@ -671,6 +884,10 @@ getAddressesFromLocationName(request: GeoCodeRequest) : Promise<Array<GeoA 调用地理编码服务，将地理描述转换为具体坐标，使用Promise方式异步返回结果。 +**需要权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Geocoder + - 参数： | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | @@ -692,12 +909,16 @@ getAddressesFromLocationName(request: GeoCodeRequest) : Promise<Array<GeoA -## geolocation.getCachedGnssLocationsSize +## geolocation.getCachedGnssLocationsSize8+ getCachedGnssLocationsSize(callback: AsyncCallback<number>) : void; 获取GNSS芯片缓存位置的个数。 +**需要权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Gnss + - 参数： | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | @@ -712,12 +933,16 @@ getCachedGnssLocationsSize(callback: AsyncCallback<number>) : void; ``` -## geolocation.getCachedGnssLocationsSize +## geolocation.getCachedGnssLocationsSize8+ getCachedGnssLocationsSize() : Promise<number>; 获取GNSS芯片缓存位置的个数。 +**需要权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Gnss + - 返回值： | 参数名 | 说明 | | -------- | -------- | @@ -732,12 +957,16 @@ getCachedGnssLocationsSize() : Promise<number>; ``` -## geolocation.flushCachedGnssLocations +## geolocation.flushCachedGnssLocations8+ flushCachedGnssLocations(callback: AsyncCallback<boolean>) : void; 读取并清空GNSS芯片所有缓存位置。 +**需要权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Gnss + - 参数： | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | @@ -752,12 +981,16 @@ flushCachedGnssLocations(callback: AsyncCallback<boolean>) : void; ``` -## geolocation.flushCachedGnssLocations +## geolocation.flushCachedGnssLocations8+ flushCachedGnssLocations() : Promise<boolean>; 读取并清空GNSS芯片所有缓存位置。 +**需要权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Gnss + - 返回值： | 参数名 | 说明 | | -------- | -------- | @@ -772,12 +1005,16 @@ flushCachedGnssLocations() : Promise<boolean>; ``` -## geolocation.sendCommand +## geolocation.sendCommand8+ sendCommand(command: LocationCommand, callback: AsyncCallback<boolean>) : void; 给位置服务子系统的各个部件发送扩展命令。只有系统应用才能调用。 +**需要权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + - 参数： | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | @@ -794,12 +1031,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 +1061,18 @@ sendCommand(command: LocationCommand) : Promise<boolean>; ``` -## geolocation.isLocationPrivacyConfirmed +## geolocation.isLocationPrivacyConfirmed8+ isLocationPrivacyConfirmed(type : LocationPrivacyType, callback: AsyncCallback<boolean>) : void; 查询用户是否同意定位服务隐私申明，是否同意启用定位服务。只有系统应用才能调用。 +**系统API**：此接口为系统接口，三方应用不支持调用。 + +**需要权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + - 参数： | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | @@ -841,12 +1088,18 @@ isLocationPrivacyConfirmed(type : LocationPrivacyType, callback: AsyncCallback&l ``` -## geolocation.isLocationPrivacyConfirmed +## geolocation.isLocationPrivacyConfirmed8+ isLocationPrivacyConfirmed(type : LocationPrivacyType,) : Promise<boolean>; 查询用户是否同意定位服务隐私申明，是否同意启用定位服务。只有系统应用才能调用。 +**系统API**：此接口为系统接口，三方应用不支持调用。 + +**需要权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + - 参数： | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | @@ -866,12 +1119,18 @@ isLocationPrivacyConfirmed(type : LocationPrivacyType,) : Promise<boolean> ``` -## geolocation.setLocationPrivacyConfirmStatus +## geolocation.setLocationPrivacyConfirmStatus8+ setLocationPrivacyConfirmStatus(type : LocationPrivacyType, isConfirmed: boolean, callback: AsyncCallback<boolean>) : void; 设置用户勾选定位服务隐私申明的状态，记录用户是否同意启用定位服务。只有系统应用才能调用。 +**系统API**：此接口为系统接口，三方应用不支持调用。 + +**需要权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + - 参数： | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | @@ -888,12 +1147,18 @@ setLocationPrivacyConfirmStatus(type : LocationPrivacyType, isConfirmed: boolean ``` -## geolocation.setLocationPrivacyConfirmStatus +## geolocation.setLocationPrivacyConfirmStatus8+ setLocationPrivacyConfirmStatus(type : LocationPrivacyType, isConfirmed : boolean) : Promise<boolean>; 设置用户勾选定位服务隐私申明的状态，记录用户是否同意启用定位服务。只有系统应用才能调用。 +**系统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 +## SatelliteStatusInfo8+ 卫星状态信息。 +**需要权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Gnss + | 名称 | 参数类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | satellitesNumber | number | 是 | 表示卫星个数。 | @@ -1047,20 +1349,28 @@ setLocationPrivacyConfirmStatus(type : LocationPrivacyType, isConfirmed : boolea | carrierFrequencies | Array<number> | 是 | 表示载波频率。 | -## CachedGnssLocationsRequest +## CachedGnssLocationsRequest8+ 请求订阅GNSS缓存位置上报功能接口的配置参数。 +**需要权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Gnss + | 名称 | 参数类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | reportingPeriodSec | number | 是 | 表示GNSS缓存位置上报的周期，单位是毫秒。 | | wakeUpCacheQueueFull | boolean | 是 | true表示GNSS芯片底层缓存队列满之后会主动唤醒AP芯片，并把缓存位置上报给应用。
false表示GNSS芯片底层缓存队列满之后不会主动唤醒AP芯片，会把缓存位置直接丢弃。 | -## Geofence +## Geofence8+ GNSS围栏的配置参数。目前只支持圆形围栏。 +**需要权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Geofence + | 名称 | 参数类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | latitude | number | 是 | 表示纬度。 | @@ -1069,10 +1379,14 @@ GNSS围栏的配置参数。目前只支持圆形围栏。 | expiration | number | 是 | 围栏存活的时间，单位是毫秒。 | -## GeofenceRequest +## GeofenceRequest8+ 请求添加GNSS围栏消息中携带的参数，包括定位优先级、定位场景和围栏信息。 +**需要权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Geofence + | 名称 | 参数类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | priority | LocationRequestPriority | 是 | 表示位置信息优先级。 | @@ -1080,10 +1394,14 @@ GNSS围栏的配置参数。目前只支持圆形围栏。 | geofence | Geofence | 是 | 表示围栏信息。 | -## LocationPrivacyType +## LocationPrivacyType8+ 定位服务隐私协议类型。 +**需要权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + | 名称 | 默认值 | 说明 | | -------- | -------- | -------- | | OTHERS | 0 | 其他场景。 | @@ -1091,10 +1409,14 @@ GNSS围栏的配置参数。目前只支持圆形围栏。 | CORE_LOCATION | 2 | 开启网络定位时弹出的隐私协议。 | -## LocationCommand +## LocationCommand8+ 扩展命令结构体。 +**需要权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + | 名称 | 参数类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | scenario | LocationRequestScenario | 是 | 表示定位场景。 | @@ -1105,6 +1427,10 @@ GNSS围栏的配置参数。目前只支持圆形围栏。 位置信息类型。 +**需要权限**：ohos.permission.LOCATION + +**系统能力**：SystemCapability.Location.Location.Core + | 名称 | 参数类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | latitude | number | 是 | 表示纬度信息，正值表示北纬，负值表示南纬。 |