Flutter SDK Changelog

Version 3.25.12 – April 08, 2025 #

Changed

Updated Android SDK to version 3.26.4

Version 3.25.11 – April 08, 2025 #

Changed

Updated iOS SDK to version 3.28.0

Version 3.25.10 – March 26, 2025 #

Resolved an issue introduced in version 3.25.5.

Changed

Updated Android SDK to version 3.26.3

Version 3.25.9 – March 21, 2025 #

This version contains a bug and should not be used.

Changed

Updated iOS SDK to version 3.27.1

Version 3.25.8 – March 21, 2025 #

This version contains a bug and should not be used.

Changed

Updated Android SDK to version 3.26.2

Version 3.25.7 – March 19, 2025 #

This version contains a bug and should not be used.

Changed

Updated iOS SDK to version 3.27.0

Version 3.25.6 – March 19, 2025 #

This version contains a bug and should not be used.

Changed

Updated Android SDK to version 3.26.1

Version 3.25.5 – March 17, 2025 #

This version contains a bug and should not be used.

Changed

Updated Android SDK to version 3.26.0

Version 3.25.4 – March 12, 2025 #

Changed

Updated Android SDK to version 3.25.0

Version 3.25.3 – March 11, 2025 #

Changed

Updated Android SDK to version 3.24.0

Version 3.25.2 – March 05, 2025 #

Changed

Updated Android SDK to version 3.23.0

Version 3.25.1 – March 03, 2025 #

Changed

Updated iOS SDK to version 3.26.0

Version 3.25.0 – February 28, 2025 #

Added

Added a new attribute profile as a replacement of remoteIdentifier. This attribute represents the selected profile name for configuring the MapView with its corresponding remote settings.

Deprecated

Deprecated remoteIdentifier, use profile instead.

Version 3.24.1 – February 24, 2025 [STABLE] #

Changed

Updated iOS SDK to version 3.25.1

Version 3.24.0 – February 18, 2025 #

Added

Implemented 2 new actions that interact with the Mapview:
- Deselect current poi: deselects whatever the current POI is, does not need to specify the POI id, when it deselects a POI its identifier can be known with onPoiDeselected callback.
- Request directions: computes directions to from a POI to another POI or from current location to a POI.

Version 3.23.16 – February 11, 2025 #

Changed

Updated Android SDK to version 3.22.0

Version 3.23.15 – February 05, 2025 #

Changed

Updated iOS SDK to version 3.25.0

Version 3.23.14 – January 29, 2025 #

Changed

Updated iOS SDK to version 3.24.1

Version 3.23.13 – January 24, 2025 #

Changed

Updated Android SDK to version 3.21.3

Version 3.23.12 – January 16, 2025 #

Changed

Updated iOS SDK to version 3.24.0

Version 3.23.11 – January 16, 2025 #

Changed

Updated Android SDK to version 3.21.2

Version 3.23.10 – January 13, 2025 #

Changed

Updated iOS SDK to version 3.23.0

Version 3.23.9 – January 09, 2025 #

Changed

Updated Android SDK to version 3.21.1

Version 3.23.8 – January 08, 2025 #

Changed

Updated iOS SDK to version 3.22.0

Version 3.23.7 – December 19, 2024 #

Changed

Updated iOS SDK to version 3.21.1

Version 3.23.6 – December 19, 2024 #

Added

Added bearing and accuracy as optional parameters in the ExternalLocation model.
Added ErrorCodes.foregroundServiceNotAllowed to handle the case where the application tries to
start the Situm Foreground Service from the background. On Android 12+ (API level 31 and above),
apps are generally restricted from starting Foreground Services while running in the background,
except in certain specific exemptions.
If you try to start the Situm Foreground Service from the background, the SDK will capture the
Operating System exception and will throw this error through the onLocationError callback.
Added a new attribute diagnosticsOptions to the LocationRequest to manage configuration options related to remote diagnostic and telemetry. By now, it only contains a flag uploadDiagnosticsData to decide whether or not to upload diagnostics and telemetry data to your Dashboard. Enabling this option is beneficial for support purposes, as the telemetry data contains valuable insights that the Situm team can analyze to identify and resolve positioning issues more effectively. Like any other upload, it consumes network bandwidth, so in certain scenarios you may opt to disable it.

