03 – Cordova SDK Changelog

Version 3.5.0 – April 10, 2024 #

Added

• New parameters in SDK DirectionsOptions: includedTags and excludedTags. They allow you to configure the routes calculated by the SDK based on tags.
• New method Situm.getDeviceId() to retrieve the device identifier.
• New method MapViewController.setDirectionsOptions(MapViewDirectionsOptions). With this method you can change all the routes calculated by the MapViewer based on the tags you set on the mapViewDirectionOptions.

Version 3.4.5 – April 02, 2024 #

Changed

• Updated iOS SDK to version 3.10.0

Version 3.4.4 – April 02, 2024 #

Changed

• Updated iOS SDK to version 3.9.0

Version 3.4.3 – April 01, 2024 #

Changed

• Updated Android SDK to version 3.12.0

Version 3.4.2 – March 25, 2024 #

Fixed

• Fixed a bug that prevented the plugin from sending actions (e.g. select POI) to <map-view> in case viewer-domain parameter wasn’t specified.
• Fixed a regression introduced in version 3.4.0 where navigation updates were not being received on iOS, including progress updates, estimated time, arrival at destination, and route recalculations.

Changed

• For compatibility reasons, now you can use an empty string as buildingIdentifier to enable global mode also in Android.

Version 3.4.1 – March 18, 2024 #

Changed

• Updated iOS SDK to version 3.8.5

Version 3.4.0 – March 18, 2024 #

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

Added

• Introducing new methods: requestLocationUpdates(LocationRequest), onLocationUpdate(function), onLocationStatus(function), onLocationError(function), and removeUpdates(). These additions aim to standardize the API across native SDKs and other hybrid platforms such as React Native and Flutter.
  Checkout our updated Cordova quickstart guide or the example application to learn how to integrate the new methods.
• Note: removeUpdates() now returns a Promise, enabling usage with async/await syntax.

Deprecated

• Deprecated the methods startPositioning and stopPositioning.
• Deprecated the data object LocationOptions in favor of LocationRequest.

Changed

• Although the startPositioning method has been deprecated, it has been updated to accept a LocationRequest object as the standard input. It remains compatible with the previous input format based on arrays, including building and location requests.

Removed

• Removed unnecessary dependency on play-services-maps in Android.

Version 3.3.14 – March 14, 2024 #

Changed

• Updated Android SDK to version 3.11.2

Version 3.3.13 – March 12, 2024 #

Changed

• Updated iOS SDK to version 3.8.4

Version 3.3.12 – March 11, 2024 #

Changed

• Updated iOS SDK to version 3.8.3

Version 3.3.11 – February 23, 2024 #

Changed

• Updated iOS SDK to version 3.8.2

Version 3.3.10 – February 21, 2024 #

Changed

• Updated iOS SDK to version 3.8.1

Version 3.3.9 – February 21, 2024 #

Changed

• Updated Android SDK to version 3.11.1

Version 3.3.8 – February 20, 2024 #

Changed

• Updated iOS SDK to version 3.8.0

Version 3.3.7 – February 16, 2024 #

Changed

• Updated Android SDK to version 3.11.0

Version 3.3.6 – February 16, 2024 #

Changed

• Updated iOS SDK to version 3.7.2

Version 3.3.5 – February 15, 2024 #

Changed

• Updated Android SDK to version 3.10.2

Version 3.3.4 – February 09, 2024 #

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

Changed

• Updated iOS SDK to version 3.7.1

Version 3.3.3 – February 05, 2024 #

Changed

• Updated Android SDK to version 3.10.1

Version 3.3.2 – January 30, 2024 #

Changed

• Updated Android SDK to version 3.10.0

Version 3.3.1 – January 30, 2024 #

Changed

• Improve plugin documentation.

Version 3.3.0 – January 18, 2024 #

Changed

• Added new MapViewController.setLanguage() to change the language used on the user interface. You may also pass the language tag to the <map-view>. The language should be passed as an ISO 639-1 code. Checkout the Situm docs to see the list of supported languages.

