시작하기
이 플러그인의 설치 단계와 전체 마크다운 가이드가 포함된 설정 프롬프트를 복사하세요.
Set up this Capacitor plugin in the project.
Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-launch-navigator`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/launch-navigator/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.
AI-Assisted Setup으로 플러그인을 설치할 수 있습니다. 다음 명령어로 AI 도구에 Capgo 스킬을 추가하세요:
npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins그런 다음 아래 프롬프트를 사용하세요:
Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-launch-navigator` plugin in my project.수동 설정을 선호한다면, 다음 명령어를 실행하여 플러그인을 설치하고 아래의 플랫폼별 지침을 따르세요:
bun add @capgo/capacitor-launch-navigatorbunx cap sync가져오기
“Import” 섹션import { LaunchNavigator } from '@capgo/capacitor-launch-navigator';빠른 시작
“빠른 시작” 섹션import { LaunchNavigator } from '@capgo/capacitor-launch-navigator';
await LaunchNavigator.navigate({ destination: [37.7749, -122.4194], options: { app: 'google_maps' },});예시: 사용자가 지도 앱을 선택하게 하기
섹션 제목: “예제: 사용자가 지도 앱을 선택하게 하기”const { apps } = await LaunchNavigator.getAvailableApps();// render chooser UI, then navigate with options.app set to the selection예시: 먼저 geocode 수행하기
섹션 제목: “예제: 먼저 geocode하기”사용 @capgo/capacitor-nativegeocoder forwardGeocode() 주소를 ...로 변환하려면 [lat, lng] 호출하기 전에 navigate().
자주 하는 실수
“흔한 실수” 섹션- 좌표만: 도로 주소는 허용되지 않습니다
navigate(). - 웹: 설치된 앱이 아니라 외부 지도 링크를 엽니다.
- 아이콘: 캐시 사용
getAppIcons()사용자가 새 지도 앱을 설치하면 새로고침하세요.
API 개요
“API 개요” 섹션navigate
“navigate” 섹션위도와 경도를 사용하여 위치로 이동
import { LaunchNavigator } from '@capgo/capacitor-launch-navigator';
await LaunchNavigator.navigate({ destination: [48.8566, 2.3522] });isAppAvailable
“isAppAvailable” 섹션특정 내비게이션 앱 사용 가능 여부 확인
import { LaunchNavigator, IOSNavigationApp } from '@capgo/capacitor-launch-navigator';
const result = await LaunchNavigator.isAppAvailable({ app: IOSNavigationApp.APPLE_MAPS });console.log(result);getAvailableApps
“getAvailableApps” 섹션기기에서 사용 가능한 내비게이션 앱 목록 가져오기
import { LaunchNavigator } from '@capgo/capacitor-launch-navigator';
const result = await LaunchNavigator.getAvailableApps();console.log(result);getSupportedApps
“getSupportedApps” 섹션현재 플랫폼에서 지원되는 앱 목록 가져오기
import { LaunchNavigator } from '@capgo/capacitor-launch-navigator';
const result = await LaunchNavigator.getSupportedApps();console.log(result);getDefaultApp
“getDefaultApp” 섹션기본 내비게이션 앱 이름 가져오기
import { LaunchNavigator } from '@capgo/capacitor-launch-navigator';
const result = await LaunchNavigator.getDefaultApp();console.log(result);타입 레퍼런스
“타입 참조” 섹션NavigateOptions
“NavigateOptions” 섹션내비게이션 옵션입니다.
export interface NavigateOptions { /** * Starting location coordinates [latitude, longitude] */ start?: [number, number];
/** * Starting location name */ startName?: string;
/** * Destination name (will be ignored since we only support coordinates) */ destinationName?: string;
/** * Transport mode */ transportMode?: TransportMode;
/** * Specific app to launch (if not specified, will use default or prompt) */ app?: IOSNavigationApp | AndroidNavigationApp | string;
/** * Launch mode */ launchMode?: LaunchMode;
/** * Additional parameters specific to certain apps */ extras?: Record<string, any>;
/** * Enable debug logging */ enableDebug?: boolean;}IOSNavigationApp
“IOSNavigationApp” 섹션iOS에서 사용 가능한 내비게이션 앱입니다.
export enum IOSNavigationApp { APPLE_MAPS = 'apple_maps', GOOGLE_MAPS = 'google_maps', WAZE = 'waze', CITYMAPPER = 'citymapper', GARMIN_NAVIGON = 'garmin_navigon', TRANSIT_APP = 'transit_app', YANDEX_NAVIGATOR = 'yandex', UBER = 'uber', TOMTOM = 'tomtom', SYGIC = 'sygic', HERE_MAPS = 'here', MOOVIT = 'moovit', LYFT = 'lyft', MAPS_ME = 'mapsme', CABIFY = 'cabify', BAIDU = 'baidu', GAODE = 'gaode', TAXI_99 = '99taxi',}AndroidNavigationApp
“AndroidNavigationApp” 섹션Android에서 사용 가능한 내비게이션 앱입니다.
export enum AndroidNavigationApp { GOOGLE_MAPS = 'google_maps', WAZE = 'waze', CITYMAPPER = 'citymapper', UBER = 'uber', YANDEX = 'yandex', SYGIC = 'sygic', HERE_MAPS = 'here', MOOVIT = 'moovit', LYFT = 'lyft', MAPS_ME = 'mapsme', CABIFY = 'cabify', BAIDU = 'baidu', GAODE = 'gaode',}AvailableApp
“AvailableApp” 섹션앱 사용 가능 여부 확인 결과.
export interface AvailableApp { /** * App identifier */ app: string;
/** * Display name of the app */ name: string;
/** * Whether the app is available on the device */ available: boolean;}TransportMode
“TransportMode” 섹션교통 수단.
export enum TransportMode { DRIVING = 'driving', WALKING = 'walking', BICYCLING = 'bicycling', TRANSIT = 'transit',}LaunchMode
“LaunchMode” 섹션출발 모드.
export enum LaunchMode { MAPS = 'maps', TURN_BY_TURN = 'turn_by_turn', GEO = 'geo',}Source of Truth
“Source Of Truth” 섹션이 페이지는 플러그인의 src/definitions.tsupstream에서 public API가 변경되면 sync를 다시 실행하세요.
시작하기 다음 단계
“Getting Started에서 계속하기” 섹션사용 중이라면 시작하기 대시보드 및 API 운영을 계획하려면, 이를 다음과 연결하세요 @capgo/capacitor-launch-navigator 사용하기 @capgo/capacitor-launch-navigator 사용 시 네이티브 기능을 위해, API 개요 구현 세부 사항은 API 개요에서 소개 구현 세부 사항은 소개에서 API 키 API Keys의 구현 세부 사항은, 기기 Devices의 구현 세부 사항은.