Changed

Updated Android SDK to version 3.21.0.

Version 3.23.5 – November 27, 2024 [Stable] #

Changed

Updated iOS SDK to version 3.21.0

Version 3.23.4 – November 21, 2024 #

Changed

Updated iOS SDK to version 3.20.0

Version 3.23.3 – October 30, 2024 [Stable] #

Changed

Updated iOS SDK to version 3.19.0

Version 3.23.2 – October 30, 2024 #

Changed

Updated Android SDK to version 3.20.0

Version 3.23.1 – October 30, 2024 #

Changed

Updated Android SDK to version 3.19.0

Version 3.23.0 – October 21, 2024 #

Added

New method requestAutoStop(AutoStopCriteria) to request the SDK to stop positioning automatically under the given criteria. The AutoStopCriteria accepts a parameter consecutiveOutOfBuildingTimeout that determines the amount of time between detecting the user’s exit from a building and automatically stopping the positioning system.
This method only takes effect in Android.
Also added removeAutoStop() to disable any AutoStopCriteria previously requested.
This method only takes effect in Android.
Added a new class StatusNames that contains a reference list of the location status received in onLocationStatus(status).

Version 3.22.1 – October 17, 2024 #

Changed

Updated Android SDK to version 3.18.0

Version 3.22.0 – October 15, 2024 #

Added

New method SitumSdk.addExternalLocation(ExternalLocation) that allow Situm to use other location providers. You can learn more about this functionality here.
New parameter useExternalLocations in ConfigurationOptions to allow the sdk to start using an external location provider.

Version 3.21.1 – October 14, 2024 #

Changed

Updated iOS SDK to version 3.18.1

Version 3.21.0 – October 07, 2024 #

Added

Added a new parameter MapViewConfiguration.displayWithHybridComposition to determine whether the underlying webview containing the map will use hybrid composition or not. This parameter applies only for Android and is useful in scenarios where the use of hybrid composition causes unwanted interactions with other elements of the app. See: https://docs.flutter.dev/platform-integration/android/platform-views.
The default and preferred value is true.

Version 3.20.6 – September 27, 2024 #

Changed

Updated Android SDK to version 3.17.1

Version 3.20.5 – September 26, 2024 #

Changed

Updated iOS SDK to version 3.18.0

Version 3.20.4 – September 24, 2024 #

Changed

Updated iOS SDK to version 3.17.0

Version 3.20.3 – September 20, 2024 #

Changed

Added defensive code on an internal setState call to check the mounted state of the widget and
avoid potential crashes.

Version 3.20.2 – September 18, 2024 #

Changed

Updated iOS SDK to version 3.16.0

Version 3.20.1 – September 16, 2024 #

Changed

Updated Android SDK to version 3.17.0

Version 3.20.0 – September 10, 2024 #

Fixed

Fixed a bug that displayed a blank screen on the map when using Flutter TabControllers and the parameter persistUnderlyingWidget was set to true.

Changed

Changed the parameter MapView#onError to be optional. This avoids compatibility breaks.

Version 3.19.1 – September 09, 2024 #

Changed

Updated iOS SDK to version 3.15.4

Version 3.19.0 – September 03, 2024 #

Changed

Added support for error handling sent from map-viewer via Postmessage API:
- New class MapViewError to represent received errors from map-viewer.
- New onError callback to support errors, used as attribute for Mapview class.
- First and only error type handled for now: NoNetworkError.

Version 3.18.2 – August 29, 2024 #

Changed

Updated iOS SDK to version 3.15.3

Version 3.18.1 – August 23, 2024 #

Changed

Updated Android SDK to version 3.16.2

Version 3.18.0 – August 20, 2024 #

Added

New action selectFloor to select a floor in the map given its ID and optionally if it must fit the camera to his size or not.

