05 – Flutter SDK Changelog

Version 3.3.3 -September 21,2023 #

Changed

• We are pleased to announce that the new version is now available. Detailed updates from our development team regarding the enhancements will be published shortly.
• 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.