04 – React Native SDK Changelog

Version 3.11.8 – September 27, 2024 #

Changed

• Updated Android SDK to version 3.17.1

Version 3.11.7 – September 26, 2024 #

Changed

• Updated iOS SDK to version 3.18.0

Version 3.11.6 – September 24, 2024 #

Changed

• Updated iOS SDK to version 3.17.0

Version 3.11.5 – September 18, 2024 #

Changed

• Updated iOS SDK to version 3.16.0

Version 3.11.4 – September 16, 2024 #

Changed

• Updated Android SDK to version 3.17.0

Version 3.11.3 – September 09, 2024 #

Changed

• Updated iOS SDK to version 3.15.4

Version 3.11.2 – August 29, 2024 #

Changed

• Updated iOS SDK to version 3.15.3

Version 3.11.1 – August 23, 2024 #

Changed

• Updated Android SDK to version 3.16.2

Version 3.11.0 – August 20, 2024 #

Added

• New mapViewRef.selectFloor() function to select a floor in the map given its ID and optionally whether it must fit the camera to the floor size.

Version 3.10.3 – August 14, 2024 #

Changed

• Updated iOS SDK to version 3.15.2

Version 3.10.2 – August 08, 2024 #

Changed

• Updated iOS SDK to version 3.15.1

Version 3.10.1 – August 07, 2024 #

Changed

• Updated Android SDK to version 3.16.1

Version 3.10.0 – July 31, 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.10.0 version, otherwise onNavigationProgress(), onNavigationOutOfRoute(), onNavigationFinished() and onNavigationError() won’t work at all.

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

Added

• New mapViewRef.selectCar() and mapViewRef.navigateToCar() to be able to perform actions over the saved find my car point.
• New onNavigationStart(), onNavigationDestinationReached(), onNavigationCancellation() callbacks for SitumPlugin class.

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.

Version 3.9.3 – July 23, 2024 #

Changed

• Updated iOS SDK to version 3.15.0

Version 3.9.2 – July 22, 2024 #

Changed

• Updated Android SDK to version 3.16.0

Version 3.9.1 – 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.

Version 3.9.0 – July 09, 2024 #

Changed

• BREAKING CHANGE: removed the requestPermission method to eliminate the dependency on react-native-permissions. To continue using the requestPermission method without significant modifications in your project, you can integrate it directly as shown in the example application from the repository:
  1. Copy the file example/src/examples/Utils/requestPermission.tsx.
  2. Modify the imports accordingly.
• It is no longer necessary to specify the Situm repository in your build.gradle file. This plugin has already set it up for you.

Version 3.8.5 – July 08, 2024 #

Changed

• Updated iOS SDK to version 3.14.1

Version 3.8.4 – July 04, 2024 #

Changed

• Updated iOS SDK to version 3.14.0

Version 3.8.3 – June 28, 2024 #

Changed

• Updated Android SDK to version 3.14.0

Version 3.8.2 – June 26, 2024 [Stable] #

Changed

• Updated iOS SDK to version 3.13.2

Version 3.8.1 – June 10, 2024 #

Changed

• Updated iOS SDK to version 3.13.1

Version 3.8.0 – June 06, 2024 #

Changed

• BREAKING CHANGE: removed the status property from the Location interface as it was not consistent with the underlying native SDKs.
• Improved the internal state and error handling of the MapView.

Fixed

• Resolved an issue where the MapView displayed a “position obtained” message even before any positions were received.

Version 3.7.6 – June 05, 2024 #

Changed

• Updated iOS SDK to version 3.13.0

Version 3.7.5 – June 04, 2024 #

Changed

• Updated Android SDK to version 3.13.2

Version 3.7.4 – May 15, 2024 #

Changed

• Updated Android SDK to version 3.13.1

Version 3.7.3 – May 10, 2024 #

Changed

• Updated iOS SDK to version 3.12.0

Version 3.7.2 – May 03, 2024 #

Changed

• Updated Android SDK to version 3.13.0

Version 3.7.1 – April 25, 2024 #

Changed

• Updated iOS SDK to version 3.11.0

Version 3.7.0 – April 25, 2024 #

Added

• Added a new method MapViewRef.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.6.0 – April 17, 2024 #

Added