Version 3.17.5 – August 14, 2024 #

Changed

Updated iOS SDK to version 3.15.2

Version 3.17.4 – August 09, 2024 #

Changed

Refactor offline screen UI.

Fixed

Fixed some bug that caused the Android native Webview error screen to be displayed for a couple of milliseconds under certain circumstances.

Version 3.17.3 – August 08, 2024 #

Changed

Updated iOS SDK to version 3.15.1

Version 3.17.2 – August 07, 2024 #

Changed

Improve how openUrlInDefaultBrowser(url) handles urls with pdfs.

Version 3.17.1 – August 07, 2024 #

Changed

Updated Android SDK to version 3.16.1

Version 3.17.0 – July 31, 2024 #

Added

Added actions selectCar and navigateToCar to be able to perform actions over the saved Find My Car point on the map.

Version 3.16.7 – July 23, 2024 #

ℹ️ NOTE: This version adds support for the new navigation callbacks introduced in the Map Viewer 1.99.0 version.

Make sure you update to this new 3.16.7 version, otherwise onNavigationStart(), onNavigationProgress(), onNavigationDestinationReached(), onNavigationCancellation(), onNavigationOutOfRoute() won’t work at all.

In case you want to still use these callbacks in a previous version, contact us at support@situm.com.

Changed

New navigation engine. When MapView is present, you will be using the navigation of the MapView instead of the SDK navigation. This type of navigation improves routes, indications and performance.
Updated iOS SDK to version 3.15.0

Version 3.16.6 – July 22, 2024 #

Changed

Updated Android SDK to version 3.16.0

Version 3.16.5 – July 16, 2024 #

Changed

Android SDK Update: Upgraded the Android SDK to version 3.15.0. This version includes significant changes to the behavior of the Android Foreground Service Notification. For detailed information, refer to the Android SDK 3.15.0 release notes and the SDK API reference documentation for the new methods and updated behavior.

Added

Added a new attribute tapAction to ForegroundServiceNotificationOptions to configure the behavior when tapping the Foreground Service Notification displayed when useForegroundService is set to true in your LocationRequest (or remote configuration). As you may already know, this new attribute only affects Android devices. There are three predefined behaviors:
- launchApp (default): Launches the app’s main activity using the information returned by PackageManager#getLaunchIntentForPackage(String).
- doNothing: No action is taken when the notification is tapped.
- launchSettings: Launches the operating system settings screen for the current app.

Version 3.16.4 – July 08, 2024 #

Changed

Updated iOS SDK to version 3.14.1

Version 3.16.3 – July 04, 2024 #

Changed

Updated iOS SDK to version 3.14.0

Version 3.16.2 – June 28, 2024 #

Added

Added the Android implementation for SitumSdk#addExternalArData(data). When combined with the motion mode BY_FOOT_VISUAL_ODOMETRY, the SDK will utilize visual odometry from the camera, if available. The SDK does not access the camera internally, so to enable this motion mode, you must inject the readings using the new method.
This method is intended for internal use, don’t use it as it may change in future releases.

Changed

Updated Android SDK to version 3.14.0

Version 3.16.1 – June 26, 2024 [Stable] #

Changed

Updated iOS SDK to version 3.13.2

Version 3.16.0 – June 26, 2024 #

Added

Introduced a new class, ErrorCodes, to facilitate error handling when using situmSdk.onLocationError(e).
Introduced the setUserPass(user, pass) method to authenticate using a username and password, as an alternative to an API key. This method is intended for internal use, you’ll probably want to use setApiKey(apiKey).
Introduced the logout() method to invalidate the user token and remove it from internal credentials if it exists.
Added new parameters to the LocationRequest:
- useBle and useGps for both Android and iOS.
- useWifi, exclusively for Android.
Introduced the reload() method in MapViewController. This method refreshes the MapView by reloading the underlying platform web view controller with the original configuration.
Made the openUrlInDefaultBrowser(url) method publicly accessible. This method opens the specified URL in the system’s default browser, useful for common use cases like handling Poi description interactions.
Added methods to manage calibration mode on the MapView, intended for internal use only.