Version 3.2.5 -January 12,2024 #

Changed

• Updated Android SDK to version 3.9.3

Version 3.2.4 -December 20,2023 #

Changed

• Updated iOS SDK to version 3.6.0.

Version 3.2.3 -December 20,2023 #

Changed

• Updated Android SDK to version 3.9.2

Version 3.2.2 -December 19,2023 #

Changed

• Updated Android SDK to version 3.9.1

Version 3.2.1 -December 12,2023 #

Changed

• Updated Android SDK to version 3.9.0

Version 3.2.0 -December 12,2023 #

Changed

• New sample app to showcase how to integrate our plugin in a Capacitor project. Take a look at its README.md to try this app.

Version 3.1.1 -December 11,2023 #

Changed

• Update iOS SDK version to 3.5.0.

Version 3.1.0 -November 29,2023 #

Added

• Added new actions and events for MapViewController:
  • navigateToPoi(). Navigate to a certain POI of your building
  • onPoiSelected(). This callback will be called when the some POI was selected.
  • onPoiDeselected(). This callback will be called when the some POI was deselected.

Version 3.0.1 -November 28,2023 #

Changed

• Updated iOS SDK to version 3.3.0
• Updated Android SDK to version 3.8.0

Version 3.0.0 -November 22,2023 #

Introducing the new @situm/cordova 3.0.0!

We are thrilled to announce the new release of @situm/cordova, a remarkable evolution and improvement upon our previous versions. 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, we have prepared comprehensive guide on how to create a Cordova app with our new visual component. You might found the following links helpful:

• API reference. Learn how to communicate with our API.

• Capacitor example application. Try our plugin with just a few steps in our sample app!

We are incredibly grateful for your continued support and trust in our library. The new @situm/cordova 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/cordova introduces a new visual component to provide interactive maps within your application. The allows you to show indoor maps of your buildings on your app! It is a fully interactive HTMLElement 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.

Version 1.20.34 -November 20,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.

Version 1.20.33 -November 15,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.

Version 1.20.32 -November 10,2023 #

Fix

• Fixed some compatibility problem with plugin.xml format on cordova-ios-7.0.1. Make sure you use cordova-ios-5.0.0 onwards, otherwise you might face some issues when integrating our plugin.

Version 1.20.31 -November 06,2023 #

Changed

• Updated iOS SDK to version 3.3.0

Version 1.20.30 -November 06,2023 #

Changed

• Updated Android SDK to version 3.5.3

Version 1.20.29 -October 31,2023 #

Changed

• Updated Android SDK to version 3.5.2

Version 1.20.28 -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 1.20.27 -October 26,2023 #

Changed

• Updated Android SDK to version 3.5.1

Version 1.20.26 -October 25,2023 #

Changed

• Updated Android SDK to version 3.5.0

Version 1.20.25 -October 20,2023 #

Changed

• Fixed some issues that broke the compilation of our plugin.

Version 1.20.24 -October 19,2023 [This version has a problem in iOS, use the version 1.20.25] #

Changed

• Updated Android SDK to version 3.4.0

Version 1.20.23 -October 19,2023 #

Changed

• Updated iOS SDK to version 3.2.2

Version 1.20.20 -October 11,2023 #

Changed

• Updated Android SDK to version 3.3.0

Version 1.20.19 -October 11,2023 #

Changed

• Updated iOS SDK to version 3.0.3

Version 1.20.18 -September 21,2023 #

Changed

• Updated Android SDK to version 3.2.0

Version 1.20.17 -September 06,2023 #

Changed

• Updated iOS SDK to version 3.0.2

Version 1.20.16 -September 05,2023 #

Changed

• Updated Android SDK to version 3.1.2

Version 1.20.15 -August 09,2023 #

Changed

• Updated iOS SDK to version 2.62.0

Version 1.20.14 -August 04,2023 #

