8.7 发布—WinterCG 合规性第一部分
了解更多

在 GitHub 上查看

@nativescript/directions ​

一个允许您启动 Google 地图应用程序（如果已安装在设备上）并提供路线的插件。有关更多信息，请访问 路线操作.

内容 ​

安装 ​

要安装插件，请在应用程序的根目录中运行以下命令。

cli
npm install @nativescript/directions

使用 @nativescript/directions ​

使用路线启动 Google 地图 ​

要使用所需的路线启动 Google 地图，请在 Directions 实例上调用 navigate 方法，并将 NavigateToOptions 对象传递给它。

typescript
import { Directions } from '@nativescript/directions'

const directions = new Directions()

directions
  .navigate({
    from: {
      lat: 52.215987,
      lng: 5.282764,
    },
    to: [
      {
        address: 'Hof der Kolommen 34, Amersfoort, Netherlands',
      },
      {
        address: 'Aak 98, Wieringerwerf, Netherlands',
      },
    ],
    type: 'walking',
    ios: {
      preferGoogleMaps: true,
      allowGoogleMapsWeb: true,
      useUniversalSyntax: true,
    },
    android: {
      newTask: true,
    },
  })
  .then(
    () => {
      console.log('Maps app launched.')
    },
    (error) => {
      console.log(error)
    }
  )

检查 Google 地图应用程序是否已安装 ​

如果您需要检查设备上是否安装了 Google 地图移动应用程序，请调用 available 方法。

ts
const directions = new Directions()

directions.available().then((avail: boolean) => {
  console.log(avail ? 'Yes' : 'No')
})

API ​

路线方法 ​

Directions 类具有以下两种方法

方法返回描述
available()Promise<boolean>检查设备是否安装了地图应用程序。
navigate(options: NavigateToOptions)Promise<void>使用预定义的 from 和 to 地址以及 其他 可选设置打开原生地图应用程序。
属性类型描述
fromAddressOptions可选：导航的起点。

如果未传递此选项，则将使用用户的当前位置。
toAddressOptions | Array<AddressOptions>导航的目的地。如果它是地址数组，则最后一项是目的地，其他项成为“途径点”。
iosiOSOptions可选：iOS 特定的设置。
androidAndroidOptions可选：Android 特定的设置。
useUniversalSyntaxboolean可选：如果为 true，则此操作将使用通用语法而不是 comgooglemaps:// URL 方案打开 Google 地图。如果您在 iOS 上无法正确加载 Google 地图，则通用语法现在是首选。
typeNavigateToOptionsType可选：到达目的地的模式。

注意，如果 from 和 to 之间存在海洋，则您将无法获得路线，不要责怪这个插件 😁。

AddressOptions ​

名称类型描述
latnumber可选：纬度。如果设置了 address，则会被忽略。
lngnumber可选：经度。如果设置了 address，则会被忽略。
addressstring可选：路线的地址。对于多个地址，请将它们添加到字符串中，并用逗号隔开。
ts
;'driving' | 'transit' | 'bicycling' | 'walking'

iOSOptions ​

名称类型描述
preferGoogleMapsboolean可选：指示是否使用 Google 地图（如果已安装）而不是 iOS 地图。您可能希望使用 Google 地图应用程序，因为它支持途径点。
allowGoogleMapsWebboolean如果传递了途径点并且未安装 Google 地图，您可以选择打开 Apple 地图，并且第一个途径点用作到地址（其余部分将被忽略），或者您可以将此选项设置为 true 以在网络上打开 Google 地图，以便显示所有途径点。

AndroidOptions ​

名称类型描述
newTaskboolean可选：指示是否将路线作为新任务启动。

许可证 ​

Apache 许可证 2.0 版

上一个
Detox
下一个
电子邮件