@cwoebker/capacitor-start-navigation

中文文档
7.0.0发布于 2025/05/17MITTypeScriptCommonJS零依赖近 30 天下载 3万

Starts navigation in the native maps application

原始使用文档
文档目录8 节
  1. API
  2. launchMapsApp(...)
  3. Interfaces
  4. Type Aliases
  5. TravelMode
  6. iOS setup
  7. Android setup
  8. License

capacitor-start-navigation npm version

Capacitor plugin that allows your app to start native navigation.

Forked from https://github.com/ProteanSoftware/capacitor-start-navigation originally.

API

launchMapsApp(...)

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

Opens the native maps applications with directions started

ParamType
optionsStartNavigationOptions

Interfaces

StartNavigationOptions

PropTypeDescription
latitudestring | number | nullGeo-coordinate latitude. Can be null for address only search.
longitudestring | number | nullGeo-coordinate longitude. Can be null for address only search.
addressStartNavigationAddress | nullSearch for an address. (iOS and Android) Can be used in combination with <c>latitude</c> and <c>longitude</c> to refine search results (Android only).
namestring | nullName label to be shown for end Location
travelModeTravelModeDefaults to 'driving' All options are available on web On iOS only 'driving', 'walking' & 'transit' are available On Android only 'driving', 'walking', 'bicycling' are available

StartNavigationAddress

PropType
streetstring | null
citystring | null
statestring | null
postalCodestring | null
countrystring | null

Type Aliases

TravelMode

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

## Usage
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"
});

TravelMode

Defaults to 'driving'.
All options are available on web.
On iOS only 'driving', 'walking' & 'transit' are available.
On Android only 'driving', 'walking', 'bicycling' are available.

iOS setup

  • sudo gem install cocoapods (once a time)
  • 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 (always do sync after a plugin install)
  • npx cap open ios

Android setup

  • 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 (always do sync after a plugin install)
  • npx cap open android

Now you should be set to go. Try to run your client using ionic cap run android --livereload.

License

MIT

版本与发布记录

@cwoebker/capacitor-start-navigation 共发布 4 个版本,首次发布于 2024/08/14;过去 12 个月发布了 0 个版本。

版本发布日期距今
7.0.0latest2025/05/171.5 年前
6.0.22024/08/142 年前
6.0.12024/08/142 年前
6.0.02024/08/142 年前

关于 @cwoebker/capacitor-start-navigation 的常见问题

@cwoebker/capacitor-start-navigation 是什么?

Starts navigation in the native maps application

如何安装 @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 和提交记录判断。