Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
4223d843
D
Docs
项目概览
OpenHarmony
/
Docs
1 年多 前同步成功
通知
159
Star
292
Fork
28
代码
文件
提交
分支
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看板
未验证
提交
4223d843
编写于
11月 29, 2022
作者:
O
openharmony_ci
提交者:
Gitee
11月 29, 2022
浏览文件
操作
浏览文件
下载
差异文件
!11964 修改md文档和d.ts定义不一致的问题
Merge pull request !11964 from 刘彬俊/master
上级
21301aaa
10caf9ac
变更
2
隐藏空白更改
内联
并排
Showing
2 changed file
with
67 addition
and
35 deletion
+67
-35
zh-cn/application-dev/reference/apis/js-apis-geoLocationManager.md
...lication-dev/reference/apis/js-apis-geoLocationManager.md
+20
-20
zh-cn/application-dev/reference/apis/js-apis-geolocation.md
zh-cn/application-dev/reference/apis/js-apis-geolocation.md
+47
-15
未找到文件。
zh-cn/application-dev/reference/apis/js-apis-geoLocationManager.md
浏览文件 @
4223d843
...
...
@@ -1063,7 +1063,7 @@ setReverseGeocodingMockInfo(mockInfos: Array<ReverseGeocodingMockInfo>): P
**系统能力**
:SystemCapability.Location.Location.Geocoder
| 名称 | 类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
-------- |
| locale | string | 是 | 是 | 指定位置描述信息的语言,“zh”代表中文,“en”代表英文。 |
| latitude | number | 是 | 是 | 表示纬度信息,正值表示北纬,负值表示南纬。 |
| longitude | number | 是 | 是 | 表示经度信息,正值表示东经,负值表示西经。 |
...
...
@@ -1077,9 +1077,9 @@ setReverseGeocodingMockInfo(mockInfos: Array<ReverseGeocodingMockInfo>): P
**系统能力**
:SystemCapability.Location.Location.Geocoder
| 名称 | 类型 | 可读|可写 | 说明 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
-------- |
| locale | string | 是 | 是 | 表示位置描述信息的语言,“zh”代表中文,“en”代表英文。 |
| description |
number
| 是 | 是 | 表示位置信息描述,如“上海市浦东新区xx路xx号”。 |
| description |
string
| 是 | 是 | 表示位置信息描述,如“上海市浦东新区xx路xx号”。 |
| maxItems | number | 是 | 是 | 表示返回位置信息的最大个数。 |
| minLatitude | number | 是 | 是 | 表示最小纬度信息,与下面三个参数一起,表示一个经纬度范围。 |
| minLongitude | number | 是 | 是 | 表示最小经度信息。 |
...
...
@@ -1094,7 +1094,7 @@ setReverseGeocodingMockInfo(mockInfos: Array<ReverseGeocodingMockInfo>): P
**系统能力**
:SystemCapability.Location.Location.Geocoder
| 名称 | 类型 | 可读|可写 | 说明 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
-------- |
| latitude | number | 是 | 否 | 表示纬度信息,正值表示北纬,负值表示南纬。 |
| longitude | number | 是 | 否 | 表示经度信息,正值表示东经,负值表是西经。 |
| locale | string | 是 | 否 | 表示位置描述信息的语言,“zh”代表中文,“en”代表英文。 |
...
...
@@ -1123,7 +1123,7 @@ setReverseGeocodingMockInfo(mockInfos: Array<ReverseGeocodingMockInfo>): P
**系统能力**
:SystemCapability.Location.Location.Core
| 名称 | 类型 | 可读|可写 | 说明 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
-------- |
| priority |
[
LocationRequestPriority
](
#locationrequestpriority
)
| 是 | 是 | 表示优先级信息。 |
| scenario |
[
LocationRequestScenario
](
#locationrequestscenario
)
| 是 | 是 | 表示场景信息。 |
| timeInterval | number | 是 | 是 | 表示上报位置信息的时间间隔。 |
...
...
@@ -1138,7 +1138,7 @@ setReverseGeocodingMockInfo(mockInfos: Array<ReverseGeocodingMockInfo>): P
**系统能力**
:SystemCapability.Location.Location.Core
| 名称 | 类型 | 可读|可写 | 说明 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
-------- |
| priority |
[
LocationRequestPriority
](
#locationrequestpriority
)
| 是 | 是 | 表示优先级信息。 |
| scenario |
[
LocationRequestScenario
](
#locationrequestscenario
)
| 是 | 是 | 表示场景信息。 |
| maxAccuracy | number | 是 | 是| 表示精度信息,单位是米。仅在精确位置功能场景下有效,模糊位置功能生效场景下该字段无意义。 |
...
...
@@ -1152,7 +1152,7 @@ setReverseGeocodingMockInfo(mockInfos: Array<ReverseGeocodingMockInfo>): P
**系统能力**
:SystemCapability.Location.Location.Gnss
| 名称 | 类型 | 可读|可写 | 说明 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
-------- |
| satellitesNumber | number | 是 | 否 | 表示卫星个数。 |
| satelliteIds | Array
<
number
>
| 是 | 否 | 表示每个卫星的ID,数组类型。 |
| carrierToNoiseDensitys | Array
<
number
>
| 是 | 否 | 表示载波噪声功率谱密度比,即cn0。 |
...
...
@@ -1168,7 +1168,7 @@ setReverseGeocodingMockInfo(mockInfos: Array<ReverseGeocodingMockInfo>): P
**系统能力**
:SystemCapability.Location.Location.Gnss
| 名称 | 类型 | 可读|可写 | 说明 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
-------- |
| reportingPeriodSec | number | 是 | 是 | 表示GNSS缓存位置上报的周期,单位是毫秒。 |
| wakeUpCacheQueueFull | boolean | 是 | 是 | true表示GNSS芯片底层缓存队列满之后会主动唤醒AP芯片,并把缓存位置上报给应用。
<br/>
false表示GNSS芯片底层缓存队列满之后不会主动唤醒AP芯片,会把缓存位置直接丢弃。 |
...
...
@@ -1179,12 +1179,12 @@ GNSS围栏的配置参数。目前只支持圆形围栏。
**系统能力**
:SystemCapability.Location.Location.Geofence
| 名称 |
参数类型 | 必填
| 说明 |
| -------- | -------- | -------- | -------- |
| latitude | number | 是 | 表示纬度。 |
| longitude | number | 是 | 表示经度。 |
| radius | number | 是 | 表示圆形围栏的半径。 |
| expiration | number | 是 | 围栏存活的时间,单位是毫秒。 |
| 名称 |
类型 | 可读|可写
| 说明 |
| -------- | -------- | -------- | -------- |
-------- |
| latitude | number | 是 |
是 |
表示纬度。 |
| longitude | number | 是 |
是 |
表示经度。 |
| radius | number | 是 |
是 |
表示圆形围栏的半径。 |
| expiration | number | 是 |
是 |
围栏存活的时间,单位是毫秒。 |
## GeofenceRequest
...
...
@@ -1194,7 +1194,7 @@ GNSS围栏的配置参数。目前只支持圆形围栏。
**系统能力**
:SystemCapability.Location.Location.Geofence
| 名称 | 类型 | 可读|可写 | 说明 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
-------- |
| priority |
[
LocationRequestPriority
](
#locationrequestpriority
)
| 是 | 是 | 表示位置信息优先级。 |
| scenario |
[
LocationRequestScenario
](
#locationrequestscenario
)
| 是 | 是 | 表示定位场景。 |
| geofence |
[
Geofence
](
#geofence
)
| 是 | 是 | 表示围栏信息。 |
...
...
@@ -1220,7 +1220,7 @@ GNSS围栏的配置参数。目前只支持圆形围栏。
**系统能力**
:SystemCapability.Location.Location.Core
| 名称 | 类型 | 可读|可写 | 说明 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
-------- |
| scenario |
[
LocationRequestScenario
](
#locationrequestscenario
)
| 是 | 是 | 表示定位场景。 |
| command | string | 是 | 是 | 扩展命令字符串。 |
...
...
@@ -1232,7 +1232,7 @@ GNSS围栏的配置参数。目前只支持圆形围栏。
**系统能力**
:SystemCapability.Location.Location.Core
| 名称 | 类型 | 可读|可写 | 说明 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
-------- |
| latitude | number| 是 | 否 | 表示纬度信息,正值表示北纬,负值表示南纬。 |
| longitude | number| 是 | 否 | 表示经度信息,正值表示东经,负值表是西经。 |
| altitude | number | 是 | 否 | 表示高度信息,单位米。 |
...
...
@@ -1255,7 +1255,7 @@ GNSS围栏的配置参数。目前只支持圆形围栏。
**系统API**
:此接口为系统接口,三方应用不支持调用。
| 名称 | 类型 | 可读|可写 | 说明 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
-------- |
| location |
[
ReverseGeoCodeRequest
](
#reversegeocoderequest
)
| 是 | 是 | 表示经纬度信息。 |
| geoAddress |
[
GeoAddress
](
#geoaddress
)
| 是 | 是 |表示地名信息。 |
...
...
@@ -1269,7 +1269,7 @@ GNSS围栏的配置参数。目前只支持圆形围栏。
**系统API**
:此接口为系统接口,三方应用不支持调用。
| 名称 | 类型 | 可读|可写 | 说明 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
-------- |
| timeInterval | number | 是 | 是 | 表示模拟位置上报的时间间隔,单位是秒。 |
| locations | Array
<
Location
>
| 是 | 是 | 表示模拟位置数组。 |
...
...
@@ -1281,7 +1281,7 @@ GNSS围栏的配置参数。目前只支持圆形围栏。
**系统能力**
:SystemCapability.Location.Location.Core
| 名称 | 类型 | 可读|可写 | 说明 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
-------- |
| country | string | 是 | 否 | 表示国家码字符串。 |
| type |
[
CountryCodeType
](
#countrycodetype
)
| 是 | 否 | 表示国家码信息来源。 |
...
...
zh-cn/application-dev/reference/apis/js-apis-geolocation.md
浏览文件 @
4223d843
...
...
@@ -179,7 +179,7 @@ on(type: 'cachedGnssLocationsReporting', request: CachedGnssLocationsRequest, ca
| -------- | -------- | -------- | -------- |
| type | string | 是 | 设置事件类型。type为“cachedGnssLocationsReporting”,表示GNSS缓存定位结果上报。 |
| request |
[
CachedGnssLocationsRequest
](
#cachedgnsslocationsrequest
)
| 是 | GNSS缓存功能配置参数 |
| callback | Callback
<
boolean
>
| 是 | 接收GNSS缓存位置上报。 |
| callback | Callback
<
Array
<
[Location](#location)
>
>
| 是 | 接收GNSS缓存位置上报。 |
**示例**
...
...
@@ -209,7 +209,7 @@ off(type: 'cachedGnssLocationsReporting', callback?: Callback<Array<Locati
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| type | string | 是 | 设置事件类型。type为“cachedGnssLocationsReporting”,表示GNSS缓存定位结果上报。 |
| callback | Callback
<
boolean
>
| 否 | 需要取消订阅的回调函数。若无此参数,则取消当前类型的所有订阅。 |
| callback | Callback
<
Array
<
[Location](#location)
>
>
| 否 | 需要取消订阅的回调函数。若无此参数,则取消当前类型的所有订阅。 |
**示例**
...
...
@@ -447,7 +447,7 @@ getCurrentLocation(request: CurrentLocationRequest, callback: AsyncCallback<L
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| request |
[
CurrentLocationRequest
](
#currentlocationrequest
)
|
否
| 设置位置请求参数。 |
| request |
[
CurrentLocationRequest
](
#currentlocationrequest
)
|
是
| 设置位置请求参数。 |
| callback | AsyncCallback
<
[Location](#location)
>
| 是 | 用来接收位置信息的回调。 |
**示例**
...
...
@@ -464,6 +464,38 @@ getCurrentLocation(request: CurrentLocationRequest, callback: AsyncCallback<L
}
};
geolocation
.
getCurrentLocation
(
requestInfo
,
locationChange
);
```
## geolocation.getCurrentLocation
getCurrentLocation(callback: AsyncCallback
<
Location
>
): void
获取当前位置,使用callback回调异步返回结果。
**需要权限**
:ohos.permission.LOCATION
**系统能力**
:SystemCapability.Location.Location.Core
**参数**
:
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| callback | AsyncCallback
<
[Location](#location)
>
| 是 | 用来接收位置信息的回调。 |
**示例**
```
ts
import
geolocation
from
'
@ohos.geolocation
'
;
var
locationChange
=
(
err
,
location
)
=>
{
if
(
err
)
{
console
.
log
(
'
locationChanger: err=
'
+
JSON
.
stringify
(
err
));
}
if
(
location
)
{
console
.
log
(
'
locationChanger: location=
'
+
JSON
.
stringify
(
location
));
}
};
geolocation
.
getCurrentLocation
(
locationChange
);
```
...
...
@@ -1230,7 +1262,7 @@ sendCommand(command: LocationCommand): Promise<boolean>;
**系统能力**
:SystemCapability.Location.Location.Geocoder
| 名称 | 类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
-------- |
| locale | string | 是 | 是 | 指定位置描述信息的语言,“zh”代表中文,“en”代表英文。 |
| latitude | number | 是 | 是 | 表示纬度信息,正值表示北纬,负值表示南纬。 |
| longitude | number | 是 | 是 | 表示经度信息,正值表示东经,负值表示西经。 |
...
...
@@ -1246,9 +1278,9 @@ sendCommand(command: LocationCommand): Promise<boolean>;
**系统能力**
:SystemCapability.Location.Location.Geocoder
| 名称 | 类型 | 可读|可写 | 说明 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
-------- |
| locale | string | 是 | 是 | 表示位置描述信息的语言,“zh”代表中文,“en”代表英文。 |
| description |
number
| 是 | 是 | 表示位置信息描述,如“上海市浦东新区xx路xx号”。 |
| description |
string
| 是 | 是 | 表示位置信息描述,如“上海市浦东新区xx路xx号”。 |
| maxItems | number | 是 | 是 | 表示返回位置信息的最大个数。 |
| minLatitude | number | 是 | 是 | 表示最小纬度信息,与下面三个参数一起,表示一个经纬度范围。 |
| minLongitude | number | 是 | 是 | 表示最小经度信息。 |
...
...
@@ -1265,7 +1297,7 @@ sendCommand(command: LocationCommand): Promise<boolean>;
**系统能力**
:SystemCapability.Location.Location.Geocoder
| 名称 | 类型 | 可读|可写 | 说明 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
-------- |
| latitude
<sup>
7+
</sup>
| number | 是 | 否 | 表示纬度信息,正值表示北纬,负值表示南纬。 |
| longitude
<sup>
7+
</sup>
| number | 是 | 否 | 表示经度信息,正值表示东经,负值表是西经。 |
| locale
<sup>
7+
</sup>
| string | 是 | 否 | 表示位置描述信息的语言,“zh”代表中文,“en”代表英文。 |
...
...
@@ -1295,7 +1327,7 @@ sendCommand(command: LocationCommand): Promise<boolean>;
**系统能力**
:SystemCapability.Location.Location.Core
| 名称 | 类型 | 可读|可写 | 说明 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
-------- |
| priority |
[
LocationRequestPriority
](
#locationrequestpriority
)
| 是 | 是 | 表示优先级信息。 |
| scenario |
[
LocationRequestScenario
](
#locationrequestscenario
)
| 是 | 是 | 表示场景信息。 |
| timeInterval | number | 是 | 是 | 表示上报位置信息的时间间隔。 |
...
...
@@ -1312,7 +1344,7 @@ sendCommand(command: LocationCommand): Promise<boolean>;
**系统能力**
:SystemCapability.Location.Location.Core
| 名称 | 类型 | 可读|可写 | 说明 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
-------- |
| priority |
[
LocationRequestPriority
](
#locationrequestpriority
)
| 是 | 是 | 表示优先级信息。 |
| scenario |
[
LocationRequestScenario
](
#locationrequestscenario
)
| 是 | 是 | 表示场景信息。 |
| maxAccuracy | number | 是 | 是| 表示精度信息,单位是米。仅在精确位置功能场景下有效,模糊位置功能生效场景下该字段无意义。 |
...
...
@@ -1328,7 +1360,7 @@ sendCommand(command: LocationCommand): Promise<boolean>;
**系统能力**
:SystemCapability.Location.Location.Gnss
| 名称 | 类型 | 可读|可写 | 说明 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
-------- |
| satellitesNumber | number | 是 | 否 | 表示卫星个数。 |
| satelliteIds | Array
<
number
>
| 是 | 否 | 表示每个卫星的ID,数组类型。 |
| carrierToNoiseDensitys | Array
<
number
>
| 是 | 否 | 表示载波噪声功率谱密度比,即cn0。 |
...
...
@@ -1346,7 +1378,7 @@ sendCommand(command: LocationCommand): Promise<boolean>;
**系统能力**
:SystemCapability.Location.Location.Gnss
| 名称 | 类型 | 可读|可写 | 说明 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
-------- |
| reportingPeriodSec | number | 是 | 是 | 表示GNSS缓存位置上报的周期,单位是毫秒。 |
| wakeUpCacheQueueFull | boolean | 是 | 是 | true表示GNSS芯片底层缓存队列满之后会主动唤醒AP芯片,并把缓存位置上报给应用。
<br/>
false表示GNSS芯片底层缓存队列满之后不会主动唤醒AP芯片,会把缓存位置直接丢弃。 |
...
...
@@ -1360,7 +1392,7 @@ GNSS围栏的配置参数。目前只支持圆形围栏。
**系统能力**
:SystemCapability.Location.Location.Geofence
| 名称 | 类型 | 可读|可写 | 说明 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
-------- |
| latitude | number | 是 | 是 | 表示纬度。 |
| longitude | number | 是 | 是 | 表示经度。 |
| radius | number | 是 | 是 | 表示圆形围栏的半径。 |
...
...
@@ -1376,7 +1408,7 @@ GNSS围栏的配置参数。目前只支持圆形围栏。
**系统能力**
:SystemCapability.Location.Location.Geofence
| 名称 | 类型 | 可读|可写 | 说明 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
-------- |
| priority |
[
LocationRequestPriority
](
#locationrequestpriority
)
| 是 | 是 | 表示位置信息优先级。 |
| scenario |
[
LocationRequestScenario
](
#locationrequestscenario
)
| 是 | 是 | 表示定位场景。 |
| geofence |
[
Geofence
](
#geofence
)
| 是 | 是 | 表示围栏信息。 |
...
...
@@ -1406,7 +1438,7 @@ GNSS围栏的配置参数。目前只支持圆形围栏。
**系统能力**
:SystemCapability.Location.Location.Core
| 名称 | 类型 | 可读|可写 | 说明 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
-------- |
| scenario |
[
LocationRequestScenario
](
#locationrequestscenario
)
| 是 | 是 | 表示定位场景。 |
| command | string | 是 | 是 | 扩展命令字符串。 |
...
...
@@ -1420,7 +1452,7 @@ GNSS围栏的配置参数。目前只支持圆形围栏。
**系统能力**
:SystemCapability.Location.Location.Core
| 名称 | 类型 | 可读|可写 | 说明 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
-------- |
| latitude
<sup>
7+
</sup>
| number | 是 | 否 | 表示纬度信息,正值表示北纬,负值表示南纬。 |
| longitude
<sup>
7+
</sup>
| number | 是 | 否 | 表示经度信息,正值表示东经,负值表是西经。 |
| altitude
<sup>
7+
</sup>
| number | 是 | 否 | 表示高度信息,单位米。 |
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录