01 – Android WYF Changelog

While this library will continue to receive support and maintenance, we strongly encourage you to consider transitioning to Situm SDK 3.0 for new projects or when updating existing ones. Situm SDK 3.0 includes a new visual component, MapView, providing an enhanced experience for both final user and developer.
To stay up to date, checkout the Android SDK Changelog and visit the migration guide to ease the transition to the new library.

Version 0.27.9-alpha – October 31 2023 #

Fix

• Corrected some strings in polish translation.

Version 0.27.8-alpha – October 16 2023 #

Added

• New polish translation.

Changed

• Updated SDK to version 3.3.1.

Version 0.27.7-alpha – September 12 2023 #

Changed

• Updated SDK to version 3.1.2

Version 0.27.4-alpha – June 12 2023 #

Changed

• Updated SDK to version 2.87.0.

Version 0.27.3-alpha – May 25 2023 #

Changed

• Updated SDK to version 2.86.3.
• Optimized the way big building floorplans are scaled. In the past, if their resolution was greater than 12M pixels (aprox), they were greatly downsized to protect the app against out of memory errors (that happened frequently in low-end devices). Now, floorplan resolution is almost preserved, since new devices do not exhibit those memory restrictions.

Version 0.27.2-alpha – May 15 2023 – [Stable] #

Changed

• Updated SDK to version 2.86.2

Version 0.27.1-alpha – May 10 2023 #

Changed

• Updated SDK to version 2.86.1
• Project position in route if its distance to the route is below NavigationRequest.outsideRouteThreshold.

Version 0.27.0-alpha – May 8 2023 #

Changed

• Updated SDK to version 2.86.0

Version 0.26.2-alpha – May 5 2023 #

Changed

• Updated SDK to version 2.85.3.

Version 0.26.1-alpha – March 21 2023 – [Stable] #

Fixed

• Fixed an error that set the user on the last known location even after the module is unloaded and loaded again.
• Fixed routes not being calculated when requested immediately after the positioning is started.

Changed

• Now the “obtaining position” progress indicator hides automatically after 4 seconds.
• Now WYF displays a FAB (Floating Action Button) when there is no position available. This FAB replaces a repetitive toast that now only appears when the user clicks on the aforementioned FAB.

Version 0.26.0-alpha – March 3 2023 #

Added

• Wayfinding now implements methods to add and remove custom POIs (CustomPoi) on the map.
  • SitumMapsLibrary#startCustomPoiCreation(…): launches CustomPoi creation mode, allowing the user to select and save an arbitrary point on the map.
  • SitumMapsLibrary#getCustomPoi(…): return the last stored CustomPoi or null if no CustomPoi is stored.
  • SitumMapsLibrary#removeCustomPoi(…): deletes the stored CustomPoi.
  • SitumMapsLibrary#selectCustomPoi(…): selects the stored CustomPoi and centers it on the map (and floor).

Changed

• Updated Situm SDK to version 2.85.0.
• From now on WYF will never stop positioning on calls to SitumMapsLibrary#unload().
• Performed internal refactors that improve stability in cases where the SDK and WYF coexist.

Fixed

• Fixed an error produced when calling load() immediately after unload() at SitumMapsLibrary.

Version 0.25.0-alpha – February 14 2023 #

Added

• Until now, Wayfinding started and stopped the positioning internally. Any positioning session previously launched with the SitumSdk had to be restarted so that Wayfinding could access the position updates. Now Wayfinding uses the new LocationManager#addLocationListener(LocationListener) method to subscribe to the SitumSdk positioning. If it is already running, Wayfinding will draw the user position immediately and will not need to restart positioning anymore. Wayfinding will react accordingly at any time if the positioning stops or starts from outside (using the SitumSdk API directly).
• Added support for Portuguese.

Changed

• Updated SDK version to 2.84.0.

Version 0.24.2-alpha – February 2 2023 #

Updated

• Now the navigation UI adapts to the organization colors defined in the dashboard. We also have improved some UI elements:
  • The cross button that allows you to cancel navigation is now bigger.
  • The estimated time and arrival panel is now correctly centered horizontally.
• The icon that indicates floor changes over the map during navigation is also tinted with the dashboard primary color.
• Increased the opacity of the path during navigation.
• Now LibrarySettings#setShowPoiNames(bool) defaults to true.

Version 0.24.1-alpha – January 19 2023 #

Added

• Hebrew translation.

Version 0.24.0-alpha – January 12 2023 #

Changed

