map_launcher

Add your own map apps, ship only the maps you use, and launch them in one line.

Maps are now MapApp objects instead of enum values. Subclass MapApp to
add any map app without forking the plugin. Only the maps you reference are
compiled into your app, so URL schemes, package names, and icons of unused
maps never touch your binary. And discovery results are directly launchable:
maps.first.show().

See MIGRATION.md for the full 5.x → 6.0 guide.

New Features:

• Custom maps: subclass MapApp to add any map app (regional, proprietary,
  internal) without forking the plugin. Works everywhere a built-in map does,
  including discovery and launching.
• Tree-shakeable maps: referencing MapApp.waze compiles in only Waze's
  code, strings, and icon. Unreferenced maps are stripped completely from
  release binaries, verified by scanning AOT snapshots.
• Launchable discovery results: final maps = await request.getSupportedMaps([...])
  then maps.first.show(). No more request/mapType plumbing in pickers.
• Misconfiguration warning (iOS): debug builds print a warning when a map
  passed to discovery is missing from LSApplicationQueriesSchemes, naming
  the exact scheme to add. Previously indistinguishable from "not installed".
• Official app icons: 256×256 PNG icons sourced from iTunes and Google Play
  Store APIs, embedded as Uint8List. No flutter_svg dependency needed.
  Run dart run tool/fetch_icons.dart to refresh.
• Generic native layer: iOS/Android detection is driven entirely from
  Dart. The native code has zero map-specific knowledge.

Breaking Changes:

• MapType enum → MapApp objects: MapType.google → MapApp.google.
  Dot-shorthand call sites like show(map: .google) compile unchanged.
• Discovery takes an explicit list: getSupportedMaps() →
  getSupportedMaps([.apple, .google, .waze]), getAvailableMaps() →
  getAvailableMaps(myMaps). Use MapApp.all for every supported map (this
  opts out of tree shaking).
• Icons are PNG bytes, not SVG assets: SvgPicture.asset(map.icon) →
  Image.memory(map.iconBytes). No extra dependencies needed. flutter_svg
  is no longer required.
• SupportedMap: map.mapType → map.map (a MapApp),
  map.displayName → map.name. Entries returned by a request are directly
  launchable via map.show().
• Persisted map names: MapType.values.byName(saved) →
  myMaps.firstWhere((m) => m.id == saved). MapApp.id matches the old
  enum names, so stored preferences keep working.
• Removed maps: truckmeister (discontinued by Flitsmeister) and
  spedionNavigation (integrated module in the SPEDION fleet app, not a
  standalone map) have been removed. Use the custom MapApp subclass feature
  to add them back if needed.

What's Changed

• v6: custom maps, treeshaking, new icons by @mattermoran in #226

Full Changelog: v5.0.1...v6.0.0

Add your own map apps, ship only the maps you use, and launch them in one line.

Maps are now MapApp objects instead of enum values. Subclass MapApp to add any map app without forking the plugin. Only the maps you reference are compiled into your app, so URL schemes, package names, and icons of unused maps never touch your binary. And discovery results are directly launchable: maps.first.show().

See MIGRATION.md for the full 5.x → 6.0 guide.

New Features:

• Custom maps: subclass MapApp to add any map app (regional, proprietary, internal) without forking the plugin. Works everywhere a built-in map does, including discovery and launching.
• Tree-shakeable maps: referencing MapApp.waze compiles in only Waze's code, strings, and icon. Unreferenced maps are stripped completely from release binaries, verified by scanning AOT snapshots.
• Launchable discovery results: final maps = await request.getSupportedMaps([...]) then maps.first.show(). No more request/mapType plumbing in pickers.
• Misconfiguration warning (iOS): debug builds print a warning when a map passed to discovery is missing from LSApplicationQueriesSchemes, naming the exact scheme to add. Previously indistinguishable from "not installed".
• Official app icons: 256×256 PNG icons sourced from iTunes and Google Play Store APIs, embedded as Uint8List. No flutter_svg dependency needed. Run dart run tool/fetch_icons.dart to refresh.
• Generic native layer: iOS/Android detection is driven entirely from Dart. The native code has zero map-specific knowledge.

Breaking Changes:

• MapType enum → MapApp objects: MapType.google → MapApp.google. Dot-shorthand call sites like show(map: .google) compile unchanged.
• Discovery takes an explicit list: getSupportedMaps() → getSupportedMaps([.apple, .google, .waze]), getAvailableMaps() → getAvailableMaps(myMaps). Use MapApp.all for every supported map (this opts out of tree shaking).
• Icons are PNG bytes, not SVG assets: SvgPicture.asset(map.icon) → Image.memory(map.iconBytes). No extra dependencies needed. flutter_svg is no longer required.
• SupportedMap: map.mapType → map.map (a MapApp), map.displayName → map.name. Entries returned by a request are directly launchable via map.show().
• Persisted map names: MapType.values.byName(saved) → myMaps.firstWhere((m) => m.id == saved). MapApp.id matches the old enum names, so stored preferences keep working.
• Removed maps: truckmeister (discontinued by Flitsmeister) and spedionNavigation (integrated module in the SPEDION fleet app, not a standalone map) have been removed. Use the custom MapApp subclass feature to add them back if needed.

