05 – Flutter SDK Changelog

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:

• Quickstart guide.
• API reference.
• Migration guide.
• Code example.

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.