Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
Tonvia
Docs
提交
49083293
D
Docs
项目概览
Tonvia
/
Docs
与 Fork 源项目一致
Fork自
OpenHarmony / Docs
通知
1
Star
0
Fork
0
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
体验新版 GitCode,发现更多精彩内容 >>
未验证
提交
49083293
编写于
3月 14, 2023
作者:
O
openharmony_ci
提交者:
Gitee
3月 14, 2023
浏览文件
操作
浏览文件
下载
差异文件
!15694 doc一致性整改
Merge pull request !15694 from 褚晨辉/doc-fix-br
上级
a1f027d4
73da284d
变更
2
隐藏空白更改
内联
并排
Showing
2 changed file
with
114 addition
and
63 deletion
+114
-63
zh-cn/application-dev/reference/apis/js-apis-geoLocationManager.md
...lication-dev/reference/apis/js-apis-geoLocationManager.md
+2
-4
zh-cn/application-dev/reference/apis/js-apis-system-location.md
...application-dev/reference/apis/js-apis-system-location.md
+112
-59
未找到文件。
zh-cn/application-dev/reference/apis/js-apis-geoLocationManager.md
浏览文件 @
49083293
...
...
@@ -662,7 +662,7 @@ on(type: 'nmeaMessage', callback: Callback<string>): void;
订阅GNSS NMEA信息上报事件。
**需要权限**
:ohos.permission.LOCATION
and
ohos.permission.APPROXIMATELY_LOCATION
**需要权限**
:ohos.permission.LOCATION
和
ohos.permission.APPROXIMATELY_LOCATION
**系统能力**
:SystemCapability.Location.Location.Gnss
...
...
@@ -705,7 +705,7 @@ off(type: 'nmeaMessage', callback?: Callback<string>): void;
取消订阅GNSS NMEA信息上报事件。
**需要权限**
:ohos.permission.LOCATION
and
ohos.permission.APPROXIMATELY_LOCATION
**需要权限**
:ohos.permission.LOCATION
和
ohos.permission.APPROXIMATELY_LOCATION
**系统能力**
:SystemCapability.Location.Location.Gnss
...
...
@@ -882,7 +882,6 @@ on(type: 'countryCodeChange', callback: Callback<CountryCode>): void;
| 错误码ID | 错误信息 |
| -------- | ---------------------------------------- |
|3301000 | Location service is unavailable. |
|3301100 | The location switch is off. |
|3301500 | Failed to query the area information. |
...
...
@@ -924,7 +923,6 @@ off(type: 'countryCodeChange', callback?: Callback<CountryCode>): void;
| 错误码ID | 错误信息 |
| -------- | ---------------------------------------- |
|3301000 | Location service is unavailable. |
|3301100 | The location switch is off. |
|3301500 | Failed to query the area information. |
**示例**
...
...
zh-cn/application-dev/reference/apis/js-apis-system-location.md
浏览文件 @
49083293
...
...
@@ -21,44 +21,22 @@ ohos.permission.LOCATION
## geolocation.getLocation<sup>(deprecated)</sup>
getLocation(
Object
): void
getLocation(
options?: GetLocationOption
): void
获取设备的地理位置。
> **说明:**<br/>
> 从API version 9开始废弃,建议使用[geoLocationManager.getCurrentLocation](js-apis-geoLocationManager.md#geolocationmanagergetcurrentlocation)替代。
**需要权限**
:ohos.permission.LOCATION
**系统能力:**
SystemCapability.Location.Location.Lite
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| timeout | number | 否 | 超时时间,单位为ms,默认值为30000。
<br/>
设置超时,是为了防止出现权限被系统拒绝、定位信号弱或者定位设置不当,导致请求阻塞的情况。超时后会使用fail回调函数。
<br/>
取值范围为32位正整数。如果设置值小于等于0,系统按默认值处理。 |
| coordType | string | 否 | 坐标系的类型,可通过getSupportedCoordTypes获取可选值,缺省值为wgs84。 |
| success | Function | 否 | 接口调用成功的回调函数。 |
| fail | Function | 否 | 接口调用失败的回调函数。 |
| complete | Function | 否 | 接口调用结束的回调函数。 |
success返回值:
| 参数名 | 类型 | 说明 |
| -------- | -------- | -------- |
| longitude | number | 设备位置信息:经度。 |
| latitude | number | 设备位置信息:纬度。 |
| altitude | number | 设备位置信息:海拔。 |
| accuracy | number | 设备位置信息:精确度。 |
| time | number | 设备位置信息:时间。 |
fail返回错误代码:
| 错误码 | 说明 |
| -------- | -------- |
| 601 | 获取定位权限失败,失败原因:用户拒绝。 |
| 602 | 权限未声明。 |
| 800 | 超时,失败原因:网络状况不佳或GNSS不可用。 |
| 801 | 系统位置开关未打开。 |
| 802 | 该次调用结果未返回前接口又被重新调用,该次调用失败返回错误码。 |
| options |
[
GetLocationOption
](
#getlocationoptiondeprecated
)
| 否 | 单次定位请求的配置参数。 |
**示例:**
...
...
@@ -80,7 +58,7 @@ export default {
## geolocation.getLocationType<sup>(deprecated)</sup>
getLocationType(
Object
): void
getLocationType(
options?: GetLocationTypeOption
): void
获取当前设备支持的定位类型。
...
...
@@ -93,15 +71,7 @@ getLocationType(Object): void
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| success | Function | 否 | 接口调用成功的回调函数。 |
| fail | Function | 否 | 接口调用失败的回调函数。 |
| complete | Function | 否 | 接口调用结束的回调函数。 |
success返回值:
| 参数名 | 类型 | 说明 |
| -------- | -------- | -------- |
| types | Array
<
string
>
| 可选的定位类型['gps',
'network']。 |
| options |
[
GetLocationTypeOption
](
#getlocationtypeoptiondeprecated
)
| 否 | 回调函数,用于接收查询结果,或者接收查询失败的结果。 |
**示例:**
...
...
@@ -123,40 +93,22 @@ export default {
## geolocation.subscribe<sup>(deprecated)</sup>
subscribe(
Object
): void
subscribe(
options: SubscribeLocationOption
): void
订阅设备的地理位置信息。多次调用的话,只有最后一次的调用生效。
> **说明:**<br/>
> 从API version 9开始废弃,建议使用[geoLocationManager.on('locationChange')](js-apis-geoLocationManager.md#geolocationmanageronlocationchange)替代。
**需要权限**
:ohos.permission.LOCATION
**系统能力:**
SystemCapability.Location.Location.Lite
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| coordType | string | 否 | 坐标系的类型,可通过getSupportedCoordTypes获取可选值,默认值为wgs84。 |
| success | Function | 是 | 位置信息发生变化的回调函数。 |
| fail | Function | 否 | 接口调用失败的回调函数。 |
success返回值:
| 参数名 | 类型 | 说明 |
| -------- | -------- | -------- |
| longitude | number | 设备位置信息:经度。 |
| latitude | number | 设备位置信息:纬度。 |
| altitude | number | 设备位置信息:海拔。 |
| accuracy | number | 设备位置信息:精确度。 |
| time | number | 设备位置信息:时间。 |
fail返回错误代码:
| 错误码 | 说明 |
| -------- | -------- |
| 601 | 获取定位权限失败,失败原因:用户拒绝。 |
| 602 | 权限未声明。 |
| 801 | 系统位置开关未打开。 |
| options |
[
SubscribeLocationOption
](
#subscribelocationoptiondeprecated
)
| 是 | 持续定位的配置参数。 |
**示例:**
...
...
@@ -185,6 +137,8 @@ unsubscribe(): void
> **说明:**<br/>
> 从API version 9开始废弃,建议使用[geoLocationManager.off('locationChange')](js-apis-geoLocationManager.md#geolocationmanagerofflocationchange)替代。
**需要权限**
:ohos.permission.LOCATION
**系统能力:**
SystemCapability.Location.Location.Lite
**示例:**
...
...
@@ -223,4 +177,103 @@ export default {
var types = geolocation.getSupportedCoordTypes();
},
}
```
\ No newline at end of file
```
## GetLocationOption<sup>(deprecated)</sup>
单次定位请求的配置参数。
> **说明:**<br/>
> 从API version 9开始废弃,建议使用[geoLocationManager.CurrentLocationRequest](js-apis-geoLocationManager.md#CurrentLocationRequest)替代。
**需要权限**
:ohos.permission.LOCATION
**系统能力**
:SystemCapability.Location.Location.Lite
| 名称 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| timeout | number | 否 | 超时时间,单位为ms,默认值为30000。
<br/>
设置超时,是为了防止出现权限被系统拒绝、定位信号弱或者定位设置不当,导致请求阻塞的情况。超时后会使用fail回调函数。
<br/>
取值范围为32位正整数。如果设置值小于等于0,系统按默认值处理。 |
| coordType | string | 否 | 坐标系的类型,可通过getSupportedCoordTypes获取可选值,缺省值为wgs84。 |
| success | (data:
[
GeolocationResponse
](
#geolocationresponsedeprecated
)
) => void | 否 | 接口调用成功的回调函数。 |
| fail | (data: string, code: number) => void | 否 | 接口调用失败的回调函数。data为错误信息,code为错误码。 |
| complete | () => void | 否 | 接口调用结束的回调函数。 |
fail返回错误代码:
| 错误码 | 说明 |
| -------- | -------- |
| 601 | 获取定位权限失败,失败原因:用户拒绝。 |
| 602 | 权限未声明。 |
| 800 | 超时,失败原因:网络状况不佳或GNSS不可用。 |
| 801 | 系统位置开关未打开。 |
| 802 | 该次调用结果未返回前接口又被重新调用,该次调用失败返回错误码。 |
## GeolocationResponse<sup>(deprecated)</sup>
位置信息,包含经度、纬度、定位精度等信息。
> **说明:**<br/>
> 从API version 9开始废弃,建议使用[geoLocationManager.Location](js-apis-geoLocationManager.md#location)替代。
**系统能力**
:SystemCapability.Location.Location.Lite
| 名称 | 类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- |
| longitude | number | 是 | 否 | 设备位置信息:经度。 |
| latitude | number | 是 | 否 | 设备位置信息:纬度。 |
| altitude | number | 是 | 否 | 设备位置信息:海拔。 |
| accuracy | number | 是 | 否 | 设备位置信息:精确度。 |
| time | number | 是 | 否 | 设备位置信息:时间。 |
## GetLocationTypeOption<sup>(deprecated)</sup>
查询定位类型接口的入参,用于存放回调函数,在查询成功或者失败时接收查询结果。
> **说明:**<br/>
> 从API version 9开始废弃。
**系统能力**
:SystemCapability.Location.Location.Lite
| 名称 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| success | (data:
[
GetLocationTypeResponse
](
#getlocationtyperesponsedeprecated
)
) => void | 否 | 接口调用成功的回调函数。 |
| fail | (data: string, code: number) => void | 否 | 接口调用失败的回调函数。 |
| complete | () => void | 否 | 接口调用结束的回调函数。 |
## GetLocationTypeResponse<sup>(deprecated)</sup>
当前设备支持的定位类型列表
> **说明:**<br/>
> 从API version 9开始废弃。
**系统能力**
:SystemCapability.Location.Location.Lite
| 名称 | 类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- |
| types | Array
<
string
>
| 是 | 否 | 可选的定位类型['gps',
'network']。 |
## SubscribeLocationOption<sup>(deprecated)</sup>
持续定位请求的配置参数。
> **说明:**<br/>
> 从API version 9开始废弃,建议使用[geoLocationManager.CurrentLocationRequest](js-apis-geoLocationManager.md#locationrequest)替代。
**需要权限**
:ohos.permission.LOCATION
**系统能力**
:SystemCapability.Location.Location.Lite
| 名称 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| coordType | string | 否 | 坐标系的类型,可通过getSupportedCoordTypes获取可选值,默认值为wgs84。 |
| success | (data:
[
GeolocationResponse
](
#geolocationresponsedeprecated
)
) => void | 是 | 位置信息发生变化的回调函数。 |
| fail | (data: string, code: number) => void | 否 | 接口调用失败的回调函数。 |
fail返回错误代码:
| 错误码 | 说明 |
| -------- | -------- |
| 601 | 获取定位权限失败,失败原因:用户拒绝。 |
| 602 | 权限未声明。 |
| 801 | 系统位置开关未打开。 |
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录