Changed

• Updated Android SDK to version 3.1.0

Version 1.20.13 – July 20, 2023 #

Changed

• Updated iOS SDK to version 2.61.1

Version 1.20.12 – July 18, 2023 #

Changed

• Updated Android SDK to version 3.0.1

Version 1.20.9 – June 26, 2023 #

Changed

• Updated iOS SDK to version 2.61.0.

Version 1.20.8 – June 21, 2023 #

Changed

• Updated iOS SDK to version 2.60.3

Version 1.20.7 – June 9, 2023 #

Changed

• Updated Android SDK to version 2.87.0.

Version 1.20.6 – June 02, 2023 #

Changed

• Updated iOS SDK to 2.60.2.

Version 1.20.5 – May 25, 2023 #

Changed

• Updated Android SDK to 2.86.3.

Version 1.20.4 – May 09, 2023 #

Changed

• Updated Android SDK to 2.86.0.

Version 1.20.3 – April 27, 2023 #

Changed

• Updated iOS SDK version to 2.60.0.

Version 1.20.2 – April 24, 2023 #

Changed

• Updated Android SDK to 2.85.3.

Version 1.20.1 – March 31, 2023 #

Changed

• Updated iOS SDK to version 2.59.0.
• 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/
• Now the callbacks onEnterGeofences and onExitGeofences also works in iOS.

Version 1.20.0 – March 15, 2023 #

Changed

• Upgraded targetSdkVersion and compileSdkVersion to api 33. Make sure to have the xml attribute android:exported specified inside your <activity> section in your AndroidManifest.xml file.
• Updated Android SDK version to 2.85.0.
• Update iOS SDK version to 2.58.0.
• Fix setUseRemoteConfig() always setting up to true (iOS).

Version 1.19.0 – January 23, 2023 #

Changed

• New methods onEnterGefences() and  onExitGefences(). This methods notify when an user enters or exits a geofence. Right now it is only available for the Android version. If you want to know more, please check the JSDoc or the README in the repository.

Version 1.18.0 – April 06, 2022 #

Added

• New functionality: Remote configuration. Now you can load the configuration from the Dashboard and the SDK will automatically use it if you enable it. You can learn more about this and how to use it here.

Changed

•  Android SDK to version 2.73.0 and iOS SDK version 2.52.1.

Version 1.17.4 – March 03, 2022 #

Changed

• Updated iOS SDK to 2.52.0.

Version 1.17.3 – February 24, 2021 #

Changed

• Improvements in README.

Version 1.17.2 – January 31, 2022 #

Changed

• Updated Android SDK to 2.72.0.
• Updated min cordova-android platform version to 10.0.0.
• Situm SDK now compiles and targets sdkVersion 31 (Android 12). To work properly on Android 12 devices and above, the host app must:
  • Target android api 31 or above. In your project config.xml file, add <preference name="android-targetSdkVersion" value="31" /> to the Android platform configuration.
  • Request the runtime permissions BLUETOOTH_SCAN and BLUETOOTH_CONNECT, in addition to the ACCESS_COARSE_LOCATION that was already necessary (and ACCESS_FINE_LOCATION if you are using Global Mode).
  • Add android:exported="true" to all the intent-filtered components of your AndroidManifest.xml file. You can add the following configuration to your config.xml to automate this process:

    <edit-config
            file="app/src/main/AndroidManifest.xml"
            target="/manifest/application/activity[@android:name='MainActivity']"
            mode="merge">
        <activity android:exported="true"/>
    </edit-config>

  • Make sure the widget root element of your config.xml file declares the Android namespace:

    <widget id="..." version="..."
        ...
        xmlns:android="http://schemas.android.com/apk/res/android">

  • If you find problems, also make sure the Gradle JDK points to version 11 in your project configuration (recommended Android Studio embedded JDK).

Version 1.17.1 – December 29, 2021 #

Changed

• Updated iOS SDK to 2.51.5.