• Now you can start positioning using only indoor gps sensor, you no longer need to have BLE or WiFi enabled. Note that if you try to use this in a building not prepared to work with uncalibrated gps mode you won’t get any location.
• Initial permission requests were removed.
• Changed some default values for certain params, please check the documentation for more information:
  • useRemoteConfig = TRUE
  • enablePoiClustering = TRUE
  • useDashboardTheme = TRUE
• ‘situm.es’ urls to ‘situm.com’
• SDK version upgraded to 2.83.5.

Fixed

• Bluetooth permissions dialog (Nearby devices) does not appear when is not required.
• WifiPositioningAlert does not appear when is not required.
• USER_NOT_IN_BUILDING toast does not disappear instantly.

Version 0.23.0-alpha – December 27 2022 #

Changed

• target & compile versions upgraded to api 33.
• Some deprecated methods were refactored.
• Updated Situm SDK to version 2.83.3.

Version 0.22.2-alpha – December 16 2022 #

Updated

• Updated Situm SDK to version 2.83.2. This version fixes a Zip Path Traversal vulnerability. The Zip Path Traversal vulnerability is related to handling compressed archives and may prevent your app to be published on Google Play. The method fetchTilesFromBuilding(…) introduced the vulnerability in the SDK version 2.82.1 as it downloads and uncompresses a Zip file containing all the building map tiles. We have followed the documentation and now the vulnerability was completely fixed.

Version 0.22.1-alpha – December 14 2022 #

Added

• Added Turkish translations.

Updated

• Updated Situm SDK to version 2.83.1.

Version 0.22.0-alpha – December 07 2022 #

Added

• Added new methods setMaxZoom and setMinZoom at LibrarySettings to control the min and max zoom level of the underlying map. Both methods inherit all the technical considerations that applies to the map (see the documentation for more information). We are making this method compatible with SitumMapsLibrary#enableOneBuildingMode() so you can combine to limit the map as required.

Version 0.21.1-alpha – December 05 2022 #

Added

• Added a new feature to download map tiles for a specific building. Tiles allow you to upload really large floorplans while maintaining a high display quality. Calling this method you will download all the tiles of your building and it will work offline. Have in mind that by default the buildings don’t have tiles.

Changed

• Now if a floor has a name, it will be showed instead of the floor number when you select a POI and in the search bar results

Version 0.21.0-alpha – November 25 2022 #

Added

• Now Situm WYF is compatible with Flutter PlatformViews!
• Added a new method OnNavigationListener#onNavigationStarted(). This method is required and breaks compatibility in previous implementations of OnNavigationListener. If that is your case, just implement the new method:

  ...
  void onNavigationStarted(Navigation navigation) {
      // Do your stuff.
  }
  ...

• Added a new method SitumMapsLibrary#filterPoisBy(List<String>) to filter the POIs shown on the map using the POI categories.
  • This method was implemented ensuring the compatibility with SitumMapsLibrary#selectPoi(): the selected POI is always shown on the map regardless of the category it belongs to.
• Added custom message to the SDK error MISSING_LOCATION_PERMISSION.
• Added support for top-level-pois using the key top_level with value true or false (default). Top level POIs never get clustered regardless of the map zoom level.
  • In the dashboard, edit your POI, adding the top_level custom field with value true.
  • Now, even if you enable POI clustering in WYF, the annotated POI will never be clustered.
• Added the method SitumMapsLibrary#enableOneBuildingMode(buildingId, callback) that limits the map to the given building bounds. This new override receives a callback as parameter to get notified when the action concludes.
• Added a method to center the map camera on a building using only the building identifier (instead of the Building object) SitumMapsLibrary#centerBuilding(buildingId, callback).

Modified

• Updated Situm SDK to version 2.82.0.
• Changed the minimum zoom level required to show the indoor building map (and also the floor selector) from 16 to 15. The minimum initial zoom level also changed from 16 to 15.
• Modified the icon used to indicate floor changes in routes.
• The average walking speed used to calculate the estimated time in routes was increased from 1m/s to 1.4m/s.
• Replaced material FAB buttons in WYF with AppCompatImageButtons to avoid crashes in Flutter:

  signal 6 (SIGABRT), code -6 (SI_TKILL) Trying to start new animators on 0x7f7d57e000 (RippleDrawable) without an animation handle!

• Replaced raster images with vector drawables to avoid AppCompatImageButton issues.
• Updated some strings in translation files.
• Now the POI icons (and text) keep the same size across different pixel densities.

Fixed

• Optimized POI drawing during navigation.
• Fixed startPositioning() causing POIs to be hidden if called immediately after onSuccess() and centerBuilding/enableOneBuildingMode.

