{"_id":"@capawesome/capacitor-maps-launcher","_rev":"4-95a8e897cd22918ffe2e31dc7463a5a4","name":"@capawesome/capacitor-maps-launcher","dist-tags":{"latest":"0.1.2"},"versions":{"0.0.1":{"name":"@capawesome/capacitor-maps-launcher","version":"0.0.1","keywords":["capacitor","plugin","native","maps","navigation","launch navigator"],"author":{"name":"Robin Genz","email":"mail@robingenz.dev"},"license":"MIT","_id":"@capawesome/capacitor-maps-launcher@0.0.1","maintainers":[{"name":"robingenz","email":"mail@robingenz.dev"}],"homepage":"https://capawesome.io/docs/plugins/maps-launcher/","bugs":{"url":"https://github.com/capawesome-team/capacitor-plugins/issues"},"dist":{"shasum":"23ba0d652c1cc65724fab15517d8c54b77a91f62","tarball":"https://registry.npmjs.org/@capawesome/capacitor-maps-launcher/-/capacitor-maps-launcher-0.0.1.tgz","fileCount":42,"integrity":"sha512-aBy2GfwQD87AvAQlVLUIChhXx+Ms/U5Sga6z64uRD6lWbJgpbbCFNHIkMn9WEnc7lFk/fQkLlglppI4hozl5XA==","signatures":[{"sig":"MEYCIQDUoW7BOR5m3hBiWnW5AnShmprMILafNouAf9R6BoSaEAIhAKy+AadAi2SZZ6hDwShfCbLC4P7W54VdQD9oVhWDGBCA","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":84218},"main":"dist/plugin.cjs.js","types":"dist/esm/index.d.ts","unpkg":"dist/plugin.js","module":"dist/esm/index.js","funding":[{"url":"https://github.com/sponsors/capawesome-team/","type":"github"},{"url":"https://opencollective.com/capawesome","type":"opencollective"}],"gitHead":"8dd31ce5d3f16f94fb71d033f47512e99908f4e4","scripts":{"fmt":"npm run eslint -- --fix && npm run prettier -- --write && npm run swiftlint -- --fix --format","lint":"npm run eslint && npm run prettier -- --check && npm run swiftlint -- lint","build":"npm run clean && npm run docgen && tsc && rollup -c rollup.config.mjs","clean":"rimraf ./dist","watch":"tsc --watch","docgen":"docgen --api MapsLauncherPlugin --output-readme README.md --output-json dist/docs.json","eslint":"eslint . --ext ts","verify":"npm run verify:ios && npm run verify:android && npm run verify:web","prettier":"prettier \"**/*.{css,html,ts,js,java}\"","swiftlint":"node-swiftlint","verify:ios":"cd ios && pod install && xcodebuild -workspace Plugin.xcworkspace -scheme Plugin -destination generic/platform=iOS && cd ..","verify:web":"npm run build","prepublishOnly":"npm run build","verify:android":"cd android && ./gradlew clean build test && cd ..","ios:pod:install":"cd ios && pod install --repo-update && cd ..","ios:spm:install":"cd ios && swift package resolve && cd .."},"_npmUser":{"name":"robingenz","email":"mail@robingenz.dev"},"capacitor":{"ios":{"src":"ios"},"android":{"src":"android"}},"repository":{"url":"git+https://github.com/capawesome-team/capacitor-plugins.git","type":"git"},"_npmVersion":"11.13.0","description":"Capacitor plugin to launch navigation apps with turn-by-turn directions.","directories":{},"_nodeVersion":"24.16.0","eslintConfig":{"extends":"@ionic/eslint-config/recommended"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"8.57.0","rimraf":"6.1.2","rollup":"4.53.3","swiftlint":"2.0.0","typescript":"5.9.3","@capacitor/cli":"8.0.0","@capacitor/ios":"8.0.0","@capacitor/core":"8.0.0","@capacitor/docgen":"0.3.1","@capacitor/android":"8.0.0","@ionic/eslint-config":"0.4.0","prettier-plugin-java":"2.6.7"},"peerDependencies":{"@capacitor/core":">=8.0.0"},"_npmOperationalInternal":{"tmp":"tmp/capacitor-maps-launcher_0.0.1_1783405291197_0.5275603926075585","host":"s3://npm-registry-packages-npm-production"}},"0.1.0":{"name":"@capawesome/capacitor-maps-launcher","version":"0.1.0","keywords":["capacitor","capacitor-plugin","plugin","native","maps","navigation","launch navigator","maps launcher","google maps","apple maps","waze","directions","turn-by-turn navigation"],"author":{"name":"Robin Genz","email":"mail@robingenz.dev"},"license":"MIT","_id":"@capawesome/capacitor-maps-launcher@0.1.0","maintainers":[{"name":"robingenz","email":"mail@robingenz.dev"}],"homepage":"https://capawesome.io/docs/sdks/capacitor/maps-launcher/","bugs":{"url":"https://github.com/capawesome-team/capacitor-plugins/issues"},"dist":{"shasum":"efd5aefdf9916f01fe9136a4b8f74ff1e88cae49","tarball":"https://registry.npmjs.org/@capawesome/capacitor-maps-launcher/-/capacitor-maps-launcher-0.1.0.tgz","fileCount":42,"integrity":"sha512-DbrqwH21uumt161/hZ+IQTwpBIMYMsL3NwgZAkyGp3mkhdMMNGccVgInfdSi7tgHkAAfK4VpAzXM5Ofa7iQiZg==","signatures":[{"sig":"MEUCIB3N9lMTJRIJwfVxF2C5K0OecYA+Aip1y84q4/HhUy7zAiEA0FRMbl3PAizdcDckBoAcwx1Zmu4WbbLDWqh7vyUi0cw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@capawesome%2fcapacitor-maps-launcher@0.1.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":89137},"main":"dist/plugin.cjs.js","types":"dist/esm/index.d.ts","unpkg":"dist/plugin.js","module":"dist/esm/index.js","funding":[{"url":"https://github.com/sponsors/capawesome-team/","type":"github"},{"url":"https://opencollective.com/capawesome","type":"opencollective"}],"gitHead":"1ce17b1fd14c43b2f1d5d3c2da82221e1d1dca37","scripts":{"fmt":"npm run eslint -- --fix && npm run prettier -- --write && npm run swiftlint -- --fix --format","lint":"npm run eslint && npm run prettier -- --check && npm run swiftlint -- lint","build":"npm run clean && npm run docgen && tsc && rollup -c rollup.config.mjs","clean":"rimraf ./dist","watch":"tsc --watch","docgen":"docgen --api MapsLauncherPlugin --output-readme README.md --output-json dist/docs.json","eslint":"eslint . --ext ts","verify":"npm run verify:ios && npm run verify:android && npm run verify:web","prettier":"prettier \"**/*.{css,html,ts,js,java}\"","swiftlint":"node-swiftlint","verify:ios":"cd ios && pod install && xcodebuild -workspace Plugin.xcworkspace -scheme Plugin -destination generic/platform=iOS && cd ..","verify:web":"npm run build","prepublishOnly":"npm run build","verify:android":"cd android && ./gradlew clean build test && cd ..","ios:pod:install":"cd ios && pod install --repo-update && cd ..","ios:spm:install":"cd ios && swift package resolve && cd .."},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:fc6c2294-b5a7-4769-b4b1-609c20c757b1"}},"capacitor":{"ios":{"src":"ios"},"android":{"src":"android"}},"repository":{"url":"git+https://github.com/capawesome-team/capacitor-plugins.git","type":"git"},"_npmVersion":"11.16.0","description":"Capacitor plugin to launch navigation apps with turn-by-turn directions on Android and iOS.","directories":{},"_nodeVersion":"24.18.0","eslintConfig":{"extends":"@ionic/eslint-config/recommended"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"8.57.0","rimraf":"6.1.2","rollup":"4.53.3","swiftlint":"2.0.0","typescript":"5.9.3","@capacitor/cli":"8.0.0","@capacitor/ios":"8.0.0","@capacitor/core":"8.0.0","@capacitor/docgen":"0.3.1","@capacitor/android":"8.0.0","@ionic/eslint-config":"0.4.0","prettier-plugin-java":"2.6.7"},"peerDependencies":{"@capacitor/core":">=8.0.0"},"_npmOperationalInternal":{"tmp":"tmp/capacitor-maps-launcher_0.1.0_1784015549525_0.48123960608453564","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@capawesome/capacitor-maps-launcher","version":"0.1.1","keywords":["capacitor","capacitor-plugin","plugin","native","maps","navigation","launch navigator","maps launcher","google maps","apple maps","waze","directions","turn-by-turn navigation"],"author":{"name":"Robin Genz","email":"mail@robingenz.dev"},"license":"MIT","_id":"@capawesome/capacitor-maps-launcher@0.1.1","maintainers":[{"name":"robingenz","email":"mail@robingenz.dev"}],"homepage":"https://capawesome.io/docs/sdks/capacitor/maps-launcher/","bugs":{"url":"https://github.com/capawesome-team/capacitor-plugins/issues"},"dist":{"shasum":"0259ad9f9fb18d2b5aae6e433c529041bbc686fe","tarball":"https://registry.npmjs.org/@capawesome/capacitor-maps-launcher/-/capacitor-maps-launcher-0.1.1.tgz","fileCount":42,"integrity":"sha512-f+l1Ex+qdAv0W/S4Mb8uZ/Y2Pb9WJJCjfc2rViQ1FK8UBM4fnTNeURLk8s7gwpVPhW/h4LHgr7TqFQi+8acwnA==","signatures":[{"sig":"MEUCIFrkmQUv4PM1cOL/8mQBmL/Y3meIG/Jz3CO4ATsB1TMLAiEAwseR3Pn5rc8VIF5hujblGRS2A3p5jVVfxFPctXitMnE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@capawesome%2fcapacitor-maps-launcher@0.1.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":89146},"main":"dist/plugin.cjs.js","types":"dist/esm/index.d.ts","unpkg":"dist/plugin.js","module":"dist/esm/index.js","funding":[{"url":"https://github.com/sponsors/capawesome-team/","type":"github"},{"url":"https://opencollective.com/capawesome","type":"opencollective"}],"gitHead":"3e61f4b412f9f3f512c21169bb135bbb23a67e6d","scripts":{"fmt":"npm run eslint -- --fix && npm run prettier -- --write && npm run swiftlint -- --fix --format","lint":"npm run eslint && npm run prettier -- --check && npm run swiftlint -- lint","build":"npm run clean && npm run docgen && tsc && rollup -c rollup.config.mjs","clean":"rimraf ./dist","watch":"tsc --watch","docgen":"docgen --api MapsLauncherPlugin --output-readme README.md --output-json dist/docs.json","eslint":"eslint . --ext ts","verify":"npm run verify:ios && npm run verify:android && npm run verify:web","prettier":"prettier \"**/*.{css,html,ts,js,java}\"","swiftlint":"node-swiftlint","verify:ios":"cd ios && pod install && xcodebuild -workspace Plugin.xcworkspace -scheme Plugin -destination generic/platform=iOS && cd ..","verify:web":"npm run build","prepublishOnly":"npm run build","verify:android":"cd android && ./gradlew clean build test && cd ..","ios:pod:install":"cd ios && pod install --repo-update && cd ..","ios:spm:install":"cd ios && swift package resolve && cd .."},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:fc6c2294-b5a7-4769-b4b1-609c20c757b1"}},"capacitor":{"ios":{"src":"ios"},"android":{"src":"android"}},"repository":{"url":"git+https://github.com/capawesome-team/capacitor-plugins.git","type":"git"},"_npmVersion":"11.16.0","description":"Capacitor plugin to launch navigation apps with turn-by-turn directions on Android and iOS.","directories":{},"_nodeVersion":"24.18.0","eslintConfig":{"extends":"@ionic/eslint-config/recommended"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"8.57.0","rimraf":"6.1.2","rollup":"4.53.3","swiftlint":"2.0.0","typescript":"5.9.3","@capacitor/cli":"8.0.0","@capacitor/ios":"8.0.0","@capacitor/core":"8.0.0","@capacitor/docgen":"0.3.1","@capacitor/android":"8.0.0","@ionic/eslint-config":"0.4.0","prettier-plugin-java":"2.6.7"},"peerDependencies":{"@capacitor/core":">=8.0.0"},"_npmOperationalInternal":{"tmp":"tmp/capacitor-maps-launcher_0.1.1_1784103001244_0.3559303686896187","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@capawesome/capacitor-maps-launcher","version":"0.1.2","description":"Capacitor plugin to launch navigation apps with turn-by-turn directions on Android and iOS.","main":"dist/plugin.cjs.js","module":"dist/esm/index.js","types":"dist/esm/index.d.ts","unpkg":"dist/plugin.js","author":{"name":"Robin Genz","email":"mail@robingenz.dev"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/capawesome-team/capacitor-plugins.git"},"bugs":{"url":"https://github.com/capawesome-team/capacitor-plugins/issues"},"funding":[{"type":"github","url":"https://github.com/sponsors/capawesome-team/"},{"type":"opencollective","url":"https://opencollective.com/capawesome"}],"homepage":"https://capawesome.io/docs/sdks/capacitor/maps-launcher/","keywords":["capacitor","capacitor-plugin","plugin","native","maps","navigation","launch navigator","maps launcher","google maps","apple maps","waze","directions","turn-by-turn navigation"],"scripts":{"verify":"npm run verify:ios && npm run verify:android && npm run verify:web","verify:ios":"cd ios && pod install && xcodebuild -workspace Plugin.xcworkspace -scheme Plugin -destination generic/platform=iOS && cd ..","verify:android":"cd android && ./gradlew clean build test && cd ..","verify:web":"npm run build","lint":"npm run eslint && npm run prettier -- --check && npm run swiftlint -- lint","fmt":"npm run eslint -- --fix && npm run prettier -- --write && npm run swiftlint -- --fix --format","eslint":"eslint . --ext ts","prettier":"prettier \"**/*.{css,html,ts,js,java}\"","swiftlint":"node-swiftlint","docgen":"docgen --api MapsLauncherPlugin --output-readme README.md --output-json dist/docs.json","build":"npm run clean && npm run docgen && tsc && rollup -c rollup.config.mjs","clean":"rimraf ./dist","watch":"tsc --watch","ios:pod:install":"cd ios && pod install --repo-update && cd ..","ios:spm:install":"cd ios && swift package resolve && cd ..","prepublishOnly":"npm run build"},"devDependencies":{"@capacitor/android":"8.0.0","@capacitor/cli":"8.4.2","@capacitor/core":"8.0.0","@capacitor/docgen":"0.3.1","@capacitor/ios":"8.0.0","@ionic/eslint-config":"0.4.0","eslint":"8.57.0","prettier-plugin-java":"2.9.7","rimraf":"6.1.2","rollup":"4.62.3","swiftlint":"2.0.0","typescript":"5.9.3"},"peerDependencies":{"@capacitor/core":">=8.0.0"},"eslintConfig":{"extends":"@ionic/eslint-config/recommended"},"capacitor":{"ios":{"src":"ios"},"android":{"src":"android"}},"publishConfig":{"access":"public"},"gitHead":"7c1937ed10b7de86ca2c1cdc3539a2735fd69a00","_id":"@capawesome/capacitor-maps-launcher@0.1.2","_nodeVersion":"24.19.0","_npmVersion":"11.17.0","dist":{"integrity":"sha512-kox3giekkE/ZyOuQxYxHESyG42OEqsFUyG2qnxRK6Lh4go4GYKWyq1k/By5oTGBObM6/F+r5NLyJ/L9a8VuJhA==","shasum":"41de46924cfe013daac01057b4b909a3b58b9577","tarball":"https://registry.npmjs.org/@capawesome/capacitor-maps-launcher/-/capacitor-maps-launcher-0.1.2.tgz","fileCount":42,"unpackedSize":89282,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@capawesome%2fcapacitor-maps-launcher@0.1.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCHFs1aIMd+hc69ZZ8LyNirZJg5qOer0tkJlQX82gcUHwIgVpwUM7rFtpKd4nBkc+G8201daZSMnVMNaZkqJI+p06c="}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:fc6c2294-b5a7-4769-b4b1-609c20c757b1"}},"directories":{},"maintainers":[{"name":"robingenz","email":"mail@robingenz.dev"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/capacitor-maps-launcher_0.1.2_1788337372711_0.7979249610253456"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-07T06:21:30.971Z","modified":"2026-09-02T08:22:53.234Z","0.0.1":"2026-07-07T06:21:31.348Z","0.1.0":"2026-07-14T07:52:29.657Z","0.1.1":"2026-07-15T08:10:01.375Z","0.1.2":"2026-09-02T08:22:52.849Z"},"bugs":{"url":"https://github.com/capawesome-team/capacitor-plugins/issues"},"author":{"name":"Robin Genz","email":"mail@robingenz.dev"},"license":"MIT","homepage":"https://capawesome.io/docs/sdks/capacitor/maps-launcher/","keywords":["capacitor","capacitor-plugin","plugin","native","maps","navigation","launch navigator","maps launcher","google maps","apple maps","waze","directions","turn-by-turn navigation"],"repository":{"type":"git","url":"git+https://github.com/capawesome-team/capacitor-plugins.git"},"description":"Capacitor plugin to launch navigation apps with turn-by-turn directions on Android and iOS.","maintainers":[{"name":"robingenz","email":"mail@robingenz.dev"}],"readme":"# Capacitor Maps Launcher Plugin\n\nCapacitor plugin to launch navigation apps with turn-by-turn directions.\n\n<div class=\"capawesome-z29o10a\">\n  <a href=\"https://cloud.capawesome.io/\" target=\"_blank\">\n    <img alt=\"Deliver Live Updates to your Capacitor app with Capawesome Cloud\" src=\"https://cloud.capawesome.io/assets/banners/cloud-build-and-deploy-capacitor-apps.png?t=1\" />\n  </a>\n</div>\n\n## Features\n\n- 🧭 **Navigate**: Launch a navigation app with turn-by-turn directions to a destination.\n- 🗺️ **Curated apps**: Support for Google Maps, Apple Maps (iOS) and Waze.\n- 📍 **Coordinates & addresses**: Navigate to coordinates or a plain address.\n- 🚗 **Travel modes**: Choose between driving, walking, bicycling and transit (best-effort per app).\n- ✅ **Availability**: Check which navigation apps are installed and can be launched.\n- 🤝 **Compatibility**: Works alongside the [Android Intent Launcher](https://capawesome.io/docs/sdks/capacitor/android-intent-launcher/), [App Launcher](https://capawesome.io/docs/sdks/capacitor/app-launcher/) and [Geocoder](https://capawesome.io/docs/sdks/capacitor/geocoder/) plugins.\n- 📦 **CocoaPods & SPM**: Supports CocoaPods and Swift Package Manager for iOS.\n- 🔁 **Up-to-date**: Always supports the latest Capacitor version.\n\nMissing a feature? Just [open an issue](https://github.com/capawesome-team/capacitor-plugins/issues) and we'll take a look!\n\n## Use Cases\n\nThe Maps Launcher plugin is typically used whenever an app wants to hand the user over to a navigation app, for example:\n\n- **Store locators**: Add a \"Get directions\" button that starts turn-by-turn navigation to a store or office.\n- **Delivery and field service**: Launch navigation to the next stop using its coordinates.\n- **Event apps**: Navigate attendees to a venue by its plain address, without needing coordinates.\n- **User choice**: Detect which navigation apps are installed with `getAvailableApps` and let users pick their favorite one.\n\n## Compatibility\n\n| Plugin Version | Capacitor Version | Status         |\n| -------------- | ----------------- | -------------- |\n| 0.x.x          | >=8.x.x           | Active support |\n\n## Installation\n\nYou can use our **AI-Assisted Setup** to install the plugin.\nAdd the [Capawesome Skills](https://github.com/capawesome-team/skills) to your AI tool using the following command:\n\n```bash\nnpx skills add capawesome-team/skills --skill capacitor-plugins\n```\n\nThen use the following prompt:\n\n```\n Use the `capacitor-plugins` skill from `capawesome-team/skills` to install the `@capawesome/capacitor-maps-launcher` plugin in my project.\n```\n\nIf you prefer **Manual Setup**, install the plugin by running the following commands and follow the platform-specific instructions below:\n\n```bash\nnpm install @capawesome/capacitor-maps-launcher\nnpx cap sync\n```\n\n### Android\n\nThe plugin declares the required [package visibility](https://developer.android.com/training/package-visibility) `<queries>` for Google Maps and Waze in its own `AndroidManifest.xml`. No additional configuration is required.\n\n### iOS\n\n#### Application Queries Schemes\n\nTo detect and launch Google Maps and Waze, the following URL schemes must be added to the `LSApplicationQueriesSchemes` array in the `Info.plist` file of your app. Without them, `getAvailableApps(...)` reports those apps as unavailable and `navigate(...)` rejects with the `APP_NOT_AVAILABLE` error code.\n\n```xml\n<key>LSApplicationQueriesSchemes</key>\n<array>\n  <string>comgooglemaps</string>\n  <string>waze</string>\n</array>\n```\n\nApple Maps is always available and does not require any configuration.\n\n## Configuration\n\nNo configuration required for this plugin.\n\n## Usage\n\nThe following examples show how to get the available and default navigation apps and how to navigate to coordinates or an address.\n\n### Get the available navigation apps\n\nCheck which navigation apps are installed and can be launched. On iOS, Apple Maps is always included, while Google Maps and Waze are only included if the corresponding URL schemes are declared in your `Info.plist` file (see [Installation](#installation)). Only available on Android and iOS:\n\n```typescript\nimport { MapsLauncher } from '@capawesome/capacitor-maps-launcher';\n\nconst getAvailableApps = async () => {\n  const { apps } = await MapsLauncher.getAvailableApps();\n  return apps;\n};\n```\n\n### Get the default navigation app\n\nFind out which navigation app is configured as the default handler for navigation intents. Returns `null` if the default app is not part of the curated list of supported apps or if no default app is set. Only available on Android:\n\n```typescript\nimport { MapsLauncher } from '@capawesome/capacitor-maps-launcher';\n\nconst getDefaultApp = async () => {\n  const { app } = await MapsLauncher.getDefaultApp();\n  return app;\n};\n```\n\n### Navigate to coordinates\n\nLaunch a navigation app with turn-by-turn directions to a destination defined by its latitude and longitude. You can optionally specify the app to launch and the travel mode:\n\n```typescript\nimport { MapsLauncher, NavigationApp } from '@capawesome/capacitor-maps-launcher';\n\nconst navigate = async () => {\n  await MapsLauncher.navigate({\n    destination: {\n      latitude: 37.3349,\n      longitude: -122.009,\n    },\n    app: NavigationApp.GoogleMaps,\n    travelMode: 'driving',\n  });\n};\n```\n\n### Navigate to an address\n\nInstead of coordinates, you can also pass a plain address as the destination. If no `app` is provided, the system default behavior is used (a chooser on Android, Apple Maps on iOS):\n\n```typescript\nimport { MapsLauncher } from '@capawesome/capacitor-maps-launcher';\n\nconst navigateToAddress = async () => {\n  await MapsLauncher.navigate({\n    destination: {\n      address: 'Apple Park, Cupertino, CA',\n    },\n  });\n};\n```\n\n## API\n\n<docgen-index>\n\n* [`getAvailableApps()`](#getavailableapps)\n* [`getDefaultApp()`](#getdefaultapp)\n* [`navigate(...)`](#navigate)\n* [Interfaces](#interfaces)\n* [Type Aliases](#type-aliases)\n* [Enums](#enums)\n\n</docgen-index>\n\n<docgen-api>\n<!--Update the source file JSDoc comments and rerun docgen to update the docs below-->\n\n### getAvailableApps()\n\n```typescript\ngetAvailableApps() => Promise<GetAvailableAppsResult>\n```\n\nGet the navigation apps that are installed and can be launched.\n\nOn iOS, Apple Maps is always included. Google Maps and Waze are only\nincluded if the corresponding `LSApplicationQueriesSchemes` entries are\nadded to the `Info.plist` file of your app.\n\nOnly available on Android and iOS.\n\n**Returns:** <code>Promise&lt;<a href=\"#getavailableappsresult\">GetAvailableAppsResult</a>&gt;</code>\n\n**Since:** 0.1.0\n\n--------------------\n\n\n### getDefaultApp()\n\n```typescript\ngetDefaultApp() => Promise<GetDefaultAppResult>\n```\n\nGet the navigation app that is configured as the default handler for\nnavigation intents.\n\nReturns `null` if the default app is not part of the curated list of\nsupported apps or if no default app is set (i.e. the system shows a\nchooser).\n\nOnly available on Android.\n\n**Returns:** <code>Promise&lt;<a href=\"#getdefaultappresult\">GetDefaultAppResult</a>&gt;</code>\n\n**Since:** 0.1.0\n\n--------------------\n\n\n### navigate(...)\n\n```typescript\nnavigate(options: NavigateOptions) => Promise<void>\n```\n\nLaunch a navigation app with turn-by-turn directions to a destination.\n\nIf no `app` is provided, the system default behavior is used (a chooser on\nAndroid, Apple Maps on iOS).\n\nOnly available on Android and iOS.\n\n| Param         | Type                                                        |\n| ------------- | ----------------------------------------------------------- |\n| **`options`** | <code><a href=\"#navigateoptions\">NavigateOptions</a></code> |\n\n**Since:** 0.1.0\n\n--------------------\n\n\n### Interfaces\n\n\n#### GetAvailableAppsResult\n\n| Prop       | Type                         | Description                                                 | Since |\n| ---------- | ---------------------------- | ----------------------------------------------------------- | ----- |\n| **`apps`** | <code>NavigationApp[]</code> | The navigation apps that are installed and can be launched. | 0.1.0 |\n\n\n#### GetDefaultAppResult\n\n| Prop      | Type                                                            | Description                                                                                                                                                                    | Since |\n| --------- | --------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----- |\n| **`app`** | <code><a href=\"#navigationapp\">NavigationApp</a> \\| null</code> | The navigation app that is configured as the default handler. Returns `null` if the default app is not part of the curated list of supported apps or if no default app is set. | 0.1.0 |\n\n\n#### NavigateOptions\n\n| Prop              | Type                                                    | Description                                                                                                                                                                                                                                                                               | Default                | Since |\n| ----------------- | ------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------- | ----- |\n| **`app`**         | <code><a href=\"#navigationapp\">NavigationApp</a></code> | The navigation app to launch. If not provided, the system default behavior is used (a chooser on Android, Apple Maps on iOS).                                                                                                                                                             |                        | 0.1.0 |\n| **`destination`** | <code><a href=\"#destination\">Destination</a></code>     | The destination to navigate to.                                                                                                                                                                                                                                                           |                        | 0.1.0 |\n| **`start`**       | <code><a href=\"#destination\">Destination</a></code>     | The start location of the route. If not provided, the current location of the device is used. **Note**: The support depends on the selected app. Apple Maps supports it fully, Google Maps opens the directions preview instead of starting turn-by-turn navigation, and Waze ignores it. |                        | 0.1.0 |\n| **`travelMode`**  | <code><a href=\"#travelmode\">TravelMode</a></code>       | The travel mode to use for the directions. **Note**: The support depends on the selected app and is best-effort. Waze only supports driving and ignores this option.                                                                                                                      | <code>'driving'</code> | 0.1.0 |\n\n\n#### Destination\n\nA destination is either defined by its coordinates or by its address, but\nnot both.\n\n| Prop            | Type                | Description                                                                                        | Since |\n| --------------- | ------------------- | -------------------------------------------------------------------------------------------------- | ----- |\n| **`address`**   | <code>string</code> | The address of the destination. Must be provided without `latitude` and `longitude`.               | 0.1.0 |\n| **`latitude`**  | <code>number</code> | The latitude of the destination. Must be provided together with `longitude` and without `address`. | 0.1.0 |\n| **`longitude`** | <code>number</code> | The longitude of the destination. Must be provided together with `latitude` and without `address`. | 0.1.0 |\n\n\n### Type Aliases\n\n\n#### TravelMode\n\nThe travel mode to use for the directions.\n\n- `driving`: Driving directions.\n- `walking`: Walking directions.\n- `bicycling`: Bicycling directions.\n- `transit`: Public transit directions.\n\n<code>'driving' | 'walking' | 'bicycling' | 'transit'</code>\n\n\n### Enums\n\n\n#### NavigationApp\n\n| Members          | Value                      | Description                        | Since |\n| ---------------- | -------------------------- | ---------------------------------- | ----- |\n| **`AppleMaps`**  | <code>'APPLE_MAPS'</code>  | Apple Maps. Only available on iOS. | 0.1.0 |\n| **`GoogleMaps`** | <code>'GOOGLE_MAPS'</code> | Google Maps.                       | 0.1.0 |\n| **`Waze`**       | <code>'WAZE'</code>        | Waze.                              | 0.1.0 |\n\n</docgen-api>\n\n## Platform Support\n\nThe behavior of the `navigate(...)` method depends on the selected app and platform. Keep the following in mind:\n\n### Start location\n\n| App         | `start` support                                                                                                    |\n| ----------- | ------------------------------------------------------------------------------------------------------------------ |\n| Apple Maps  | Full support.                                                                                                       |\n| Google Maps | Supported, but opens the directions preview instead of starting turn-by-turn navigation directly.                  |\n| Waze        | Not supported. The option is ignored.                                                                              |\n\nIf `start` is not provided, the current location of the device is used.\n\n### Travel mode\n\n| App         | `driving` | `walking` | `bicycling` | `transit` |\n| ----------- | --------- | --------- | ----------- | --------- |\n| Apple Maps  | ✅        | ✅        | ❌          | ✅        |\n| Google Maps | ✅        | ✅        | ✅          | ✅        |\n| Waze        | ✅        | ❌        | ❌          | ❌        |\n\nUnsupported travel modes fall back to the default behavior of the respective app. Waze only supports driving and ignores the `travelMode` option.\n\n## FAQ\n\n### How is this plugin different from other similar plugins?\n\nIt launches turn-by-turn navigation in Google Maps, Apple Maps, and Waze from a single fully typed API, accepting either coordinates or a plain address and supporting driving, walking, bicycling, and transit modes. It also detects which navigation apps are installed and, on Android, which one is the default handler, so you can let users pick their favorite. Per-app behavior is documented transparently, and the plugin is actively maintained against the latest Capacitor and OS versions across Android and iOS.\n\n### Why are Google Maps and Waze reported as unavailable on iOS?\n\nTo detect and launch Google Maps and Waze on iOS, the `comgooglemaps` and `waze` URL schemes must be added to the `LSApplicationQueriesSchemes` array in the `Info.plist` file of your app. Without them, `getAvailableApps` reports those apps as unavailable and `navigate` rejects with the `APP_NOT_AVAILABLE` error code. See the [Installation](#installation) section for details.\n\n### What happens if I do not specify a navigation app?\n\nIf no `app` is provided, the system default behavior is used: Android shows a chooser and iOS opens Apple Maps. On Android, you can use `getDefaultApp` to find out which supported navigation app is configured as the default handler.\n\n### Which travel modes are supported?\n\nThe plugin supports the `driving`, `walking`, `bicycling`, and `transit` travel modes, but the support depends on the selected app and is best-effort. Google Maps supports all four modes, Apple Maps does not support bicycling, and Waze only supports driving and ignores the option. Unsupported travel modes fall back to the default behavior of the respective app.\n\n### Can I set a custom start location for the route?\n\nYes, use the `start` option of the `navigate` method. However, the support depends on the selected app: Apple Maps supports it fully, Google Maps opens the directions preview instead of starting turn-by-turn navigation, and Waze ignores it. If no start location is provided, the current location of the device is used.\n\n### Does the plugin work on the web?\n\nNo, the `getAvailableApps` and `navigate` methods are only available on Android and iOS, and `getDefaultApp` is only available on Android. Launching installed navigation apps is a native capability that is not available in the browser.\n\n## Related Plugins\n\n- [Android Intent Launcher](https://capawesome.io/docs/sdks/capacitor/android-intent-launcher/): Launch arbitrary Android intents.\n- [App Launcher](https://capawesome.io/docs/sdks/capacitor/app-launcher/): Check if an app can be opened and open it.\n- [Geocoder](https://capawesome.io/docs/sdks/capacitor/geocoder/): Convert addresses into coordinates and vice versa.\n\n## Newsletter\n\nStay up to date with the latest news and updates about the Capawesome, Capacitor, and Ionic ecosystem by subscribing to our [Capawesome Newsletter](https://cloud.capawesome.io/newsletter/).\n\n## Changelog\n\nSee [CHANGELOG.md](https://github.com/capawesome-team/capacitor-plugins/blob/main/packages/maps-launcher/CHANGELOG.md).\n\n## License\n\nSee [LICENSE](https://github.com/capawesome-team/capacitor-plugins/blob/main/packages/maps-launcher/LICENSE).\n","readmeFilename":"README.md"}