# @cwoebker/capacitor-start-navigation 中文文档

规范地址：https://npmcn.com/package/%40cwoebker/capacitor-start-navigation/

版本：7\.0\.0
npm 元数据更新时间：2025-05-17T11:38:12.749Z
中文译文更新时间：2026-11-11T05:48:49.794Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40cwoebker/capacitor-start-navigation
原文对照：https://npmcn.com/package/%40cwoebker/capacitor-start-navigation/?lang=original
项目主页：https://github.com/cwoebker/capacitor-start-navigation#readme
源码仓库：https://github.com/cwoebker/capacitor-start-navigation

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：297 kB，83 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：@capacitor/core \>=7\.0\.0
- 首次发布：2024-08-14T09:17:19.184Z
- 最新版本发布：2025-05-17T11:38:12.563Z
- 近 30 天下载量：29656（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：4（近 12 个月 0 个）

## 中文简介

在本地地图应用程序中开始导航

## 安装

```sh
npm install @cwoebker/capacitor-start-navigation
```

也可以使用：`pnpm add @cwoebker/capacitor-start-navigation`、`yarn add @cwoebker/capacitor-start-navigation`、`bun add @cwoebker/capacitor-start-navigation`

## README

# 电容器启动导航 [![npm version](https://badge.fury.io/js/@cwoebker%2Fcapacitor-start-navigation.svg)](https://badge.fury.io/js/@cwoebker%2Fcapacitor-start-navigation)

允许您的应用程序启动本地导航的电容插件 .

从 [https://github.com/ProteanSoftware/电容-启动-导航](https://github.com/ProteanSoftware/capacitor-start-navigation) 原为.

## API 密码

-   [`launchMapsApp(...)`](https://npmcn.com/package/%40cwoebker/capacitor-start-navigation/#readme-launchmapsapp)
-   [接口](https://npmcn.com/package/%40cwoebker/capacitor-start-navigation/#readme-interfaces)
-   [类型异名](https://npmcn.com/package/%40cwoebker/capacitor-start-navigation/#readme-type-aliases)

### 启动 MapsApp (...)

```typescript
launchMapsApp(options: StartNavigationOptions) => Promise<void>
```

打开带开始方向的本地地图应用程序

| 参数 | 类型 |
| --- | --- |
| **`options`** | `[StartNavigationOptions](https://npmcn.com/package/%40cwoebker/capacitor-start-navigation/#readme-startnavigationoptions)` |

* * *

### 接口

#### 启动导航选项

| Prop | 类型 | 说明 |
| --- | --- | --- |
| **`latitude`** | `string | number | null` | 地坐标纬度. 只能搜索地址是无效的 . |
| **`longitude`** | `string | number | null` | 地坐标经度. 只能搜索地址是无效的 . |
| **`address`** | `[StartNavigationAddress](https://npmcn.com/package/%40cwoebker/capacitor-start-navigation/#readme-startnavigationaddress) | null` | 寻找一个地址。 (iOS和Android)可以与<c>纬度</c>和<c>经度</c>结合使用来完善搜索结果(仅Android). |
| **`name`** | `string | null` | 为结束显示名称标签 |
| **`travelMode`** | `[TravelMode](https://npmcn.com/package/%40cwoebker/capacitor-start-navigation/#readme-travelmode)` | 默认“ 驾驶 ” 所有选项都可以在网络上访问 iOS 只提供“ 驾驶”、“ 步行” 和“ 过境” 。 Android 只提供“ 驾驶”、“ 步行”、“ 自行车” |

#### 开始导航 地址

| Prop | 类型 |
| --- | --- |
| **`street`** | `string | null` |
| **`city`** | `string | null` |
| **`state`** | `string | null` |
| **`postalCode`** | `string | null` |
| **`country`** | `string | null` |

### 类型异名

#### 旅行模式

`"driving" | "walking" | "transit" | "bicycling"`

□使用量

```ts
import { StartNavigation } from "capacitor-start-navigation";

//
// launches native maps with directions to Warwick, UK
StartNavigation.launchMapsApp({
  latitude: 52.28333,
  longitude: -1.58333,
  name: "Example location",
  travelMode: "walking"
});

//
// launches native maps with directions to Warwick, UK
StartNavigation.launchMapsApp({
  address: {
    street: "Market Place",
    city: "Warwick",
    postalCode: "CV34 4SA",
    Country: "United Kingdom"
  },
  name: "Example location"
});

```

### 旅行模式

默认为"驾驶" .  
所有选项均可上网查阅.  
在iOS上只提供"驾驶","行走"和"Transit".  
在Android上只有"驾驶","行走","骑自行车"等可用.

## iOS 设置

-   `sudo gem install cocoapods` _(一次性)_
-   `ionic start my-cap-app --capacitor`
-   `cd my-cap-app`
-   `mkdir www && touch www/index.html`
-   `npx cap add ios`
-   `npm install --save capacitor-start-navigation`
-   `npx cap sync ios` _(插件安装后总是同步)_
-   `npx cap open ios`

## 机器人设置

-   `ionic start my-cap-app --capacitor`
-   `cd my-cap-app`
-   `mkdir www && touch www/index.html`
-   `npx cap add android`
-   `npm install --save capacitor-start-navigation`
-   `npx cap sync android` _(插件安装后总是同步)_
-   `npx cap open android`

现在你该走了 尝试使用 `ionic cap run android --livereload`。 。 。 .

## 许可证

麻省理工学院

## 常见问题

### @cwoebker/capacitor-start-navigation 是什么？

在本地地图应用程序中开始导航

### 如何安装 @cwoebker/capacitor-start-navigation？

在项目目录运行 npm install @cwoebker/capacitor-start-navigation，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@capacitor/core（\>=7\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @cwoebker/capacitor-start-navigation 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @cwoebker/capacitor-start-navigation 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @cwoebker/capacitor-start-navigation 可以商用吗？

@cwoebker/capacitor-start-navigation 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @cwoebker/capacitor-start-navigation 的下载量有多少？

根据 npm 官方下载统计，@cwoebker/capacitor-start-navigation 在 2026/10/11 – 2026/11/09 这 30 天内被下载 29,656 次，日均约 989 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @cwoebker/capacitor-start-navigation 还在维护吗？

最新版本 7\.0\.0 发布于 2025/05/17（1\.5 年前）；至今共发布 4 个版本，其中过去 12 个月发布了 0 个；首次发布于 2024/08/14。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。