Removed

• Removed the “Save as Favourite” dialog displayed when a long press was performed over the map.

Version 0.20.0-alpha – October 04 2022 #

Added

• New method SitumMapsLibrary.setShowNavigationIndications() to enable/disable the indications while navigating.

Changed

• SDK version upgraded to 2.80.1

Version 0.19.1-alpha – September 26 2022 #

Changed

• Floor level picker now shows the organization theme colors if ‘use account theme’ is enabled.

Version 0.19.0-alpha – September 19 2022 #

Added

• Added RTL (right-to-left) navigation support.
• Added Arabic translations.

Changed

• Updated Situm SDK’s version to 2.79.2.

Version 0.18.0-alpha – August 11 2022 #

Added

• New functionality External provider locations. You can learn more about it in our documentation

Fixed

• Bug with the accesible routes. They now work as intended

Version 0.16.0-alpha – July 08 2022 #

Added

• Added marker clustering for POIs.
  
• Added a new method setEnablePoiClustering(boolean) in LibrarySettings to enable or disable marker clustering for POIs. The default value is false.

Version 0.15.3-alpha – June 22 2022 #

Changed

• Non-relevant markers are now hide during a route for better visibility and simplicity

Version 0.15.2-alpha – April 18 2022 #

Changed

• The user is now centered in the map after requesting navigation indications.
• Modified the default navigation parameters:
  • Indications interval changed from 10s to 30s.
  • Distance to change indication moved from 0m to 15m.
  • Flag to ignore low quality locations now defaults to false.

Version 0.15.1-alpha – March 31, 2022 #

Fixed

• Fix problem with the buttons of the module, sometimes you couldn’t interact with them. This was caused because we were using a deprecated Android lifecycle callback.
• Fix crash when returning to the app from background that happened sometimes. This happened for the same reason as the previous one

Version 0.15.0-alpha – March 24, 2022 #

Removed

• Removed park labels from Google Maps layer.
• The Situm geofences will not be displayed anymore on the map.

Changed

• Now the Text-To-Speech button that enables or disables turn by turn spoken indications during navigation is no longer visible.
• Turn by turn spoken indications are now disabled.

Version 0.14.0-alpha – March 22, 2022 #

Added

• New method setShowPoiNames(boolean) in LibrarySettings that allows to always show the names anchored to the icon of the corresponding poi. By default it’s false and it will not show the names

Version 0.13.0-alpha – March 11, 2022 #

Removed

• Floor plans can now be displayed as tile overlays in the map.

Version 0.12.1-alpha – March 04, 2022 #

Removed

• Removed popups containing information about events and geofences during positioning.

Version 0.12.0-alpha – February 24, 2022 #

Changed

• Renamed method setOnFloorSelectedListener(OnFloorChangeListener listener) to setOnFloorChangeListener(OnFloorChangeListener listener) in class SitumMap.
• Renamed method setOnPoiSelectedListener(OnPoiSelectedListener listener) to setOnPoiSelectionListener(OnPoiSelectionListener listener) in class SitumMap.
• Renamed method centerPoi(Poi poi) to selectPoi(Poi poi) in class SitumMap.
• Renamed method centerPoi(Poi poi, ActionsCallback callback) to selectPoi(Poi poi, ActionsCallback callback) in class SitumMap.
• Renamed class OnPoiSelectedListener to OnPoiSelectionListener.
• Renamed method onPOISelected to onPoiSelected in class OnPoiSelectionListener.

Fixed

• Fixed improper calls to onPoiDeselected callback.

Notes

• If you had this plugin integrated in your project, you will have to refactor the mentioned methods and class names in order to get this new version working properly.

Version 0.11.0-alpha – February 21, 2022 #

Added

• New method stopNavigation() to stop navigating if the user is currently navigating to a Poi or location. This method does nothing if the navigation is not running.
• Added a new interface OnNavigationListener to get notified about navigation events (navigation requested, canceled and destination reached). Navigation and Destination were also added to provide concise information on each callback.

Removed

• OnNavigationListener has been extracted from OnUserInteractionListener to provide a more intuitive api.

Version 0.10.1-alpha – February 16, 2022 #

Changed

• Search bar redesign:

  • Now the search bar has a more modern look with rounded corners.

• The search results panel is now displayed attached to the bar.

  

Version 0.10.0-alpha – February 10, 2022 #

Added

• Added the method setUseRemoteConfig(boolean) to LibrarySettings to start positioning using the Remote Configuration. The default value is false. When this parameter is set to true the local settings will be overwritten.