Version 1.17.0 – December 15, 2021 #

Added

• This plugin is now compatible with Capacitor.
• Added option computeInterval to OutdoorLocationOptions to set the interval (in milliseconds) between consecutive GPS readings performed by Situm SDK, and therefore between consecutive generated Outdoor Locations.

Changed

• Updated Android SDK to 2.70.4.
• Updated iOS SDK to 2.51.4.
• Migrated to AndroidX for the Android platform. A few weeks ago, we have updated the native Android SDK, migrating it to Android X and to newer versions of libraries such as Protobuf-lite. Android X replaces the old Android Support Library, which is no longer supported. Therefore, with this change we ensured maximum compatibility with Google and to always support the best integration with other third-party libraries and dependencies. More information available here: Updated SDK to support integration with other third-party libraries and dependencies.
  These changes are coming now to the Situm Cordova Plugin too. To benefit from this or future Situm Cordova Plugin releases, you need to make a few changes to your project:

   

  • Please migrate your project to AndroidX (especially in plugin developments). Android Studio can migrate your project automatically.
  • Upgrade your cordova platform to version 10. You may want to use the cordova-plugin-androidx-adapter plugin to handle outdated dependencies.
  • Remove the plugin cordova-plugin-whitelist.

Removed

• Removed already deprecated options burstInterval and continuousMode from OutdoorLocationOptions.

Version 1.16.3 – August 06, 2021 #

Fixed

• In Android devices, the Location JSON data passed when calling the method updateNavigationWithLocation() could not be parsed correctly into an object. This resulted in a parsing error (“org.json.JSONArray cannot be converted to JSONObject”).

Version 1.16.2 – February 04, 2021 #

• Updated Situm SDK dependencies. Android 2.67.1, iOS 2.50.4

Version 1.16.1 – December 27, 2019 #

• Fix a bug that caused a crash when trying to download a building created from certain timezones.

Version 1.16.0 – November 28, 2019 #

• Added support to retrieve geofences
• Added suppor to retrieve building information in a single call
• Added suppor to retrieve locations of a building in realtime
• Update Android SDK to version 2.43.0

Version 1.15.1 – July 22, 2019 #

• Updated iOS SDK to 2.33.0
• Updated Android SDK to 2.40.0

Version 1.15.0 – July 08, 2019 #

• Add field name to Floor
• Updated iOS SDK to 2.32.0
• Updated Android SDK to 2.39.0

Version 1.14.3 – May 31, 2019 #

• Updated iOS SDK to 2.31.1
• Updated Android SDK to 2.37.6

Version 1.14.2 – April 24, 2019 #

• Updated iOS SDK to 2.30.1

Version 1.14.1 – April 16, 2019 #

• Updated iOS SDK to 2.29.1
• Updated Android SDK to 2.37.0

Version 1.14.0 – April 10, 2019 #

• Updated iOS SDK to 2.29.0
• Updated Android SDK to 2.36.0
• Added useBarometer to LocationOptions in iOS

Version 1.13.0 – April 03, 2019 #

• Updated iOS SDK to 2.28.0
• Added smallestDisplacement to LocationOptions in iOS
• Added autoEnableBleDuringPositioning to LocationOptions in Android

Version 1.12.2 – March 29, 2019 #

• Fixed use of interval in location request
• Updated iOS SDK to 2.27.0

Version 1.12.1 – March 28, 2019 #

• Updated Android SDK to 2.35.1

Version 1.12.0 – March 26, 2019 #

• Added segments property to Route object
• Added points and segments properties to NavigationProgress object
• Updated iOS SDK to 2.26.1
• Updated Android SDK to 2.35.0

Version 1.11.8 – March 22, 2019 #

• Updated iOS SDK to 2.25.1

Version 1.11.7 – March 20, 2019 #

• Updated iOS SDK to 2.25.0

Version 1.11.5 – March 18, 2019 #

• Updated iOS SDK to 2.24.1

