Ctrlk
CMSGitHubSupportBook a demo
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Flutter SDK

Change log for the MapsIndoors Flutter SDK. This document structure is based on Keep a Changelog and the project adheres to Semantic Versioning.

[4.8.0] 2026-10-02

Changed

  • The minimum iOS version is now 16.0, and building for iOS requires Xcode 26. Set platform :ios, '16.0' in your Podfile and raise your app's iOS deployment target to match.

  • Updated Mapsindoors SDKs:

  • On iOS, the MapsIndoors SDK now depends on Google Maps SDK 10.15.0 and Mapbox Maps SDK 11.25.0.

  • On iOS, setAnimatedPolyline no longer has any effect. It ignored animated and repeating there, and read durationMs as seconds. Use setOptions instead, which works on both platforms.

  • MapsIndoors Insights now attributes sessions from iOS apps to this plugin and its version, as it already did on Android.

Added

  • MPDirectionsRenderer.setOptions, getOptions and clearOptions, with MPDirectionsRendererOptions, MPStrokeStyle and MPRouteAnimationType, to change the style and animation of the rendered route at runtime. Properties left unset keep the wayfinding style configured in the MapsIndoors CMS. On Google Maps for iOS, MPStrokeStyle.dashed is drawn solid.

  • Offline caching of Mapbox base-map tiles, so the map underneath MapsIndoors still renders without a network: enableBaseMapCaching, synchronizeBaseMapTiles and isBaseMapCachingSupported, with MPMapboxStyleSource, MPDataSetCachingScope and OnBaseMapCacheProgressListener. The Google Maps packages report caching as unsupported.

  • MPDirectionsRenderer.finishGuidance, which reports to MapsIndoors Insights that the user finished following a route.

  • setMapsIndoorsLanguage supports Simplified and Traditional Chinese (zh-Hans, zh-Hant) on solutions that provide them, and resolves zh-CN and zh-TW to them.

Fixed

  • On iOS, the app no longer crashes when getMapStyles or MapsIndoorsWidget.setHighlight is called, or a display rule is changed, while a map is shown.

  • On iOS, selectVenue, selectBuilding, selectLocation, selectLocationById and setHighlight on MapsIndoorsWidget now complete once the change has been applied, as on Android, so it can be read back as soon as they return. They used to complete before it had started.

  • On iOS, the leg-selected listener now runs before nextLeg, previousLeg and selectLegIndex complete, as on Android, instead of shortly afterwards.

  • On Android, the first MapsIndoors Insights session after an app start was attributed to the Android SDK rather than to this plugin.

  • The colour getters on MPDisplayRule (getPolygonFillColor, getPolygonStrokeColor, getExtrusionColor, getWallColor, getBadgeFillColor, getBadgeStrokeColor, getLabelStyleHaloColor and getLabelStyleTextColor) no longer return a fully transparent colour. Both platforms send these as six-digit #RRGGBB strings, which were decoded with an alpha of 0; they are now opaque. An app that compensated with withAlpha(255) or withOpacity(1.0) can drop that, but does not have to.

  • MPGeometry.contains, MPVenue.contains and MPBuilding.contains, and area on MPPolygon and MPMultiPolygon, now return results. On Android they always failed, and on iOS contains always failed and area returned null. A point inside a polygon's hole counts as outside on both platforms. Android's area can read up to about 1% higher than iOS's, because the two SDKs calculate it differently.

  • getSquaredDistanceToClosestEdge on MPPolygon and MPMultiPolygon now returns a distance on both platforms, where it always failed before. It returns -1 when the point is outside the geometry's bounding box.

  • On Android, a method call the native side does not implement, which can happen when the plugin's packages resolve to different versions, now fails with a MissingPluginException instead of never completing.

Deprecated

  • MPDirectionsRenderer.setPolyLineColors and setAnimatedPolyline. Use setOptions instead.

[4.7.1] 2026-06-02

Fixed

  • Fixed issue on Android where floorselector actions returned from the SDK would not always run on the main thread, resulting in a crash

Changed

  • Updated MapsIndoors SDKs:

[4.7.0] 2026-05-18

Changed

[4.6.3] 2026-03-11

Fixed

  • The function addVenuesToSync no longer causes a crash on iOS

  • The function getLocationsByQuery no longer uses excessive amounts of memory on Android

Changed

[4.6.2] 2026-01-30

Changed

[4.6.1] 2025-11-27

Fixed

  • Added proguard consumer rules that should help avoid issues when minifying the SDK

  • Fixed issues with parsing Additional Details on iOS devices

Changed

[4.6.0] 2025-10-17