• fix: remove dart:io from web import

Full Changelog: v5.0.0...v5.0.1

• fix: remove dart:io from web import

What's Changed

• v5: add support for desktop and web platforms, universal links and store urls by @mattermoran in #224

Breaking Changes

• MapLauncher.showMarker() / showDirections() → MapLauncher.marker(...).show() / .directions(...).show(). Methods on AvailableMap are gone.
• AvailableMap → SupportedMap. Name and icon moved to MapType.displayName / MapType.icon. SupportedMap only pairs a MapType with isInstalled.
• Coords → LocationCoords: Coords(latitude, longitude) → .coords(lat, lng, title: '...'). Title moved into the location.
• Waypoint removed. Use LocationCoords directly.
• DirectionsMode → TravelMode.
• extraParams → extra: accepts typed extras (GoogleExtra, AppleExtra, etc.) or raw Map<String, String>.
• MapType enum reordered, now carries displayName, playStoreId, appStoreId, hasUniversalLink, icon.
• getAvailableMaps() returns List<SupportedMap> instead of List<AvailableMap>.
• isMapAvailable() removed. Use getSupportedMaps() on a request.
• Minimum SDK: Dart 3.11+, Flutter 3.3+.

New Features

• Desktop & web support (macOS, Windows, Linux, web) via universal links.
• Scheme-to-universal fallback when native app isn't installed.
• Search-based markers and directions (Google, Apple).
• URL inspection: getUrl(), getUniversalUrl(), getSchemeUrl().
• Typed extras: GoogleExtra, AppleExtra, WazeExtra, TencentExtra, YandexNaviExtra.
• getSupportedMaps() — per-request discovery that respects capabilities.
• Store URLs: MapType.appStoreUrl / MapType.playStoreUrl.
• MapLaunchException with URL and cause.

Docs

• Added CONTRIBUTING.md for adding new map providers.

Full Changelog: v4.6.0...v5.0.0

New Features:

• Desktop & web support: macOS, Windows, Linux, and web platforms via universal links (HTTPS URLs).
• Scheme-to-universal fallback: On mobile, if a native app scheme URL fails (app not installed), automatically falls back to the universal HTTPS URL.
• Search-based markers and directions: Google and Apple Maps support text queries for both markers and destinations.
• URL inspection: getUrl(), getUniversalUrl(), and getSchemeUrl() let you preview URLs without launching.
• Extras system: Type-safe, map-specific parameters via GoogleExtra, AppleExtra, WazeExtra, TencentExtra, YandexNaviExtra.
• getSupportedMaps(): Per-request map discovery that respects capabilities (marker support, search support, waypoint support).
• getAvailableMaps(): Platform-wide map discovery returning both installed and universal-link maps.
• Store URLs on MapType: appStoreUrl and playStoreUrl getters for linking to app store pages.
• MapLaunchException: Typed exception with the URL and underlying cause when a launch fails.

Breaking Changes:

• New builder-style API: MapLauncher.showMarker() / MapLauncher.showDirections() → MapLauncher.marker(...).show() / MapLauncher.directions(...).show(). Methods on AvailableMap are gone too.
• AvailableMap → SupportedMap: No longer carries mapName or icon. Those are now properties on MapType itself (MapType.displayName, MapType.icon). SupportedMap only pairs a MapType with isInstalled.
• Coords → LocationCoords: Coords(latitude, longitude) → .coords(lat, lng, title: '...'). Title moved from showMarker() into the location. latitude/longitude fields renamed to lat/lng.
• Waypoint removed: Use LocationCoords directly in the waypoints list.
• DirectionsMode → TravelMode: Same values (driving, walking, transit, bicycling), renamed.
• extraParams → extra: Now accepts typed extras (GoogleExtra, AppleExtra, etc.) or raw Map<String, String>. Passed via show(extra: ...) instead of the old method parameter.
• MapType enum values reordered: google is now before googleGo. Enum carries displayName, playStoreId, appStoreId, hasUniversalLink, icon.
• MapLauncher.getAvailableMaps() → MapLauncher.getAvailableMaps(): Same name, but returns List<SupportedMap> instead of List<AvailableMap>.
• isMapAvailable() removed: Use getSupportedMaps() on a request instead.
• Minimum SDK: Dart 3.11+, Flutter 3.3+.

Docs:

• Added CONTRIBUTING.md with step-by-step guide for adding new map providers.

What's Changed

• feat: Include SPEDION Navigation by @D3nn7 in #220
• feat: add Magic Earth as a supported map on both Android and iOS by @APopaMagicLane in #222

New Contributors

• @D3nn7 made their first contribution in #220
• @APopaMagicLane made their first contribution in #222

Full Changelog: v4.5.0...v4.6.0