Changed

Specifying the Situm repository in your build.gradle file is no longer necessary. This plugin has automatically configured it for you.

Version 3.15.3 – June 10, 2024 #

Changed

Updated iOS SDK to version 3.13.1

Version 3.15.2 – June 05, 2024 #

Changed

Updated iOS SDK to version 3.13.0

Version 3.15.1 – June 04, 2024 #

Changed

Updated Android SDK to version 3.13.2

Version 3.15.0 – May 30, 2024 #

Added

Implement support to handle ui.speak_aloud_text message in wayfinding widget.
Add reference implementation to use flutter_tts to speak aloud these messages.

Version 3.14.0 – May 29, 2024 #

Changed

BREAKING CHANGE: Now setDirectionsOptions() uses as parameter the MapViewDirectionsOptions interface. You can use the snippet given on the method documentation.

Version 3.13.6 – May 15, 2024 #

Changed

Updated Android SDK to version 3.13.1

Version 3.13.5 – May 10, 2024 #

Changed

Updated iOS SDK to version 3.12.0

Version 3.13.4 – May 03, 2024 #

Changed

Updated Android SDK to version 3.13.0

Version 3.13.3 – April 26, 2024 #

Added

Added device ID to the user interaction events sent (when the user interacts with the MapViewer).

Version 3.13.2 – April 25, 2024 #

Changed

Updated iOS SDK to version 3.11.0

Version 3.13.1 – April 22, 2024 #

NOTE: This version of the SDK requests version Flutter 3.10/Dart 3.0 onwards to work.

Changed

Updated webview_flutter_wkwebview dependency to version 3.10.2. This change allows the plugin to inspect webviews.

Version 3.13.0 – April 12, 2024 #

Added

Added a new method MapViewController.search(SearchFilter) that performs a search on the Map Viewer using the given SearchFilter. SearchFilter allows you to specify:
- text: text used in the search to filter and display the search results whose name or description matches the filter.
- poiCategoryIdentifier: a PoiCategory identifier used to filter and display the POIs that belong to the given category.

Version 3.12.3 – April 02, 2024 #

Changed

Updated iOS SDK to version 3.10.0
OnNavigationDestinationReachedCallback function changed, now it has SitumRoute as a parameter. You need to make a small change when setting this callback. You need to do it like this:

situmSdk.onNavigationDestinationReached((route) {})

Version 3.12.2 – April 02, 2024 #

Changed

Updated iOS SDK to version 3.9.0

Version 3.12.1 – April 01, 2024 #

Changed

Updated Android SDK to version 3.12.0

Version 3.12.0 – March 25, 2024 #

Added

Added the following options to the LocationRequest:
- OutdoorLocationOptions: configures the Global Mode options. Now you can use enableOutdoorPositions to specify if the SDK will notify (or not) outdoor locations through your onLocationUpdate callback.
- realtimeUpdateInterval: allows to specify whether the computed locations should be sent to Situm Platform, and if so with which periodicity (time interval).

Version 3.11.17 – March 18, 2024 #

Added

Added new method MapViewController.setDirectionsOptions(). This method is used to define the options that the routes calculated by the MapView will use. This method processes two lists of strings, includedTags and excludedTags.

Changed

Updated iOS SDK to version 3.8.5

Version 3.11.16 – March 14, 2024 #

Changed

Updated Android SDK to version 3.11.2

Version 3.11.15 – March 12, 2024 #

Changed

Updated iOS SDK to version 3.8.4

Version 3.11.14 – March 11, 2024 #

Changed

Updated iOS SDK to version 3.8.3

Version 3.11.13 – February 23, 2024 #

Changed

Fixed example app to remove the need of BLE permission in Info.plist (BLE permission is no longer needed in iOS).
Updated iOS SDK to version 3.8.2

Version 3.11.12 – February 21, 2024 #

Changed

Updated iOS SDK to version 3.8.1

Version 3.11.11 – February 21, 2024 #

Changed

Updated Android SDK to version 3.11.1