Added

Fixed

  • Fixed a number of build issues on both Android and iOS

Changed

[4.5.1] 2025-09-23

Fixed

  • Inconsistencies in color values across Android and iOS are gone

  • Avoid crashes when accessing a number of properties due to null values

  • The callback for onLegSelected in the onLegSelectedListener is now called on iOS

Changed

  • Updated MapsIndoors SDKs:

    • Android to 4.15.2, making Android 16 kB page size compatible (Google Play requirement from November 1)

    • iOS to 4.14.0

[4.5.0] 2025-08-28

Added

  • Added support for automatedZoomLevel property in MPSolutionConfig to limit the zoom level when using e.g. the goTo(entity:) method

  • Added goTo(entity:maxZoom:) method to allow for limiting the zoom level manually instead of using automatedZoomLevel

Changed

[4.4.1] 2025-08-05

Fixed

  • Fixed issues with using zoomTo and zoomBy camera updates on iOS.

  • Fixed issue with fromBounds camera update not adjusting the zoom level correctly.

  • Fixed issue with set hiddenFeatures not being respected on iOS.

Changed

  • Updated MapsIndoors SDKs:

[4.4.0] 2025-07-29

Fixed

  • Fixed a number of Typos

  • Fixed an issue where attempting to fetch display rules by name using location ids not working on iOS

  • Fixed an issue where setting a duration on a CameraUpdate would be ignored on iOS

  • Fixed an issue where setting a zoom value on a CameraUpdate would sometimes be ignored on iOS

  • Fixed a native crash on Android by updating the underlying Mapbox Maps version

Changed

  • Updated MapsIndoors SDKs:

[4.3.2] 2025-07-24

Changed

  • Updated MapsIndoors SDKs:

[4.3.1] 2025-07-23

Fixed

  • Fixed a build issue on iOS

[4.3.0] 2025-07-22

Added

  • Added enableMapsIndoorsDebugLogging(bool) function to enable SDK logging to help with debugging.

Changed

  • Updated MapsIndoors SDKs:

    • iOS to 4.12.3

[4.2.5] 2025-07-15

Fixed

  • Resolved cocoapods dependency issue

[4.2.4] 2025-07-11

Added

  • Added possibility to define which map features to show when initializing the MapsIndoors widget

Fixed

  • zoomBy on iOS now actually zooms by the given amount from the current zoom level

  • zoom level reported by Android when using Mapbox to not be off by 1

Changed

[4.2.3] 2025-06-24

Fixed

  • Fixed iOS compilation error

[4.2.2] 2025-06-20

Fixed

  • Fixed iOS not respecting setHiddenFeatures for 3D models

Changed

[4.2.1] 2025-06-05

Fixed

  • Fixed Android not respecting setHiddenFeatures for 3D models

Changed

  • Updated MapsIndoors SDKs:

    • Android to 4.12.1

[4.2.0] 2025-05-14

Added

  • LabelPositioning on DisplayRules

  • Elevated 2D Models (Mapbox)

    • 2D Models that are placed on Extrusions will now be raised to be placed on top

  • Clip Layer (Mapbox)

    • Extruded buildings and Trees from the MapBox standard style can now be removed, when inside venue's geometry.

    • Does not remove landmarks consistently, will be solved with a future version of Mapbox

    • Requires the module to be enabled; contact MapsPeople to enable it.

Fixed

  • Added additional guards against the map being used before it is ready (Android/Google Maps)

  • Fixed issue causing compass to persist even when disabled (Android)

  • getLocationsByExternalIds now can return more than a single Location in the list (as would be expected) (iOS)

  • Fixed issue where some routes would be incorrect if the route was calculated while offline

  • Fixed issue where moving beyond the venue could cause a crash due to the floor selector

  • Reenabled Mapbox Attribution as it no longer causes a crash when tapped (Android/Mapbox)

Changed

  • Updated MapsIndoors SDKs:

    • Android to 4.12.0

    • iOS to 4.11.0

[4.1.6] 2025-03-26

Fixed

  • Made getLocations() return the same result on both Android and iOS.

Changed

  • Updated MapsIndoors SDKs:

    • Android to 4.11.3

    • iOS to 4.9.6

[4.1.5] 2025-03-13

Fixed

  • zoomLevelChanged callback for custom floor selectors now gets called on iOS as well.

[4.1.4] 2025-03-06

Fixed

  • Removed a number of potential memory retentions in the iOS part of the Flutter plugin.

  • Restored functionality of the listeners on iOS that were disabled in version 4.1.3.

Changed

  • Updated MapsIndoors SDKs:

    • Android to 4.11.2

    • iOS to 4.9.5

