Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
1f9eb539
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看板
提交
1f9eb539
编写于
7月 19, 2022
作者:
张
张森
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
'修改redeme提高可读性张森851518232@qq.com'
Signed-off-by:
N
张森
<
851518232@qq.com
>
上级
59588cb3
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
16 addition
and
16 deletion
+16
-16
zh-cn/readme/位置服务子系统.md
zh-cn/readme/位置服务子系统.md
+16
-16
未找到文件。
zh-cn/readme/位置服务子系统.md
浏览文件 @
1f9eb539
...
...
@@ -15,9 +15,9 @@
当用户处于这些丰富的使用场景中时,系统的位置能力可以提供实时准确的位置数据。对于开发者,设计基于位置体验的服务,也可以使应用的使用体验更贴近每个用户。
当应用在实现基于设备位置的功能时,如:驾车导航,记录运动轨迹等,可以调用该模块的API接口,完成位置信息的获取
当应用在实现基于设备位置的功能时,如:驾车导航,记录运动轨迹等,可以调用该模块的API接口,完成位置信息的获取
。
基本概念
**基本概念**
位置能力用于确定用户设备在哪里,系统使用位置坐标标示设备的位置,并用多种定位技术提供服务,如GNSS定位、基站定位、WLAN/蓝牙定位(基站定位、WLAN/蓝牙定位后续统称“网络定位技术”)。通过这些定位技术,无论用户设备在室内或是户外,都可以准确地确定设备位置。
...
...
@@ -127,7 +127,7 @@
开发者可以在应用config.json文件中声明所需要的权限,示例代码如下:
```
{
"module": {
...
...
@@ -148,7 +148,7 @@
配置字段详细说明见。
2.
导入geolocation模块,所有与基础定位能力相关的功能API,都是通过该模块提供的。
```
import geolocation from '@ohos.geolocation';
```
...
...
@@ -159,7 +159,7 @@
为了面向开发者提供贴近其使用场景的API使用方式,系统定义了几种常见的位置能力使用场景,并针对使用场景做了适当的优化处理,应用可以直接匹配使用,简化开发复杂度。系统当前支持场景如下表所示。
```
export enum LocationRequestScenario {
UNSET = 0x300,
...
...
@@ -171,7 +171,7 @@
}
```
**表2**
定位场景类型说明
| 场景名称 | 常量定义 | 说明 |
...
...
@@ -183,7 +183,7 @@
| 无功耗场景 | NO_POWER | 无功耗场景,适用于不需要主动启动定位业务。系统在响应其他应用启动定位业务并上报位置结果时,会同时向请求此场景的应用程序上报定位结果,当前的应用程序不产生定位功耗。
<br/>
此场景默认以最小1秒间隔上报定位结果,并且应用需要申请ohos.permission.LOCATION权限,同时获得用户授权。 |
以导航场景为例,实例化方式如下:
```
var requestInfo = {'scenario': 0x301, 'timeInterval': 0, 'distanceInterval': 0, 'maxAccuracy': 0};
```
...
...
@@ -192,7 +192,7 @@
如果定义的现有场景类型不能满足所需的开发场景,系统提供了基本的定位优先级策略类型。
```
export enum LocationRequestPriority {
UNSET = 0x200,
...
...
@@ -202,7 +202,7 @@
}
```
**表3**
定位优先级策略类型说明:
| 策略类型 | 常量定义 | 说明 |
...
...
@@ -212,7 +212,7 @@
| 低功耗定位优先策略 | LOW_POWER | 低功耗定位优先策略主要使用基站定位和WLAN、蓝牙定位技术,也可以同时提供室内和户外场景下的位置服务,因为其依赖周边基站、可见WLAN、蓝牙设备的分布情况,定位结果的精度波动范围较大,如果对定位结果精度要求不高,或者使用场景多在有基站、可见WLAN、蓝牙设备高密度分布的情况下,推荐使用,可以有效节省设备功耗。
<br/>
应用至少申请ohos.permission.LOCATION权限,同时获得用户授权。 |
以定位精度优先策略为例,实例化方式如下:
```
var requestInfo = {'priority': 0x201, 'timeInterval': 0, 'distanceInterval': 0, 'maxAccuracy': 0};
```
...
...
@@ -227,19 +227,19 @@
```
5.
启动定位。
```
geolocation.on('locationChange', requestInfo, locationChange);
```
6.
(可选)结束定位。
```
geolocation.off('locationChange', locationChange);
```
如果应用使用场景不需要实时的设备位置,可以获取系统缓存的最近一次历史定位结果。
```
geolocation.getLastLocation((data) => {
console.log('getLastLocation: data: ' + JSON.stringify(data));
...
...
@@ -256,14 +256,14 @@
> GeoConvert需要访问后端服务,请确保设备联网,以进行信息获取。
1.
导入geolocation模块,所有与(逆)地理编码转化能力相关的功能API,都是通过该模块提供的。
```
import geolocation from '@ohos.geolocation';
```
2.
获取转化结果。
-
调用getAddressesFromLocation,坐标转化地理位置信息。
```
var reverseGeocodeRequest = {"latitude": 31.12, "longitude": 121.11, "maxItems": 1};
geolocation.getAddressesFromLocation(reverseGeocodeRequest, (data) => {
...
...
@@ -273,7 +273,7 @@
参考接口API说明,应用可以获得与此坐标匹配的GeoAddress列表,应用可以根据实际使用需求,读取相应的参数数据。
-
调用getAddressesFromLocationName位置描述转化坐标。
```
var geocodeRequest = {"description": "上海市浦东新区xx路xx号", "maxItems": 1};
geolocation.getAddressesFromLocationName(geocodeRequest, (data) => {
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录