在 GitHub 上查看

@nativescript/geolocation ​

内容 ​

• 简介
• 安装
• Android 权限要求
• iOS 权限要求
• 使用 @nativescript/geolocation
  • 获取当前位置
• API
  • 插件函数
  • Location 类
  • Options 接口
• 已知问题
  • 与 Google Play 服务的版本冲突
  • Android API 30 上的 openSettingsIfLocationHasBeenDenied

简介 ​

一个用于获取当前位置、监控移动等地理位置插件。

安装 ​

要安装该插件，请在项目根目录下运行以下命令。

npm install @nativescript/geolocation

Android 权限要求 ​

要在 Android 上使用地理位置，您需要将以下权限添加到应用程序的 AndroidManifest.xml 中，该文件位于 App_Resources/Android/src/main 目录下

<!-- Always include this permission -->
  <!-- This permission is for "approximate" location data -->
  <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />

  <!-- Include only if your app benefits from precise location access. -->
  <!-- This permission is for "precise" location data -->
  <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />

  <!-- Required only when requesting background location access on
       Android 10 (API level 29) and higher. -->
  <uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />

更多信息可以在 此处找到 Android 文档。

iOS 权限要求 ​

如果 options 对象的 iosAllowsBackgroundLocationUpdates 属性设置为 true，则需要在 App_Resources/iOS/Info.plist 文件中添加以下代码

<key>UIBackgroundModes</key>
<array>
  <string>location</string>
</array>

使用 @nativescript/geolocation ​

获取当前位置 ​

在调用任何获取用户位置的方法之前，请通过调用 enableLocationRequest 方法请求用户的权限。一旦用户授予权限，您就可以调用 getCurrentLocation() 方法并传递一个 options 对象来获取用户当前的位置。

import * as geolocation from '@nativescript/geolocation'
import { CoreTypes } from '@nativescript/core' // used to describe at what accuracy the location should get

geolocation.enableLocationRequest().then(() => {
  geolocation
    .getCurrentLocation({
      desiredAccuracy: CoreTypes.Accuracy.high,
      maximumAge: 5000,
      timeout: 20000,
    })
    .then((currentLocation) => {
      console.log('My current latitude: ', currentLocation.latitude)
    })
})

API ​

插件函数 ​

该插件提供了以下函数来获取当前位置等信息

Location 类 ​

这是一个数据类，封装了以下地理位置的常用属性。

Options 接口 ​

以下是传递给插件的地理位置 函数 的 options 对象的属性。

已知问题 ​

Android API 30 上的 openSettingsIfLocationHasBeenDenied ​

如果用户在 Android API 30 上的应用安装期间两次拒绝权限，即使 enableLocationRequest() 的 openSettingsIfLocationHasBeenDenied 选项为 true，用户也不会被带到设置。

许可证 ​

Apache 许可证 2.0 版