[4.1.3] 2025-02-20

Changed

  • Updated MapsIndoors SDKs:

    • iOS to 4.9.4 (to address some memory issues)

[4.1.2] 2025-01-30

Changed

  • Updated MapsIndoors SDKs:

    • Android to 4.10.1

    • iOS to 4.9.2

[4.1.1] 2025-01-09

Fixed

  • Fixed Android build issue

[4.1.0] 2025-01-09

Added

  • Added the ability to set a custom Mapbox style using the new mapStyleUri on MapsIndoorsWidget

Fixed

  • Fixed issue where setting mapsIndoorsTransitionLevel on MapsIndoorsWidget had no effect

  • Fixed error when parsing MPRoute objects

Changed

  • Updated MapsIndoors SDKs:

    • iOS to 4.8.3

[4.0.2] 2025-01-07

Changed

  • Updated MapsIndoors SDKs:

    • Android to 4.9.1

    • iOS to 4.8.1

[4.0.1] 2024-12-11

Fixed

  • Improved rendering performance of Mapbox Map view especially when pinch zooming.

Changed

  • Updated MapsIndoors SDKs:

    • iOS to 4.8.0

[4.0.0] 2024-11-28

Visit the migration guide to see what changes are needed to upgrade from v3 to v4.

Added

  • Added initialCameraPosition: MPCameraPosition to the MapWidget constructor. If set, the initial position of the camera will be moved to the given MPCameraPosition.

Changed

  • Changed all uses of color Strings to use dart:ui Color instead.

  • Updated MapsIndoors SDKs:

    • Android to 4.9.0

    • iOS to 4.7.0

Removed

  • ClearWayType has been removed, use ClearAvoidWayType instead.

[3.1.3] 2024-10-31

Fixed

  • Fixed custom floorselectors not working properly on iOS

Changed

  • Updated MapsIndoors SDKs:

    • Android to 4.8.12

    • iOS to 4.6.2

[3.1.2] 2024-10-25

Fixed

  • Fixed issue where camera events would not be propagated to the Flutter layer on iOS

  • Fixed behavior where iOS would throw an error when getLocationById could not find a location, it now returns null like on Android

  • Fixed setCollisionHandling on MPSolutionConfig causing a crash

  • Fixed moveCamera/AnimateCamera from a MPCameraPosition would not work on iOS

Changed

  • Updated MapsIndoors SDKs:

    • Android to 4.8.11 (Mapbox only)

[3.1.1] 2024-10-16

Fixed

  • Fixed issue where camera events would not be propagated to the Flutter layer

  • Fixed issue on iOS where setting a custom floor selector

  • Fixed issue on Android where goTo(MPLocation) did not function properly

  • Fixed tilt not being applied when moving the camera using a MPCameraUpdate on iOS

  • Fixed blank screen on Android when not using the MapsindoorsStyle

Changed

  • Updated MapsIndoors SDKs:

  • Android to 4.8.11 (Google Maps only)

  • iOS to 4.6.1

[3.1.0] 2024-09-11

Added

  • Added functionality for Android to update the map whenever a Display Rule is changed

  • Added method on MapsIndoorsWidget to disable built-in compass

Changed

  • Disabled Mapbox Attributions button on Android as it would crash when clicked

  • Updated MapsIndoors SDKs:

    • Android to 4.8.9

    • iOS to 4.5.14

[3.0.2] 2024-08-27

Fixed

  • Completed fix for build issue on Android devices

  • Fixed issues where updating display rules would not trigger a refresh on iOS

Changed

  • Updated MapsIndoors SDKs:

    • Android to 4.8.8

    • iOS to 4.5.12

[3.0.1] 2024-07-08

Fixed

  • Fixed build error when using Google Maps on Android

[3.0.0] 2024-06-26

