メインコンテンツへスキップ
@capgo/capacitor-launch-navigator 位置情報 オープンソース

Navigatorを起動 Capacitor プラグイン

目的地までの経路案内付きで、Google MapsやApple Mapsなどのナビアプリを起動

インストール

bun add @capgo/capacitor-launch-navigator bunx cap sync
npm、pnpm、または yarn
  • npm install @capgo/capacitor-launch-navigator
  • pnpm add @capgo/capacitor-launch-navigator
  • yarn add @capgo/capacitor-launch-navigator

ガイド

Capacitor で Launch Navigator を使う方法

実機でテストする

Capgo アプリをダウンロードして、QR code をスキャンしてください。

Launch Navigator プラグインのプレビュー用 QR code

@capgo/capacitor-launch-navigator の使い方

プラグインのメインインターフェース。

インストール

bun add @capgo/capacitor-launch-navigator
bunx cap sync

bunx cap sync プラグインのネイティブcodeをネイティブプロジェクトにコピーします。プラグインをアップグレードするたびに再度実行してください。

インポート

import { LaunchNavigator } from '@capgo/capacitor-launch-navigator';

API の概要

メソッド 説明
navigate 緯度と経度を使用して目的地にナビゲートします。
isAppAvailable 特定のナビゲーションアプリが利用可能かどうかを確認します。
getAvailableApps デバイス上で利用可能なナビゲーションアプリの一覧を取得します。
getSupportedApps 現在のプラットフォームでサポートされているアプリの一覧を取得します。
getDefaultApp ナビゲーション用のデフォルトアプリの名前を取得します。
getAppIcons プロバイダーのアイコンを取得してローカルにキャッシュします。
refreshAppIcons キャッシュの経過時間を無視してプロバイダーのアイコンを更新します。
clearIconCache キャッシュされたプロバイダーのアイコンをクリアします。

例

navigate()

緯度と経度を使用して目的地にナビゲートします。

import { LaunchNavigator } from '@capgo/capacitor-launch-navigator';

await LaunchNavigator.navigate({ destination: [48.8566, 2.3522] });

isAppAvailable()

特定のナビゲーションアプリが利用可能かどうかを確認します。

import { LaunchNavigator, IOSNavigationApp } from '@capgo/capacitor-launch-navigator';

const result = await LaunchNavigator.isAppAvailable({ app: IOSNavigationApp.APPLE_MAPS });
console.log(result);

getAvailableApps()

デバイス上で利用可能なナビゲーションアプリの一覧を取得します。

import { LaunchNavigator } from '@capgo/capacitor-launch-navigator';

const result = await LaunchNavigator.getAvailableApps();
console.log(result);

getSupportedApps()

現在のプラットフォームでサポートされているアプリの一覧を取得します。

import { LaunchNavigator } from '@capgo/capacitor-launch-navigator';

const result = await LaunchNavigator.getSupportedApps();
console.log(result);

getDefaultApp()

ナビゲーション用のデフォルトアプリの名前を取得します。

import { LaunchNavigator } from '@capgo/capacitor-launch-navigator';

const result = await LaunchNavigator.getDefaultApp();
console.log(result);

getAppIcons()

プロバイダーのアイコンを取得してローカルにキャッシュします。

import { LaunchNavigator } from '@capgo/capacitor-launch-navigator';

const result = await LaunchNavigator.getAppIcons();
console.log(result);

上記の表は 8 つのコアメソッドの一覧です。リスナーやバージョンのヘルパー、各メソッドの完全なコントラクトについては、 GitHub リポジトリ.

完全なリファレンス

@capgo/capacitor-launch-navigator の利用を続ける

使用している場合 @capgo/capacitor-launch-navigator の使い方 ネイティブプラグインの作業を計画するには、次と連携してください: @capgo/capacitor-launch-navigator 実装の詳細については、@capgo/capacitor-launch-navigator を参照してください。 スタートガイド スタートガイドの実装詳細については、 Capgo プラグインディレクトリ Capgo プラグインディレクトリのプロダクトワークフローについては、 Capgo による Capacitor プラグイン Capgo による Capacitor Plugins の実装詳細、および プラグインの追加または更新 プラグインの追加または更新に関する実装詳細についてはこちら。

よくある質問

Launch Navigator プラグイン FAQ

Capacitor アプリに Launch Navigator プラグインをインストールするには?

「bun add @capgo/capacitor-launch-navigator」(または「npm install @capgo/capacitor-launch-navigator」)を実行し、次に「bunx cap sync」を実行して、iOSおよびAndroidプロジェクトがネイティブcodeを認識するようにします。アプリのcodeから「@capgo/capacitor-launch-navigator」をインポートしてください。

@capgo/capacitor-launch-navigatorはReact、Vue、Angularと互換性がありますか?

はい。Launch NavigatorはCapacitorパッケージであるため、Ionic、React、Vue、Angular、Svelte、プレーンJavaScriptなど、Capacitor内で動作するすべてのWebフレームワークと互換性があります。

@capgo/capacitor-launch-navigatorはどのCapacitorバージョンをサポートしていますか?

Capgo プラグインは Capacitor のメジャーバージョンに合わせています。使用している Capacitor のメジャーバージョンに一致するプラグインのメジャーバージョンを使ってください (例: Capacitor 8 ならプラグイン v8)。GitHub の README にある互換性テーブルに、メンテナンス中のバージョンが記載されています。

@capgo/capacitor-launch-navigatorは無料でオープンソースですか?

はい。ソースcodeはhttps://github.com/Cap-go/capacitor-launch-navigator/のGitHubで公開されており、npmから無料でインストールできます。バグレポートやプルリクエストをお待ちしています。

Launch Navigatorを使用しているcodeを、App Storeのレビューなしで更新できますか?

プラグインのインストールやアップグレードはネイティブの code を変更するため、新しいストアビルドが必要です。その後は、プラグインを呼び出す JavaScript、HTML、CSS の変更を Capgo Live Updates で即座に配信できます。

アプリ審査を待たずに Launch Navigator の変更を配信

プラグインをストア用ビルドに組み込めば、Capgo live updates で JavaScript、HTML、CSS の変更を数分でユーザーに配信できます

Capgo から始める