• feat: add support for SPEDION Navigation (#220) (@D3nn7)
• feat: add support for Magic Earth (#222) (@APopaMagicLane)

What's Changed

• Include AirNav Pro navigation app into package by @BranislavKljaic96 in #219

New Contributors

• @BranislavKljaic96 made their first contribution in #219

Full Changelog: v4.4.3...v4.5.0

• feat: add support for Air Navigation Pro (#219) (@BranislavKljaic96)

• fix: gracefully handle invalid urls (#216)

What's Changed

• fix: preserve url scheme casing by @mattermoran in #212

Full Changelog: v4.4.1...v4.4.2

• fix: preserve url scheme casing (#212) (@eryanwcp)

What's Changed

• fix: isMapAvailable method regression by @mattermoran in #210

Full Changelog: v4.4.0...v4.4.1

• fix: isMapAvailable method regression (#210)

What's Changed

• feat: add support for neshan map by @mattermoran in #208

Full Changelog: v4.3.0...v4.4.0

• feat: add support for neshan map (#208) (@AmirJabbari)

What's Changed

• feat: add support for moovit map by @mattermoran in #207

Full Changelog: v4.2.0...v4.3.0

• feat: add support for moovit map (#207) (@kfiross)

• feat: add waypoints support for yandex maps and yandex navi (#206) (@ahmetcj4)

• Add support for swift package manager and bump min ios to 13 (#205)

• Fix parsing available map json (#204)

• Fix search param URL encoding (#201)
• Improve public API documentation (#200)

• Recreate the plugin with new structure to prepare for multiplatform support
• Bump android min sdk to 21

• Add Mappls MapmyIndia (@Ajaay7 & @Saksham66)

• Remove support for apps using android v1 embedding

• Remove support for Maps.me on android as it stopped working a while ago

• Add privacy manifest
• Bump flutter min version to 3.13.0
• Bump dart min version to 3.1.0

• Add Mapy.cz (@TheHumr)

• Add Naver Map, KakaoMap and TMAP (@trentcharlie & @JulyWitch)
• Add support for AGP 7.4.2 and up (@bitsydarel)

• Rename Sygic to Sygic Truck
• Remove deprecated launchMap method. use showMarker instead

BREAKING: waypoints parameter now uses List<Waypoint> instead of `List<Coord>``

• Add CoPilot map (@tjeffree)
• Add Go Fleet and Sygic Truck maps (@amrahmed242)
• Add Flitsmeister and Truckmeister (@robinbonnes & @frankvollebregt)
• Add waypoint labels for Apple Maps (@manafire)
• Add support for gradle 8 (@m-derakhshi)
• Fix future not completing on iOS

• Add support for waypoints on Apple Maps

• Update screenshots

• Bump kotlin version to 1.5.31

• Add TomTom Go #125 (@frankvollebregt)

• Cleanup

• Fix empty title in Google Maps

• Fix originTitle on showDirections method

• Update README with information that title should now work in Google Maps for Android starting from v11.12

• Add dartdoc comments
• Update directions_url.dart formatting
• Update broken link in the README

• Add Petal maps #103 (@mericgerceker)

• Replace jcenter with mavenCentral #100

• Fix iOS crash when using unsupported MapTypes #83 (@bridystone)

• Add OSMAnd+ #82 (@bridystone)
• Add Here WeGo #77 (@aleksandr-m)
• Add zoom level for OSMAnd on iOS #79 (@bridystone)
• Fix deprecation compiler warning in Xcode #78 (@bridystone)
• Bump minimum iOS version to 10

• Stable null safety

• Migrate to null safety
• Thanks to @LDevineau-eVtech

Breaking change! See here for migration

• Fix Android 11 not showing installed maps #58
• Thanks to @BasPhair, @olsisaqe

• Add warning for v1.1.3

• Fix Tencent Maps and 2GIS url scheme on ios #56

• Add extraParams option to support passing additional query parameters that might be needed like api keys etc

• BREAKING CHANGE: not depending on flutter_svg anymore. See README for migration
• Add support for Google Maps GO
• Under the hood changes
• Thanks to @andoni97, @Pavel-Sulimau, @grinder15 for contribution

• Add import fallback for #import <map_launcher/map_launcher-Swift.h>
• Thanks to @fisherjoe

• Fix default zoom level

• Add support for 2GIS

• Add waypoints for Google Maps

• Add zoom parameter

• Add showDirections method
• Update example app

• Update flutter_svg constraint </br> Thanks to @tuarrep and @jcsena

• Fix #31 </br> Thanks to @LeonidVeremchuk

• Add support for android embedding v2

• Add constraint for flutter_svg

• Replace png icons with svgs </br> Thanks to @shinsenter

• Add support for Maps.Me and OsmAnd </br> Thanks to @gsi-yoan and @gsi-alejandrogomez

• Add support for Citymapper </br> Thanks to @Kiruel

• Fix Google Maps title issue on iOS </br> Thanks to @illiashvedov

• Specify swift version in map_launcher.podspec file

• Add license

• Add code to show title in Google Maps for Android. Should work once fixed in Google Maps. Update README.