• New method MapViewRef.setFavoritePois(poiIds). With this method you can set the user’s favorite points of interest. They will be highlighted in the MapViewer.
• New callback MapViewProps.onFavoritePoisUpdated() . This callback will be called whenever there is a change in the user’s favorite points of interest (e.g. when the user saves a new POI as favourite in the MapViewer). In this callback, you will receive an object of type OnFavoritePoisUpdatedResult. This object will contain a list of the user’s current favorite points of interest.

Changed

• Updated react-native to version ^0.72.12 to solve Xcode 15.3 issues.

Version 3.5.16 – April 02, 2024 #

Changed

• Updated iOS SDK to version 3.10.0

Version 3.5.15 – April 02, 2024 #

Changed

• Updated iOS SDK to version 3.9.0

Version 3.5.14 – April 01, 2024 #

Changed

• Updated Android SDK to version 3.12.0

Version 3.5.13 – March 18, 2024 #

Changed

• Updated iOS SDK to version 3.8.5

Version 3.5.12 – March 14, 2024 #

Changed

• Updated Android SDK to version 3.11.2

Version 3.5.11 – March 12, 2024 #

Changed

• Updated iOS SDK to version 3.8.4

Version 3.5.10 – March 11, 2024 #

Changed

• Updated iOS SDK to version 3.8.3

Version 3.5.9 – February 23, 2024 #

Changed

• Updated iOS SDK to version 3.8.2

Version 3.5.8 – February 21, 2024 #

Changed

• Updated iOS SDK to version 3.8.1

Version 3.5.7 – February 21, 2024 #

Changed

• Updated Android SDK to version 3.11.1

Version 3.5.6 – February 20, 2024 #

Changed

• Updated iOS SDK to version 3.8.0

Version 3.5.5 – February 16, 2024 #

Changed

• Updated Android SDK to version 3.11.0

Version 3.5.4 – February 16, 2024 #

Changed

• Updated iOS SDK to version 3.7.2

Version 3.5.3 – February 15, 2024 #

Changed

• Updated Android SDK to version 3.10.2

Version 3.5.2 – February 09, 2024 #

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

Fixed

• Fixed a problem with navigation added in version 3.5.0. Now it works properly again

Version 3.5.1 – February 09, 2024 #

Versions 3.5.1 and 3.5.0 contain a bug in iOS navigation and shouldn’t be used. Use version 3.4.9 instead if you prefer to use older SDK versions, or version 3.5.4 onwards if you prefer to use new ones.

Changed

• Updated iOS SDK to version 3.7.1

Version 3.5.0 – February 09, 2024 #

Added

• New method MapViewRef.setDirectionsOptions(). With this method you can change the route calculated based on tags.
• New interface MapViewDirectionsOptions.

Version 3.4.9 – February 05, 2024 #

Changed

• Updated Android SDK to version 3.10.1

Version 3.4.8 – January 30, 2024 #

Added

• New parameters in DirectionsOptions includedTags and excludedTags. They allow you to configure the calculated routed based on tags. To know more about how this works check this.
• New method MapViewRef.setOnDirectionsRequestInterceptor(OnDirectionsRequestInterceptor). With this method you can modify the DirectionsRequest that will be used to calculate the route in the navigation.

Changed

• Updated Android SDK to version 3.10.0

Version 3.4.7 – January 30, 2024 #

Changed

• Updated iOS SDK to version 3.7.0

Version 3.4.6 -January 17,2024 #

Fixed

• Fixed several runtime exceptions on integrations that also use the react-native-permissions plugin. Now @situm/react-native uses the react-native-permissions@^3.8.4 version.

Version 3.4.5 -January 12,2024 #

Changed

• Updated Android SDK to version 3.9.3

Version 3.4.4 -December 20,2023 #

Versions 3.4.4, 3.4.3 and 3.4.2 contain a bug in navigation and shouldn’t be used

Changed

• Updated iOS SDK to version 3.6.0

Version 3.4.3 -December 20,2023 #

Changed

• Updated Android SDK to version 3.9.2

Version 3.4.2 -December 19,2023 #

Changed

• Updated Android SDK to version 3.9.1

Version 3.4.1 -December 18,2023 [Stable] #

Added

