Small library for opening a location or route in other popular iOS navigation apps.
Currently supported are Apple Maps, Google Maps, Citymapper, Transit, Lyft, Uber, Navigon, Waze, Yandex.Navi and Moovit.
Know of any other navigation apps that can be opened via URL scheme or universal link? Please open an issue and/or PR ๐
Check if an app is installed.
if Karte.isInstalled(.citymapper) {
print("Citymapper is installed ๐")
}
Launch a specific app with directions.
let coordinate = CLLocationCoordinate2D(latitude: 52.5162746, longitude: 13.3755153)
let berlin = Location(name: "Brandenburger Tor Berlin", coordinate: coordinate)
try? Karte.launch(app: .googleMaps, destination: berlin)
Or directly present the user with an action sheet listing all installed navigation apps to pick from.
Karte.presentPicker(destination: location, presentOn: viewController)
If you need more control in how to present the action sheet (e.g. on an iPad), you can get a configured one from Karte without having it presented directly.
let alert = Karte.createPicker(destination: location)
.launch()
, .presentPicker()
and .createPicker()
have a few extra parameters with default values set that you can change to your liking. Most important to note would be an origin location, which can of course also be specified. Leaving it blank defaults to the user's current location in most apps.
Please be aware that for .isInstalled()
, .presentPicker()
and .createPicker()
to work you will have to have added the necessary URL schemes to your app's Info.plist
beforehand. See Apple's Docs for more info on this. The necessary URL schemes can be found here. You're still free to try and launch apps via Karte.launch(app:to:)
regardless of registered URL schemes, although that obviously might result in nothing happening if the app isn't there. Don't forget that even Apple Maps can be "uninstalled" now ๐
The section to add to your Info.plist
should look like this:
<key>LSApplicationQueriesSchemes</key>
<array>
<string>comgooglemaps</string>
<string>citymapper</string>
<string>transit</string>
<string>lyft</string>
<string>uber</string>
<string>navigon</string>
<string>waze</string>
<string>yandexnavi</string>
<string>moovit</string>
</array>
Karte is available through Carthage/Punic and Cocoapods, take your pick.
# Carthage
github "kiliankoe/Karte"
# Cocoapods
pod 'Karte'
This library is based on CMMapLauncher. Unfortunately development on that library seems to have been stopped, so this is a reimplementation in Swift including a few changes and other apps to make usage even more pleasant ๐
Kilian Koeltzsch, @kiliankoe
It's German for "Map" and that seemed fitting ๐คทโโ๏ธ