Version 3.11.10 – February 20, 2024 #

Changed

Updated iOS SDK to version 3.8.0

Version 3.11.9 – February 16, 2024 #

Changed

Updated Android SDK to version 3.11.0

Version 3.11.8 – February 16, 2024 #

Changed

Updated iOS SDK to version 3.7.2

Version 3.11.7 – February 15, 2024 #

Changed

Updated Android SDK to version 3.10.2

Version 3.11.6 – February 09, 2024 #

This version contains a bug in iOS navigation and shouldn’t be used. Use version 3.11.8 onwards instead to avoid this issue.

Changed

Updated iOS SDK to version 3.7.1

Version 3.11.5 – February 08, 2024 #

Fixed

Fixed an error introduced in version 3.11.4, produced when the MapViewController forwards positioning Errors (e.g. Location Service disabled) from SitumSdk to the MapView.

Changed

Minor cosmetic changes in the example application.

Version 3.11.4 – February 02, 2024 #

This version contains a bug already fixed in version 3.11.5.

Changed

Updated Android SDK to version 3.10.1.
Added definitions to internally manage communication between SitumSdk, MapView, and the new AR module. This significantly reduces the integration complexity of the AR module.

Version 3.11.3 – January 30, 2024 #

Changed

Updated Android SDK to version 3.10.0

Version 3.11.2 – January 30, 2024 #

Changed

Updated iOS SDK to version 3.7.0

Version 3.11.1 – January 18, 2024 #

Changed

Downgraded iOS SDK to version 3.5.0

Fixed

Fixed a bug that prevented the display of POI information on iOS when this information is defined within an iframe.

Version 3.11.0 -January 15,2024 #

Added

New methods to enable graceful integration of the new AR module with this plugin (the AR module is still a work in progress):
- updateAugmentedRealityStatus to communicate the state of the AR module to the MapView.
- internalARMessageDelegate to receive internal messages from the MapView.

Version 3.10.4 -January 12,2024 #

Changed

Updated Android SDK to version 3.9.3

Version 3.10.3 -December 20,2023 #

Versions 3.10.3, 3.10.2 and 3.10.1 contain a bug in navigation and shouldn’t be used. We’re working to fix it. Please stick to previous versions.

Changed

Updated iOS SDK to version 3.6.0

Version 3.10.2 -December 20,2023 #

Changed

We have implemented a one-second maximum frequency limit for navigation updates. This improves performance by preventing multiple updates per second, especially when dead reckoning is active.
- If you were using the closest location in route from the NavigationProgress, take into account that this location will be updated at a maximum of 1 per second as well. If you want to have faster orientation updates, you’ll have to mix this position with the orientation of the location received in the LocationListener.
Updated Android SDK to version 3.9.2

Version 3.10.1 -December 19,2023 #

Changed

Updated Android SDK to version 3.9.1

Version 3.10.0 -December 18,2023 [Stable] #

Added

New callback onExternalLinkClicked to get notified when an external link is clicked in the MapView. If this callback is not set, the link will be opened in the system’s default browser by default.

Version 3.9.5 -December 12,2023 #

Changed

Updated Android SDK to version 3.9.0

Version 3.9.4 -December 12,2023 [Stable] #

Changed

The callbacks for POI selection and deselection have been restored for iOS.
Updated iOS SDK to version 3.5.0

Version 3.9.3 -December 11,2023 #

Changed

Updated iOS SDK to version 3.5.0

Version 3.9.2 -November 28,2023 #

Changed

Updated iOS SDK to version 3.4.0

Version 3.9.1 -November 27,2023 #

Added

Added iconSelected and iconUnselected fields to PoiCategory for both Android and iOS platforms.
Added new parameters to the LocationRequest object used to setup the positioning options:
- useForegroundService: to control whether or not to start positioning in an Android Foreground Service (see Foreground & Background execution guide for details).
- foregroundServiceNotificationOptions: to customize the notification shown in the system tray for the aforementioned Foreground Service, including:
  - The notification title and message.
  - A new “stop” button to stop positioning from the notification UI.