Version 1.11.3 – March 15, 2019 #

• Updated Android SDK to 2.34.1

Version 1.11.2 – March 14, 2019 #

• Updated iOS SDK to 2.24.0

Version 1.11.1 – March 13, 2019 #

• Updated iOS SDK to 2.23.0

Version 1.11.0 – March 12, 2019 #

• Updated Android SDK to version 3.33.0. Added ignoreLowQualityLocations parameter to
  NavigationRequest

Version 1.10.8 – March 04, 2019 #

• Updated iOS SDK to version 2.21.11

Version 1.10.7 – March 03, 2019 #

• Updated iOS SDK to version 2.21.10

Version 1.10.6 – February 27, 2019 #

• Updated iOS SDK to version 2.21.8
• Updated Android SDK to version 2.32.1
• Fix crash when calling requestDirections() in Android with 3 parameters

Version 1.10.5 – February 20, 2019 #

• Updated iOS SDK to version 2.21.6
• Updated Android SDK to version 2.31.4

Version 1.10.4 – February 13, 2019 #

• Updated iOS SDK to version 2.21.5
• Updated Android SDK to version 2.31.3

Version 1.10.3 – February 11, 2019 #

• Updated iOS SDK to version 2.21.2

Version 1.10.2 – January 31, 2019 #

• Updated iOS SDK to version 2.21.1

Version 1.10.1 – January 30, 2019 #

• Updated iOS SDK to version 2.21.0

Version 1.10.0 – January 23, 2019 #

• Fix not starting the positioning after an error when calling startPositioning() again without calling stopPositioning().
• Updated iOS SDK to version 2.20.0

Version 1.9.6 – January 17, 2019 #

• Updated Android SDK to version 2.31.1
• Updated iOS SDK to version 2.19.0

Version 1.9.4 – January 14, 2019 #

• Updated iOS SDK to version 2.18.5

Version 1.9.5 – January 14, 2019 #

• Updated Android SDK to version 2.31.0

Version 1.9.3 – January 08, 2019 #

• Updated iOS SDK to version 2.18.4

Version 1.9.2 – December 21, 2018 #

• Updated iOS SDK to version 2.18.3
• Updated Android SDK to version 2.30.4

Version 1.9.1 – December 18, 2018 #

• Updated iOS SDK to version 2.18.0
• Fix navigation issue

Version 1.9.0 – December 04, 2018 #

• Updated iOS SDK to version 2.17.2
• Updated Android SDK to version 2.30.1
• Add new accessibility modes

Version 1.8.9 – November 12, 2018 #

• Fix potential issue when starting positioning
• Migrate to Xcode legacy build system

Version 1.8.8 – November 06, 2018 #

• Update iOS SDK version to 2.16.3

Version 1.8.7 – November 02, 2018 #

• Update iOS SDK version to 2.16.2
• Update Android SDK version to 2.27.0

Version 1.8.6 – October 23, 2018 #

• Add GPS option in order to use GPS (iOS)
• Update iOS SDK version to 2.16.1

Version 1.8.5 – October 16, 2018 #

• Update iOS SDK version to 2.15.0

Version 1.8.4 – October 02, 2018 #

• Update Android SDK version to 2.25.5

Version 1.8.0 – August 29, 2018 #

• Update iOS SDK version to 2.12.0
• Update Android SDK version to 2.25.0
• Add trigger and conversion to SitumEvent.

Version 1.7.6 – August 27, 2018 #

• Update iOS SDK version to 2.11.0
• Add x and y to SitumEvent.

Version 1.7.4 – August 20, 2018 #

• Update iOS SDK version to 2.10.0
• Add minimizeFloorChanges option on DirectionsOptions to reduce the number of floor changes
  taken during a route.

Version 1.7.3 – July 24, 2018 #

• Update iOS SDK version to 2.9.0
• Add timeToIgnoreUnexpectedFloorChanges parameter on NavigationRequest (iOS)