Changed

• Updated SDK version to 2.73.0.

Version 0.9.2-alpha – January 26, 2022 #

Fixed

• Fixed the missing call to onPoiSelected() when using WYF SitumMapsLibrary#centerPoi() method.

Version 0.9.1-alpha – January 17, 2022 #

Changed

• WYF SitumMapsListener#onSuccess() callback has been internally refactored (greater robustness, easier mainteinance).
• Now SitumMapsLibrary#centerPoi() does not call centerBuilding internally if the given building is already the active one. This avoids annoying visual effects on consecutive calls.
• Updated play-services-maps to version 18.0.2.

Version 0.9.0-alpha – January 7, 2022 #

Changed

• Improved Navigation UX
  • Updated visual styles.
  • Added mute button to toggle audio instructions.
• Update SDK version to 2.72.0
• SDK and WYF library now compile and target sdkVersion 31 (Android 12).
• The minimum supported version has been updated to sdkVersion 21 (Android 5.0). Official support has been withdrawn more than one year ago.
• A large amount of the library’s dependencies have been updated to their latest versions.

Warning: Two new runtime permissions are required to guarantee the WYF library functions correctly: android.permission.BLUETOOTH_SCAN and android.permission.BLUETOOTH_CONNECT. These permissions must be requested at runtime just like android.permission.ACCESS_FINE_LOCATION, for most SDK functionality involving bluetooth.

Warning: For this version of the WYF library to work properly on Android 12 devices and above, the host app must target android api 31 or above.

Version 0.8.5-alpha – December 1, 2021 #

Added

• Added findRouteToLocation(Floor, lat, lng) method to find a route to a given location.
• Added a new progress indicator in the map view while waiting for the first location to be
  received.

Changed

• Updated SDK version to 2.71.2.
• Now findRouteToPoi() can be called immediately after the library load success callback. The same
  applies to findRouteToLocation().
• Now the button “center view” used to center the user position in the map is decorated with the
  primary color of your organization theme. The icon also gets updated using userPositionArrowIcon if exists.
• The “obtaining position” message will not be displayed in the info panel anymore.

Fixed

• Fixed public interface Interceptor being obfuscated.

Version 0.8.4-alpha – November 11, 2021 #

Added

• Added methods in LibrarySettings and SitumMapView to set the user marker from a local asset.
• Now the user position error range circle gets its color from the dashboard when the option useDashboardTheme is set to true. The same applies to the navigation path color.

Changed

• Updated SDK version to 2.70.4.
• The alert dialogs shown after starting positioning are not displayed anymore.

Version 0.8.3-alpha – October 7, 2021 #

• Update SDK to version 2.70.2
• Update default colors and icons according to the new corporate image.
• Update appearance (shape, shadow) of some UI components accordingly.
• Add fade effect on search results.

Version 0.8.2-alpha – April 19, 2021 #

• Update SDK to version 2.68.2
• SDK contains a bug fix detected in the previous version

Version 0.8.1-alpha – April 05, 2021 #

• Update SDK to version 2.68.0

Version 0.8.0-alpha – March 31, 2021 #

• Fixed obfuscation rules
• Update SDK to version 2.67.3

Version 0.7.2-alpha – November 19, 2020 #

• Fix view related crashes

Version 0.7.1-alpha – November 11, 2020 #

• Upgrade compileSdkVersion to 30
• Upgrade targetSdkVersion to 30

Version 0.6.0-alpha – November 03, 2020 #

• Migrated to use androidx support libraries.

Version 0.5.1-alpha – October 16, 2020 #

• Add new method in SitumMapsLibrary to change the geofences colors.
• Add new method in LibrarySettings to select if you want to draw or not the geofences over the map.

Version 0.5.0-alpha – October 08, 2020 #

• Add new method in SitumMapsLibrary to load the module inside a fragment.

Version 0.4.1-alpha – September 25, 2020 #

• Fix TextToSpeech language issues.
• Fix fragment transitions issues that caused incompatibilities with AndroidX apps

Version 0.4.0-alpha – November 25, 2019 #

• Add new method in SitumMapsLibrary to unload the module from the container view
• Add new method in LibrarySettings to set an external GoogleMap to be used by the module
• Fix bug not allowing centering a POI before building was load

Version 0.3.0-alpha – April 29, 2019 #

• Add option to use dashboard theme
• Add charging screen while initialization

Version 0.2.0-alpha – March 15, 2019 #

• Add search bar
• Add option to enable/disable search bar

Version 0.1.0-alpha – February 18, 2019 #

• Initial version