iOS devices will ignore the new parameters.

Changed

Updated Android SDK to version 3.8.0

Version 3.9.0 – November 22, 2023 #

Added

Added a new parameter MapViewConfiguration.language. This parameter allows to set the UI language based on the given ISO 639-1 code. Checkout Situm docs to see the list of supported languages.

Version 3.8.2 -November 20,2023 #

Changed

Updated Android SDK to version 3.7.0

Version 3.8.1 -November 15,2023 #

Fixed

The callbacks for POI selection and deselection have been restored for Android (pending iOS).

Changed

Updated Android SDK to version 3.6.0

Version 3.8.0 -November 08,2023 #

Added

New method MapViewController#selectPoiCategory to programmatically select a POI Category in the map.

Fixed

Now the DirectionsRequest object received at MapViewController#onDirectionsRequestInterceptor
contains updated information about the origin and destination of the requested route.

Version 3.7.0 -November 08,2023 #

Added

Added a new parameter MapViewConfiguration.persistUnderlyingWidget. When set to true, the underlying WebView will persist over MapView disposals. As a consequence, the WebView widget will not be reloaded even when the MapView widget is disposed or rebuilt. This will lead to improved performance in cases where the WebView‘s content remains consistent between widget rebuilds.
However, it also means that the WebView may persist in memory until the entire Flutter application is removed from memory.

Fixed

Fixed a crash occurred when the plugin is attached/detached repeatedly.

Version 3.6.6 -November 06,2023 #

Changed

Updated iOS SDK to version 3.3.0

Version 3.6.5 -November 06,2023 #

Changed

Updated Android SDK to version 3.5.3

Version 3.6.4 -October 31,2023 #

Changed

Updated Android SDK to version 3.5.2

Version 3.6.3 -October 30,2023 #

Changed

Fixed an issue related to the interaction with the firebase_messaging plugin. When using onBackgroundMessage, the plugin was previously encountering a problem where it triggered a reinitialization via onAttachedToEngine. This issue caused the loss of messages sent through method channels. This update includes a fix to ensure the proper handling of messages in scenarios involving the firebase_messaging plugin.

Version 3.6.2 -October 27,2023 #

Changed

Updated iOS SDK to version 3.2.3
From this version routes behave the same, both on Android and iOS.

Version 3.6.1 -October 26,2023 #

Changed

Updated Android SDK to version 3.5.1

Version 3.6.0 -October 26,2023 #

Added

Sending location status update to mapviewer as an independent call from location to allow new related visual features

Version 3.5.7 -October 25,2023 #

Changed

Updated Android SDK to version 3.5.0

Version 3.5.6 -October 19,2023 #

Changed

Updated Android SDK to version 3.4.0

Version 3.5.5 -October 19,2023 #

Changed

Updated iOS SDK to version 3.2.2

Version 3.5.4 -October 18,2023 #

Changed

Updated iOS SDK to version 3.2.1

Version 3.5.3 -October 17,2023 #

Changed

Updated Android SDK to version 3.3.1

Version 3.5.2 -October 11,2023 #

Changed

Updated Android SDK to version 3.3.0

Version 3.5.1 -October 11,2023 #

Changed

Updated iOS SDK to version 3.2.0

Temporary disruption: the POI selection callback has been temporarily affected in this release. Rest assured, our team is actively working to resolve this issue promptly, and a fix will be provided in an upcoming update.

Version 3.5.0 -October 09,2023 #

Added

New parameter MapViewConfiguration.lockCameraToBuilding(). When set to true, the camera will be locked to the building so the user can’t move it away
New MapViewController.setCamera() animate the map’s camera and modify its zoom, bearing, pitch, …
New callbacks that enable the possibility to receive messages on certain navigation events (onNavigationStart and onNavigationCancellation) on iOS devices. As a developer now you can notify your app of these events and can also customize it to perform custom logic. On Android they were already implemented since version 3.3.2.

Version 3.4.3 -October 03,2023 #

Fixed

Fix to support unfollow user actions

