04 – React Native SDK Changelog

Version 3.1.0 -September 22,2023 #


  • 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


  • 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 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 #


  • Updated Android SDK to version 3.2.0

Version 3.0.8 -September 06,2023 #


  • 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 #


  • 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.2

Version 3.0.6 -September 05,2023 #


  • Updated Android SDK to version 3.1.2

Version 3.0.5 -September 04,2023 #


  • Updated Android SDK to version 3.1.1

Version 3.0.4 -August 14,2023 #


  • 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.

Version 3.0.3 -August 10,2023 #


  • 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


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


  • 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 #


  • Updated iOS SDK to version 2.62.0

Version 3.0.1 -August 04,2023 #


  • 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:

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!


  • 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 #


  • Updated iOS SDK to version 2.61.1

Version 0.0.34 – July 18, 2023 #


  • Updated Android SDK to version 3.0.1

Version 0.0.33 – July 03, 2023 #


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

Version 0.0.32 – June 21, 2023 #


  • Updated iOS SDK to version 2.60.3.

Version 0.0.31 – June 9, 2023 #


  • Updated Android SDK to version 2.87.0.

Version 0.0.30 – June 5, 2023 #


Version 0.0.29 – May 31, 2023 #


  • 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 unused constants and methods.

Version 0.0.28 – May 25, 2023 #


  • Now the subscriptionId at startPositioning(…) and stopPositioning(…) is not needed anymore.
  • 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 #


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

Version 0.0.26 – May 9, 2023 #


  • Updated Android SDK to 2.86.0

Version 0.0.25 – May 4, 2023 #


Version 0.0.24 – April 27, 2023 #


Version 0.0.23 – April 25, 2023 #

Version 0.0.22 – April 24, 2023 #


  • 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 #

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 #

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:
  • 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.

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

Subscribe to our newsletter


Data controller: SITUM TECHNOLOGIES, S.L.
Contact: Data controller: situm@situm.es
Responsible for protection: dpo@situm.es
Purpose and legal basis: To manage the sending of SITUM newsletters only with consent.
Legitimation: Express consent of the interested party.
Recipients: The data will not be passed on to third parties with the exception of legal obligations.
Retention period: As long as the interested party remains subscribed to the newsletter (a link to unsubscribe will be available in each newsletter sent by Situm).
Rights: The interested party may at any time revoke their consent, as well as exercise their rights of opposition, access, conservation, rectification, limitation, deletion of data and not be subject to a decision based only on automated data processing, by writing to SITUM at the addresses indicated.
Additional Information: You can consult additional and detailed information on Data Protection in our privacy policy.

Please, download your copy here

Thank you for downloading our whitepaper. Please do not hesitate to contact us if you would like to know more about how our solutions can help your business. Download whitepaper

Close window