• You may now subscribe to onLocationError callback to listen to Errors with the following new location ErrorCodes: BLUETOOTH_DISABLED, LOCATION_PERMISSION_DENIED, BLUETOOTH_PERMISSION_DENIED, REDUCED_ACCURACY, LOCATION_DISABLED.

Fixed

• getDeviceId is now working again. This method allows you to retrieve the device identifier to which geolocations will be associated when stored in Situm Platform.

Version 3.4.0 -December 18,2023 #

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.3.6 -December 12,2023 [Stable] #

Changed

• Updated Android SDK to version 3.9.0

Version 3.3.5 -December 11,2023 #

Changed

• Updated iOS SDK to version 3.5.0

Version 3.3.4 -November 28,2023 #

Changed

• Updated iOS SDK to version 3.4.0

Version 3.3.3 -November 27,2023 #

Changed

• Updated Android SDK to version 3.8.0

Version 3.3.2 -November 27,2023 #

Changed

• Updated Android SDK to version 3.7.0

Version 3.3.1 -November 15,2023 #

Changed

• Updated Android SDK to version 3.6.0

Version 3.3.0 -November 09,2023 #

Added

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

Version 3.2.2 -November 06,2023 #

Changed

• Updated iOS SDK to version 3.3.0

Version 3.2.1 -November 06,2023 #

Changed

• Updated Android SDK to version 3.5.3
• Send new location.update_status message to the viewer, this will allow the integrator to better inform the user about changes in the location status.

Version 3.1.11 -October 31,2023 #

Changed

• Updated Android SDK to version 3.5.2

Version 3.1.10 -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.1.9 -October 26,2023 #

Changed

• Updated Android SDK to version 3.5.1

Version 3.1.8 -October 25,2023 #

Changed

• Updated Android SDK to version 3.5.0

Version 3.1.7 -October 19,2023 #

Changed

• Updated Android SDK to version 3.4.0

Version 3.1.6 -October 19,2023 #

Changed

• Updated iOS SDK to version 3.2.2

Version 3.1.5 -October 18,2023 #

Changed

• Updated iOS SDK to version 3.2.1

Version 3.1.4 -October 17,2023 #

Changed

• Updated Android SDK to version 3.3.1

Version 3.1.3 -October 11,2023 #

Changed

• Updated Android SDK to version 3.3.0

Version 3.1.2 -October 11,2023 #

Changed

• Updated iOS SDK to version 3.2.0

Version 3.1.1 -September 29,2023 #

Changed

• Updated iOS SDK to version 3.1.0

Version 3.1.0 -September 22,2023 #

Added

• BREAKING CHANGE: The SDK has been ported to use promises for handling asynchronous operations. So developers relying on the older callback-based approach may need to update their code to work with promises and custom callbacks. Refer to our documentation for more information about our the new API.
• BREAKING CHANGE: The MapView and useSitum components have undergone refactoring to work together better with our SDK module. Developers using these components should be aware of the changes and update their code accordingly. Refer to our quickstart guide for more information about how to set up your application with these changes.
• BREAKING CHANGE: The MapView configuration has been modified to allow for a more curated selection of options.
• SDK and Wayfinding related examples have been moved to their dedicated folder and new examples have been added regarding to the functionality of selectPoi and navigateToPoi

Fixed

• There have been fixes in typings related to POI selection and deselection.
• A fix has been applied to address crashes related to geofence callbacks.

Improved

• Improved logs on examples to give more feedback to the user.
• Added JSDoc comments implies such that the codebase now contains more comprehensive documentation.

Version 3.0.9 -September 21,2023 #

Changed

• Updated Android SDK to version 3.2.0

Version 3.0.8 -September 06,2023 #

Changed

• Fixed navigation route not being computed correctly. Previously, the last static route was being returned instead of the route that has just been requested.

Version 3.0.7 -September 06,2023 #

Changed

• Updated iOS SDK to version 3.0.2

Version 3.0.6 -September 05,2023 #

Changed

• Updated Android SDK to version 3.1.2

Version 3.0.5 -September 04,2023 #

Changed

• Updated Android SDK to version 3.1.1

Version 3.0.4 -August 14,2023 #

Changed

• Updated example app and docs.

Version 3.0.3 -August 10,2023 #

Fixed