Version 3.4.2 -September 29,2023 #

Changed

Updated iOS SDK to version 3.1.0

Version 3.4.1 -September 28,2023 #

Added

New screen displayed when there is no network connection and the map-viewer wasn’t cached yet.

Version 3.4.0 -September 22,2023 #

Added

New Error.type parameter that indicates whether the error received from onLocationError() will stop positioning or not.

Changed

Unified some native errors from the Android and iOS SDKs. See new Error class documentation.

Version 3.3.3 -September 21,2023 #

Changed

Updated iOS SDK to version 3.0.3

Version 3.3.2 -September 21,2023 #

Added

Added new callbacks to SitumSdk. These callbacks are especially useful for detecting events originated at the MapView:
- onNavigationStart to receive notifications when navigation starts (only working in Android right now).
- onNavigationCancellation to get notified when a route is cancelled (only working in Android right now).
- onDirectionsRequested for receiving notifications when a route has been requested.

Changed

Renamed onNavigationFinished as onNavigationDestinationReached to
differentiate it from the new callback onNavigationCancellation.
Updated Android SDK to version 3.2.0

Version 3.3.1 -September 20,2023 #

Added

New options to select and navigate to a POI in the example application.

Changed

We have harmonized the notification of states on both platforms, Android and iOS. Now, the onLocationStatus callback uniformly returns the following states:
- STARTING: this status will be sent once when the SDK starts calculating the user’s location, as soon as the native SDKs receives a call from requestLocationUpdates(…).
- STOPPED: sent when the positioning stops. This will happen on calls to removeUpdates() but also when a critical error that prevents the correct operation of the SDK is detected.
- USER_NOT_IN_BUILDING: you will receive this status in Building mode when the SDK cannot locate the user in the specified building.
- The specific states of each platform (not common) continue to be notified as before.

Fixed

Fixed an error “Building not found” produced when the LocationRequest received an empty (default) buildingIdentifier. Now, entering an empty identifier causes the SDK to use the remote configuration, as expected.

Version 3.3.0 -September 08,2023 #

Added

Added a new method MapViewController#navigateToPoint(lat, lng, floorIdentifier) that starts navigation to the given point.

Version 3.2.3 -September 06,2023 #

Changed

Updated iOS SDK to version 3.0.2

Version 3.2.2 -September 05,2023 #

Fixed

Fixed a problem in version 3.2.1 that produced compilation errors in Android.

Version 3.2.1 -September 05,2023 #

This version contains a known error, use 3.2.2 instead.

Changed

Updated Android SDK to version 3.1.2

Version 3.2.0 -September 05,2023 #

Added

Added onPoiDeselected callback to get notified when the user deselects a POI.
Added new action methods to MapViewController:
- selectPoi(String identifier) to select the given POI in the map.
- navigateToPoi(String identifier, {AccessibilityMode? accessibilityMode}) to
  programmatically start navigation to the given POI, with the (optional) desired route type.
- cancelNavigation() to cancel the current navigation, if any.
- setLanguage(String lang) to set the UI language based on the given ISO 639-1
  code.
- followUser() and unfollowUser() to keep the map camera centered on the user
  position (and stop doing so).

Fixed

Fixed an issue where the remote config was consistently being overwritten with local
(default) parameters.
Fixed an inconsistency in behavior between Android and iOS when setting the global positioning
mode using the identifier “-1”, which is standard to the Android SDK but produced errors in iOS. Now both platforms respects the “-1” identifier and can be used to set the global positioning mode.

Changed

Now the MapViewConfiguration options buildingIdentifier and remoteIdentifier can be used together to combine the functionalities. If both parameters are specified, remoteIdentifier takes precedence.
Now the load callback waits for the underlying map-viewer message app.map_is_ready.

Version 3.1.2 -September 04,2023 #

Changed

Updated Android SDK to version 3.1.1

Version 3.1.1 -August 28,2023 #

Fixed

Fixed green-dot and grey-dot positioning states not displaying correctly.
Fixed follow-user functionality not working when the location was outside the current building bounds.