Version 1.7.2 – July 03, 2018 #

• Update Android SDK version to 2.23.0
• Update iOS SDK version to 2.8.1
• Fixed interfaces

Version 1.7.1 – July 02, 2018 #

• Fixed interfaces

Version 1.7.0 – June 28, 2018 #

• Update iOS SDK version to 2.8.0

Version 1.6.0 – June 21, 2018 #

• Update Android SDK version to 2.22.0
• Update iOS SDK version to 2.7.0
• Add field closestLocationInRoute to NavigationProgress
• Unify updateNavigationWithLocation interface

Version 1.5.10 – June 06, 2018 #

• Update Android SDK version to 2.21.1
• Update iOS SDK version to 2.6.4

Version 1.5.8 – May 22, 2018 #

• Add Dead Reckoning support
• Update iOS SDK version to 2.6.3

Version 1.5.7 – May 16, 2018 #

• Add field closestLocationInRoute to NavigationProgress
• Android: add field timeToIgnoreUnexpectedFloorChanges to NavigationRequest
• Update Android SDK to version 2.19.0
• Update iOS SDK version to 2.6.2

Version 1.5.6 – May 08, 2018 #

• Fix POI category with invalid fields and POI category images not returning the correct image

Version 1.5.5 – May 02, 2018 #

• Update Android SDK to version 2.18.2
• Add fields boundsRotated and buildingIdentifier to Building and field infoHtml to POI

Version 1.5.3 – April 25, 2018 #

• Improve indications
• Parse kSITCalculating

Version 1.5.2 – April 18, 2018 #

• Add POI categories
• Add clockwiseDegrees property to location

Version 1.5.1 – April 17, 2018 #

• Add indicationsInterval to set the interval to return indications during navigation
• Add timeToFirstIndication to set the time to return the first indication when starting navigation.
  While starting it will return a kSITCalculating indication
• Add roundIndicationsStep to group the distances of the indications

Version 1.5.0 – April 12, 2018 #

• Unify requestNavigationUpdates result.
• Unify locationState format.

Version 1.4.1 – April 09, 2018 #

• Fix startPositioning() issue on iOS devices
• Fix removeNavigationUpdates method not found on iOS

Version 1.3.16 – April 06, 2018 #

• Fix empty POI.customFields on some iOS devices
• Add building.rotation parameter on iOS
• Update iOS SDK version to 2.5.8

Version 1.3.15 – April 05, 2018 #

• Allow to customize outsideRouteThreshold, distanceToFloorChangeThreshold and distanceToChangeIndicationThreshold parameters of NavigationRequest on iOS.

Version 1.3.14 – April 04, 2018 #

• Fix critical bug on iOS

Version 1.3.10 – April 02, 2018 #

• Update Android SDK version to 2.17.0
• Update iOS SDK version to 2.5.6

Version 1.3.9 – March 20, 2018 #

• Add new level change support
• Add humanReadableMessase on indications
• Update iOS SDK version to 2.5.5

Version 1.3.8 – March 14, 2018 #

• Add navigation APIs on iOS
• Unify NavigationProgress interfaces

Version 1.3.7 – March 09, 2018 #

• Add navigation APIs on Android

Version 1.3.6 – March 07, 2018 #

• Add some navigation parameters
• Add startingAngle on DirectionsOptions
• Update iOS SDK version to 2.5.3
• Update Android SDK version to 2.16.0

Version 1.3.4 – March 01, 2018 #

• Update iOS SDK version to 2.5.2

Version 1.3.2 – February 26, 2018 #

• Fix route conversion
• Include customFields on Building
• Include accessible parameter, deadReckoning, cacheMaxAge, and fix poiCategory error on iOS
• Fix plugin id

Version 1.2.0 – February 23, 2018 #

• Rename plugin properties
• Add description
• Change links to GitHub
• Update Situm SDK version to 2.14.3
• Include Telerik platform support
• Normalization of location json object for ios platform