• build: upgrade to react-native 0.72.3 to being able to use the plugin with XCode 15
• types: fixed Typescript definitions not being exported propertly

Changed

• Improve styling to examples app, using react-native-paper and adding explanation to each example

Improved

• build: ported all the examples and tests to Typescript, this change will allow us to catch bugs during development

Version 3.0.2 -August 09,2023 #

Changed

• Updated iOS SDK to version 2.62.0

Version 3.0.1 -August 04,2023 #

Changed

• Updated Android SDK to version 3.1.0

Version 3.0.0 -August 03,2023 #

Introducing the new Situm SDK 3.0.

We are thrilled to announce the release of Situm SDK 3.0, which implies a significant architectural change in our SDK. With this update, we have integrated the previous UI standalone solution Wayfinding library directly into the SDK. This integration aims to streamline the development process and provide a more cohesive and comprehensive solution.

Furthermore we have introduced a remarkable evolution and improvement upon the Wayfinding library with the addition of the MapView component, powered by the new Situm Map Viewer. 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.
• Source code.

We are incredibly grateful for your continued support and trust in our library. @situm/react-native 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/react-native 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 React Native 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 requestPermissions() utility to ease you the permissions handling required by Situm SDK in your app.
• Added new useSitum() hook that simplifies the use of the Situm SDK within your app.

Version 0.0.35 -July 20,2023 #

Changed

• Updated iOS SDK to version 2.61.1

Version 0.0.34 – July 18, 2023 #

Changed

• Updated Android SDK to version 3.0.1

Version 0.0.33 – July 03, 2023 #

Changed

• Use cache first on fetchBuildings.

• Updated Android SDK to version 2.88.0.
• Updated iOS SDK to version 2.61.0.

Version 0.0.32 – June 21, 2023 #

Changed

• Updated iOS SDK to version 2.60.3.

Version 0.0.31 – June 9, 2023 #

Changed

• Updated Android SDK to version 2.87.0.

Version 0.0.30 – June 5, 2023 #

Changed

• Added support for accessibility modes on route computation when calling requestDirections(…)

Version 0.0.29 – May 31, 2023 #

Changed

• Updated RouteStep and Route Android mappings to correct a typo: the value of the field TO is now in lowercase for consistency with the rest of the fields. TO was maintained but deprecated, to avoid compatibility issues.
• Updated iOS SDK to version 2.60.2.

Removed

• Removed unused constants and methods.

Version 0.0.28 – May 25, 2023 #

Changed

• Now the subscriptionId at startPositioning(…) and stopPositioning(…) is not needed anymore.
  • Warning: this is a breaking change as it has been modified the return type of startPositioning(…) from number to void and it has been removed the parameter subscriptionId of stopPositioning(…).
• This change aims to simplify the use of the plugin. If you need to add multiple location listeners you just need to implement some kind of publish-subscribe pattern.
• Updated Android SDK to version 2.86.3.

Version 0.0.27 – May 22, 2023 #

Changed

• Updated Android SDK to 2.86.2.
• Updated iOS SDK to 2.60.1.

Version 0.0.26 – May 9, 2023 #

Changed

• Updated Android SDK to 2.86.0

Version 0.0.25 – May 4, 2023 #

Changed

• Refactored startPositioning() and stopPositioning() methods to enable seamless integration of SDK and WYF. For further details, please refer to the following link: https://situm.com/docs/wyf-sdk-coexistence/

Version 0.0.24 – April 27, 2023 #

Changed

• Updated iOS SDK version to 2.60.0.

Version 0.0.23 – April 25, 2023 #

• This version of the RN plugin updates the iOS capabilities so it can detect when a user enters or exits a geofence. This detection only works on geofences not suitable for positioning. More info about geofences and its usage as a developer in Cartography geofences knowledge, Related methods to geofences and Listen to geofence entries & exits.

Version 0.0.22 – April 24, 2023 #

Changed

• Updated Android SDK to 2.85.3.

Version 0.0.21 – April 17, 2023 #

• Added support for offline tiles. Now you can download and store tiles of your building locally so your venue looks great on your map even without network connection. Use the function fetchTilesFromBuilding to support this feature.
  NOTE: Floorplans are not stored in tiles by default, but Situm Support Team can tile your floorplans & upload them to Situm Platform (ask us: support@situm.com)

  More info about tiles and Situm on Working with Tiles.