Added

  • Added setHighlight and clearHighlight to MapControlWidget which allows you to highlight a list of locations

  • Added new MPCameraViewFitMode: none, which will disable automatic camera movement when changing legs

  • Added addExcludeWayType, clearExcludeWayType to MPDirectionsService to allow the user to exclude specific MPHighways when querying for a route.

  • Added two new MPSolutionDisplayRuleEnums selection and highlight that allows you to modify the look of highlighted and selected Locations.

  • Added support for Flat and Graphic labels, as well as 3D models

  • Added new setters and getters to MPDisplayRule:

    • LabelStyleGraphic

    • LabelType

    • IconScale

    • IconPlacement

    • PolygonLightnessFactor

    • WallLightnessFactor

    • ExtrusionLightnessFactor

    • LabelStyleTextSize

    • LabelStyleTextColor

    • LabelStyleTextOpacity

    • LabelStyleHaloOpacity

    • LabelStyleHaloWidth

    • LabelStyleHaloBlur

    • LabelStyleBearing

    • BadgeVisibile

    • BadgeZoomFrom

    • BadgeZoomTo

    • BadgeRadius

    • BadgeStrokeWidth

    • BadgeStrokeColor

    • BadgeFillColor

    • BadgePosition

    • Model3DModel

    • Model3DRotationX

    • Model3DRotationY

    • Model3DrotationZ

    • Model3DScale

    • Model3DZoomFrom

    • Model3DZoomTo

    • Model3DVisible

  • Added functionality to hide specific features from the map

    • setHiddenFeatures set a list of MPFeatureType to be hidden from the map

    • getHiddenFeatures get a list of currently hidden MPFeatureType

  • Added optional venue loading, use loadMapsIndoorsWithVenues(key, venueIds) to load a specific set of venues

    • Venues can be added and removed from load at any time by using addVenueToSync(venueId) and removeVenueToSync(venueId)

    • Track the status of venues by adding a listener with addOnVenueStatusChangedListener(MPVenueStatusListener)

    • Get a list of synced venues with getSyncedVenues()

  • Added functionality to disable automatic floor and building selection when moving the map

    • setBuildingSelectionMode set a Selection mode for Buildings on the map with MPSelectionMode (automatic or manual)

    • setFloorSelectionMode set a Selection mode for Floors on the map with MPSelectionMode (automatic or manual)

  • Added functionality to make locations selectable.

    • This setting can be found on MPLoction, MPPOIType and MPSolutionConfig

    • Added MPPOIType which can be fetched from MPSolution

  • Added mapsIndoorsTransitionLevel to MapsIndoorsWidget ctor

    • Sets the zoom level at which the MapsIndoors data should show, instead of extruded buildings on Mapbox Maps. Can be set to 0, if extruded buildings should not show.

  • Added multi-stop navigation: It is now possible to add multiple stops to routes.

    • The existing getRoute method gets two optional parameters stops and optimize

    • stops will add the stops to the route between the origin and destination

    • optimize will rearrange the stops to make a more optimal route, but origin and destination will stay the same.

Changed

  • Updated MapsIndoors SDKs:

    • Android to 4.8.5

    • iOS to 4.5.7

Deprecated

  • Deprecated clearWayType: use clearAvoidWayType instead

[2.1.6] 2024-05-03

Changed

  • Updated MapsIndoors SDKs

    • iOS to 4.3.11

[2.1.5] 2024-03-25

Changed

  • Updated MapsIndoors SDKs

    • Android to 4.4.1

    • iOS to 4.3.8

[2.1.4] 2024-02-28

Changed

  • Updated MapsIndoors Android SDK 4.3.4

Fixed

  • Fixed issue with not being able to always get a correct route involving one way paths.

[2.1.3] 2024-02-13

Changed

  • New Example app included.

Fixed

  • Fixed another issue where OnMapReadyListener would not be invoked during the initial load on iOS.

  • Fixed issues where setOnMarkerClickListener, setOnMapClickListener and setOnLocationSelectedListener would not accept being called with optional parameters.

[2.1.2] 2024-02-01

Changed

  • Updated MapsIndoors SDKs

    • Android to 4.2.12

    • iOS to 4.2.14

[2.1.1] 2024-01-24

Fixed

  • Fixed issue where OnMapReadyListener would not be invoked during the initial load on iOS.

[2.1.0] 2024-01-11

Changed

  • Updated MapsIndoors SDKs

    • Android to 4.2.10

    • iOS to 4.2.13

Added

  • Added showRouteLegButtons to MPDirectionsRenderer

  • Added setLabelOptions to MapsindoorsWidget

[2.0.0] 2023-08-15

Changed

  • Moved from mapsindoors to allow for multiple map providers

  • Changes to classes:

    • MapControl

      • MapControl has merged with the MapsIndoorsWidget, combining them into a single entity. the Widget will still be built in the build tree, and accepts a listener as a parameter to wait for the MapControl part to be initialized.

    • MapsIndoors

      • Has been split up into functions on the namespace to align better with dart language standards. Some methods have changed naming to avoid collision with popular method and parameter naming (eg. MapsIndoors.load is now loadMapsIndoors)

  • Changes to the Widget

    • The MapsIndoorsWidget has been changed to be a UniqueWidget, this is to ensure that the underlying MapsIndoors in the platform code can function normally.

Last updated

Was this helpful?