@awarns/geolocation

本模块包含定期获取手机地理位置的任务。

该插件作为 nativescript-context-apis 插件（同作者）的包装，提供 GNSS 位置获取任务。按需获取手机位置，即使在后台也可以。

使用以下命令行指令安装插件

ns plugin add @awarns/geolocation

用法

安装和设置此插件后，您将可以访问两个不同的任务来获取手机位置。结果将是一个 地理位置 记录，如下所述。

任务

注意：所有任务都需要 精确位置权限和活动位置服务 才能执行。每个任务将在框架初始化期间自动请求缺少的部分

获取单个 GNSS 位置

要为此任务注册使用，您只需将其导入并在应用程序的任务列表中调用其生成函数即可

import { Task } from '@awarns/core/tasks';
import { acquirePhoneGeolocationTask } from '@awarns/geolocation';

export const demoTasks: Array<Task> = [
      acquirePhoneGeolocationTask(/* optional */ { bestOf: 3, timeout: 10000 }),
];

任务生成参数

任务输出事件

• geolocationAcquired

示例用法在应用程序任务图中

on(
  'startEvent',
  run('acquirePhoneGeolocation')
    .every(1, 'minutes')
    .cancelOn('stopEvent')
);

on('geolocationAcquired', run('writeRecords'));

注意：要使用 writeRecords，任务持久化包必须已安装和配置。请参阅 持久化包文档。

批量获取 GNSS 位置

要为此任务注册使用，您只需将其导入并在应用程序的任务列表中调用其生成函数即可

import { Task } from '@awarns/core/tasks';
import { acquireMultiplePhoneGeolocationTask } from '@awarns/geolocation';

export const demoTasks: Array<Task> = [
  acquireMultiplePhoneGeolocationTask(/* optional */ { bestOf: 1, timeout: 15000 }),
];

任务生成参数

任务输出事件

• geolocationAcquired

示例用法在应用程序任务图中

on(
  'startEvent',
  run('acquireMultiplePhoneGeolocation', { maxInterval: 10000 /* (Optional) Maximun interval between location acquisitions (this includes the time it takes to obtain all the locations in a reporting subset, if bestOf > 1), unlimited by default */ })
    .every(1, 'minutes')
    .cancelOn('stopEvent')
);

on('geolocationAcquired', run('writeRecords'));

注意：要使用 writeRecords 任务，必须安装和配置持久化包。请参阅 持久化包文档。

事件

记录

地理位置

许可证

Apache 许可证版本 2.0