capacitor-start-navigation

Capacitor plugin that allows your app to start native navigation.

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

API

• launchMapsApp(...)
• Interfaces
• Type Aliases

launchMapsApp(...)

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

Opens the native maps applications with directions started

| Param | Type | | ------------- | ------------------------------------------------------------------------- | | options | StartNavigationOptions |

Interfaces

StartNavigationOptions

| Prop | Type | Description | | ---------------- | --------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | latitude | string | number | null | Geo-coordinate latitude. Can be null for address only search. | | longitude | string | number | null | Geo-coordinate longitude. Can be null for address only search. | | address | StartNavigationAddress | null | Search 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). | | name | string | null | Name label to be shown for end Location | | travelMode | 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 |

StartNavigationAddress

| Prop | Type | | ---------------- | --------------------------- | | street | string | null | | city | string | null | | state | string | null | | postalCode | string | null | | country | string | null |

Type Aliases

TravelMode

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

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