• Upgraded iOS SDK to 2.59.1

Version 0.0.20 – April 04, 2023 #

• Upgraded Android SDK to 2.85.2.

Version 0.0.19 – March 15, 2023 #

• Upgraded iOS SDK version to 2.59.0.
• Added the necessary configuration to import locally the plugin, so now its posible to execute example/ app with npm.
• Added RequestPermissions.tsx as an example on how to request the required positioning permissions.
• Now positioning does stop when exiting both positioning examples.

Version 0.0.18 – March 09, 2023 #

• Updated iOS SDK to 2.58.0.
• Added new setDashboardURL() method in both platforms.

Version 0.0.17 – March 02, 2023 #

• Updated Android SDK to 2.85.0.

Version 0.0.16 – February 27, 2023 #

• Fixed problem in the podspec added in the previous version that made impossible to download the iOS SDK dependency

Version 0.0.15 – February 24, 2023 [This version has a problem in iOS, use the version 0.0.16] #

• Added a embedded sample app inside example.
• Updated Android SDK to 2.83.9
• Updated iOS SDK to 2.57.1

Version 0.0.14 – January 04, 2023 #

• Updated Android SDK to 2.83.4
• Added new callbacks (onEnterGeofences and onExitGeofences) to get notified when the user enters or leaves geofences:
  • Only available in Android, will be availble also in iOS soon.

Version 0.0.13 – April 19, 2022 #

• Updated iOS SDK to 2.52.1
• Updated Android SDK to 2.73.0
• Added support for some new features present in out native SDKs:
  • setUseRemoteConfig – When set to true the location engine will use a remote configuration stored on the dashboard so you can easily change and adapt it to your app’s needs

Version 0.0.12 – July 1, 2021 #

• Updated iOS SDK to 2.50.11
• Updated Android SDK to 2.68.6
• Added support for some new features present in our native SDKs:
  • useLocationCache – Caches location for 30s after stopping positioning.
  • useGeofencesInBuildingSelector – Use geofences for building detection. GPS + WIFI/BLE based building detector.
  • enableOutdoorPositions – new in iOS. Enable/disable the use of outdoor positions in global mode.
  • minimumOutdoorLocationAccuracy – new in Android. Set the minimum accuracy for outdoor positions. Positions with lower accuracy will be discarded.
  • Android only
    • ignoreWifiThrottling – Ignore wifi throttling limitations in Android 10 and above.
    • scansBasedDetectorAlwaysOn – Keep scans based building detetor active after building detection.
    • enableOpenSkyDetector – Enable/disable the open sky detector. Not recommended.
• Fixed bug in the following iOS options. The boolean values were not being correctly parsed so they were automatically always set to true. This is now fixed and the value will be set correctly.
  • useGps – Use GPS signals for indoor positioning.
  • useBarometer – Use the barometer for indoor positioning.
  • useDeadReckoning – Faster orientation changes.
  • useGlobalLocation

Version 0.0.11 – March 23, 2021 #

• Solved bug in iOS useBarotemter configuration option
• Solved bug in iOS realtimeUpdateInterval configuration options

Version 0.0.10 – January 13, 2021 #

• Additional outdoor configuration options
• Updated iOS SDK to version 2.50.4
• Updated Android SDK to version 2.67.1

Version 0.0.9 – November 25, 2020 #

• Additional configuration methods (enable outdoor positions and battery saver)
• Updated iOS SDK to version 2.48.0
• Updated Android SDK to version 2.64.1

Version 0.0.6 – July 15, 2020 #

• Include real time support
• Updated iOS SDK to version 2.45.2
• Updated Android SDK to version 2.60.0

Version 0.0.5 – July 06, 2020 #

• Additional fetching methods to communicate with REST API (poi categories)

Version 0.0.4 – July 02, 2020 #

• Fix global location

Version 0.0.3 – June 23, 2020 #

• Navigation API
• Additional configuration methods (credentials, sdkVersion)

Version 0.0.2 – June 05, 2020 #

• Basic fetching methods to communicate with REST API (buildings, building info)
• Location API
• Direction API

Version 0.0.1 – May 28, 2020 #

• Public interfaces