Version 3.1.0 -August 25,2023 #

Added

Added setApiKey(situmApiKey) method. Use it to authenticate yourself after initializing our SDK with init().
Added new method setDashboardURL(url) in SitumSdk. In order to use correctly this method, you should call respectively init(), setDashboardURL() and then setApiKey(situmApiKey).
Added MapViewConfiguration.apiDomain. When using setDashboardURL(), make sure you introduce the same domain.

Changed

Refactor init() method, its parameters are now optional. In case you don’t declare its paremeters you won’t authenticate, just initialize our SDK. In future versions parameter usage will be deprecated.
Renamed MapViewConfiguration.baseUrl to viewerDomain.
- WARNING: This version breaks compatibility with previous versions. Ensure to rename this parameter.

Version 3.0.6 -August 09,2023 #

Changed

Updated iOS SDK to version 2.62.0

Version 3.0.5 – August 04,2023 #

Changed

Updated Android SDK to version 3.1.0

Version 3.0.4 – August 03,2023 #

Changed

Updated plugin dependencies (and also the example app dependencies).

Fixed

Fixed SitumSdk navigation callbacks being incorrectly overwritten when using the Wayfinding module.
Fixed PlatformWebViewWidget being instantiated repeatedly, causing inconsistent behavior in different versions of webview_flutter_android.

Version 3.0.3 – July 26,2023 #

Changed

Now the native layer subscribes to location updates as soon as the plugin is initialized.
This does not mean that the positioning is started. This change makes it easier to handle
background/foreground transitions.

Fixed

Fixed an error that produced missing native messages while navigating, after the app transitions
to background and back again to foreground (Android).

Version 3.0.2 – July 20, 2023 #

Changed

Updated iOS SDK to version 2.61.1
Updated Android SDK to version 3.0.1

Version 3.0.0 – July 10, 2023 #

Introducing the new situm_flutter.

We are thrilled to announce the release of situm_flutter, a remarkable evolution and improvement upon our previous library, situm_flutter_wayfinding. With this update, we are taking a leap forward to provide you with a future-ready solution.

We’ve been listening to our customers’ feedback, and we have incorporated a wide range of enhancements based on your valuable input. Checkout the Situm page for further details.

As this library includes significant changes, compatibility with previous versions has been broken. We understand that transitioning to a new library may require some adjustments. To facilitate a smooth migration process, we have prepared comprehensive documentation:

We are incredibly grateful for your continued support and trust in our library. situm_flutter represents our commitment to empowering developers with the most advanced tools and ensuring a brighter future for your software development endeavors.

Thank you for being part of this exciting journey with us!

Added

The new situm_flutter introduces a new visual component, MapView, to provide interactive maps within your application. The MapView allows you to show indoor maps of your buildings on your app! It is a fully interactive Flutter Widget with improved capabilities:
- Intuitive Guidance with Dynamic and Static Navigation.
- Advanced POI Display Based on Zoom Level and Density.
- “What’s Nearby” Exploration Made Easy with Category & Subcategory Filtering, and POI search.
- POI information visualization.
- Tailored User Experience with High Configurability.
- Out of the box support for raster floorplans, raster tiles and GeoJSON/IMDF floorplans.
- Multilingual Interface.
- This new version lays the foundation for future improvements, specifically enabling full 3D maps and even augmented reality capabilities.

Added new positioning callbacks: onLocationUpdate(), onLocationStatus() and onLocationError(). These callbacks are a replacement for the previous LocationListener.
Added Location class. Now the callback onLocationUpdate() will receive coordinates, bearing
and more info at every location update.
Added a new method requestDirections(…) to calculate a route between two points.
Added a new method requestNavigation(…) to calculate a route and start receiving navigation updates over that route. Also added the method stopNavigation().
Added navigation callbacks: onNavigationFinished(), onNavigationProgress() and onNavigationOutOfRoute() to receive navigation updates.

Fixed

Fixed an error that produces missing error messages at onLocationError(), on iOS.

Updated on 08/04/2025