メインコンテンツへスキップ
@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 のソースコードは GitHub の https://github.com/Cap-go/capacitor-launch-navigator/ で公開されており、パッケージは npm から無料でインストールできます。バグ報告やプルリクエストも歓迎しています。

App Store の審査なしで、Launch Navigator を使用している code をアップデートできますか?

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

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

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

Capgo から始める