Skip to content
Developers Docs

Release Notes

Release Notes

Android v5

This version is a major update and brings several new features, major performance improvements, and lots of fixes. For full details, please see the 5.+ migration guide.

v5.4.19

Release Date: 2024-03-22

  • Fixed crash which was occuring when switching device language or theme during runtime
  • Fixed duplicate itinerary item issue
  • Fixed confirmation dialog button when deleting tag
  • Fixed several map & tag click related corner cases
  • Enhanced route recalculation & locking business logic and customizability
  • Enhanced locking to transitions logic

v5.4.18

Release Date: 2024-03-13

  • Improved building initialization when transitioning between buildings

v5.4.17

Release Date: 2024-03-05

  • Improved map click listeners for scenarios where text overlays are covering entities
  • Bug fix for periodic blue dot freezing issue
  • Route instructions enhancements
  • Bug fix for situations where occasionally blue dot was aggressively locking to transitions
  • Included necessary background location permissions for Android 14

v5.4.16

Release Date: 2024-02-23

  • Enhanced floor transition robustness for elevator scenarios
  • Fix Android platform targets to resolve issue on very old arm64 devices
  • Fix periodic issue where blue dot and/or assisted positioning button would occasionally not appear
  • Improved floor detection robustness/stability
  • Improve issues related to building-to-building changes which also include a change in elevation
  • Improve building-to-building transitions with nearby secondary entrances
  • Better handling for licence expiry

v5.4.9

Release Date: 2024-01-19

  • Blue dot floor change enhancements for complex scenarios which include partial landings and/or short pauses (e.g., elevator stops)
  • Minor updates to geofencing radius for POI vicinity
  • Bug fix for blue dot heading (vision cone)
  • Bug fix to CMS icon/text rotation angle issues that could occasionally occur
  • Bug fix to some MapFragment icons when location permission granting was delayed
  • Improved concurrency handling for multiple coreApi requests to get PropertyInfo
  • Added progress spinner to SimplerPropertyListFragment
  • Minor enhancements for geofencing and notify integration
  • Fixed crash which was occuring on devices which were missing inertial sensors
  • Fixed blue dot heading / vision cone issue which would occasionally occur
  • Bug fix for handling possible malformed json api responses

v5.4.8

Release Date: 2024-01-16

  • Fix destination icon disappearing while added custom RoutingStyleParams
  • Minor bug fixes and enhancements

Past Releases

v5.4.7

Release Date: 2023-12-22

  • Minor fix to search bar in MapstedMapActivity (map-ui-sdk)
  • Added RouteStyleParams for customizing routing icons and lines

v5.4.6

Release Date: 2023-12-20

  • Fixed bug associated with coreApi.setup().stopLocationServices(...)
  • Fixed a bug which caused a delay in blue dot appearing
  • Improved handling of mapApi.mapView().config().changeAutomatedClickProcessingState(...)
  • Routing fix for allowing internal routes when requesting building-to-building routes

v5.4.4

Release Date: 2023-12-08

  • Added feature to updateCompassButton(...) in mapApi
  • Bug fix for deeplink processing. Now requires passing in a containerViewId within which the mapView is contained
  • Various minor app-template bug fixes or enhancements
  • Multithreading enhancements to autoWakeFromDeepSleep feature

v5.4.2

Release Date: 2023-11-24

  • Updated use of CustomMapParams.Icon usage, supplying null will now remove the Icon
  • Added ability to add click listener to CustomMapParams.Icon and enable/disable automatic click or rotation handling (via CustomMapParams)
  • Improved handling of deeplinks when selecting buildings, floors, or entities
  • Improved handling of deeplinks involving multi-destination routes
  • Bux fix associated with addIcons(...) handling of fallback drawables
  • Bug fix for copyright visibility on map-sdk when used with map-ui-sdk

v5.4.1

Release Date: 2023-11-22

  • Bug fix for processing kiosk-based deeplinks
  • Bug fix for selecting recent items with multiple entities from map search dialog
  • Bug fix for handling wayfinding-based navigate from POI (e.g., Entity, Tag, Overlay)
  • Bug fix for wayfinding mode
  • Bug fix associated with blue dot building detection

v5.4.0

Release Date: 2023-11-17

New Features

  • Added option to disable requesting for Bluetooth permissions

Changes

  • MapApi restructured callback for selectPropertyAndDrawIfNeeded including callbacks when specific buildings have completed plotted and when all buildings have completed plotting (i.e., MapApi.PropertyBuildingPlotListener vs. MapApi.PlotListener)
  • MapApi added ability to plotProperty and plotBuilding without triggering a "selection"
  • Added various callbacks for MapApi methods to be notified when action is complete (e.g., selectEntity, setSelectedBuilding)
  • CoreApi method getCached(...) for accessing cached PropertyData has been deprecated and replaced by getData(...) which provides an async access to PropertyData. This method will fetch cached PropertyData or trigger a download, if necessary

v5.3.20

Release Date: 2023-11-08

  • Added support for dark mode

v5.3.19

Release Date: 2023-11-06

  • Bug fix for mapApi.mapView().customPlot().addIcons(...) when provided a null or invalid URL
  • Improved default handling of FeedFragment in loc-marketing-sdk
  • Fixed several LiveData flow issues for app-template-mall and app-template-campus

v5.3.18

Release Date: 2023-11-01

  • Bug fix for scenarios where multiple activities are being used (i.e., each with their own MapApi instance)
  • Bug fix for mapApi.mapView().customPlot().addIcons(...), which now handles the fallback drawable correctly
  • Bug fix for scenarios where the route path across multiple buildings was disappearing when Go button was pressed
  • Bug fix for routing priority via escalators

v5.3.17

Release Date: 2023-10-24

  • Added feature to map-ui-sdk for triggering plotting of RoutePreview screen, mapUiApi.events().launchRoutePreview(routeResponse)
  • Refactored creation of Waypoint objects from WaypointHelper.from(...) to Waypoint.from(...)
  • Refactored prefetching map data to core-sdk (specified via CoreParams), allowing prefetching of map data prior to loading of map
  • Bug fix for fallback drawable when using map-sdk for adding icons to map
  • Bug fix for initialization of auto-follow user (previously always enabled by default)

v5.3.16

Release Date: 2023-10-18

  • Refactored coreApi.properties().getEntity(...) to not require floorId as input
  • Additional wayfinding enhancements when routing via intermediary buildings

v5.3.15

Release Date: 2023-10-17

  • Added feature to check if Location Services are enabled when requesting location permissions
  • Bug fix for building detection in scenarios where multiple properties on the same licence overlap

v5.3.14

Release Date: 2023-10-12

  • Fixed periodic blue dot initialization issues when near entrance/exits
  • Fixed possible crash on launch when registering for heading accuracy listener prior to complete initialization

v5.3.13

Release Date: 2023-10-11

  • Bug fixes for routing via intermediary buildings

v5.3.12

Release Date: 2023-10-04

  • Reverted sdk to Java 11 (support for hybrid platform integration)

v5.3.11

Release Date: 2023-10-03

  • Added heading accuracy changed callback
  • Bug fixes for routing via intermediary buildings
  • Bug fix for requesting location permissions on first launch

v5.3.10

Release Date: 2023-09-26

  • Enhancements to property downloading speeds

v5.3.9

Release Date: 2023-09-21

  • Routing fix for property routes involving multiple intermediary buildings

v5.3.8

Release Date: 2023-09-05

  • Fixed potential crash which could occur in rare situations while taking floor transition in building with many levels
  • Minor bug fix for app-templates when user has not given location permissions

v5.3.7

Release Date: 2023-08-31

  • Bug fix for property/building plotting where in some circumstances plotting was reported as failing
  • Enhancements for floor transitions

v5.3.6

Release Date: 2023-08-27

  • Updated play-services-location to v21.0.1 and play-services-auth to v20.6.0.

Changes

  • Removed context from coreApi.location().getQuickRoughEstimate(...)
  • Replaced MapUiApi.LocationServicesCallback with CoreApi.LocationServiecsCallback

v5.3.5

Release Date: 2023-08-27

New Features

  • Enhancements to route generation time
  • Enhancements for complex property routing scenarios involving multiple intermediary buildings
  • Bug fix related to map search view not dismissing in some circumstances

Changes

  • Added mapUiApi.lifecycle().onBackPressed() for better back-press handling. This method will return a boolean for whether or not Mapsted has handled the back press

v5.3.3

Release Date: 2023-07-27

Key Highlights

  • Routing api refactoring and enhancements

New Features

  • For multi-destination routes, the Go button on the Route Preview screen will only be selectable when viewing the first Route (i.e., My Location to A)

Changes

  • Restructure to routing flow, removing ambiguity between mapApi and coreApi requesting route / starting navigation. Going forward, the mapApi methods are deprecated and coreApi should be used. The map-sdk handles its own callbacks internally
  • Added some deep copies during route recalculations to avoid potential out-of-scope crashes
  • Various internal routing UI performance enhancements
  • Bug fix for programmatically removing waypoint from itinerary
  • Bug fix for race condition where occasionally itinerary view would display behind route preview screen
  • Bug fix for routing preferences between elevator, escalator, stairs, or ramps
  • Improved responsiveness of blue dot and user/phone hearing callbacks

v5.2.8

Release Date: 2023-07-14 * Enhancements for map data downloading * Improvements for map plotting * Improved map rendering performance for multi-building properties * Refactored CustomMapParams icons to be more clean/consistent

v5.2.7

Release Date: 2023-07-11 * Improved protection against core-sdk crashes when alternatively starting/stopping the sdk * Bug fix for a routing between buildings corner case * Minor bug fix related to core positioning

v5.2.5

Release Date: 2023-06-27 * Significant improvents in map rendering performance for Map Overlays

v5.2.1

Release Date: 2023-06-21

Key Highlights

  • sdk-core restructure to allow for separate initialization and start/stopping of location services
  • sdk-map restructure to be more modular
  • sdk-map-ui restructure to be more modular

New Features

  • CoreParams added for customization of sdk-core initialization
  • Map styles and theme customization (e.g., colour schemes) via Manage CMS
  • Enhancements in blue dot accuracy and reliability
  • Enhanced map overlay support, enabling more dynamic zoom-based styling
  • Added additional support for Mapsted UI style/theme customization
  • Added additional support for parsing and processing deeplink data within Mapsted SDK
  • Support for CMS Staging/UAT mode

Changes

  • sdk-core requires explicit calls to start location services (coreApi.setup().startLocationServices(...))
  • CustomParams and CustomMapParams must now be supplied for initialization
  • MapstedSdkController renamed to MapstedMapUiApi
  • Removed various singleton instances
  • BearingCallback replaced with separate callbacks for PhoneHeading, UserHeading, and FusedHeading (coreApi.heading())
  • Added ability to programatically enable/disable snapping of blue dot to route path (coreApi.location().enableSnapBlueDotToRoute(...))

iOS v5

This version is a major update and brings several new features, major performance improvements, and lots of fixes. For full details, please see the 5.+ migration guide.

v5.3.15

Release Date: 2024-03-22

  • Enhanced route recalculation & locking business logic and customizability
  • Enhanced locking to transitions logic
  • Minor bug fixes

v5.3.14

Release Date: 2024-03-13

  • Added support for Xcode compatibility for different versions of Xcode. Podspec url imports will now be as follows:
  • For device: https://github.com/Mapsted/podspec.git
  • For simulator: https://github.com/Mapsted/podspec-simulator.git
  • Fixed issue related to floor transitions
  • Added public API method to set the analytics email address for tracking analytics

CoreApi.AnalyticsManager.setAnalyticsEmail(email: ...)

v5.3.13 (Xcode 15.0, 14.3.1, Simulator)

Release Date: 2024-03-04

  • Bug fixes for the map-ui-sdk property plotting while using in combination with map-sdk

Changes

Removed the below methods:

MapstedMapApi.shared.addMapTileEventListenerDelegate(delegate: self) MapstedMapApi.shared.addMapVectorElementListenerDelegate(delegate: self) MapstedMapApi.shared.addMapListenerDelegate(delegate: self)

Instead use:

mapViewController.addMapTileEventListenerDelegate(delegate: self) mapViewController.addMapVectorElementListenerDelegate(delegate: self) mapViewController.addMapListenerDelegate(delegate: self)

Here mapViewController is an instance of the MNMapViewController.

v5.3.12 (Xcode 15.0, 14.3.1, Simulator)

Release Date: 2024-02-23

  • Improved floor detection robustness/stability
  • Improve issues related to building-to-building changes which also include a change in elevation
  • Improve building-to-building transitions with nearby secondary entrances
  • Better handling for licence expiry
  • Minor bug fix for dark mode

v5.3.11 (Xcode 15.0, 14.3.1, Simulator)

Release Date: 2024-01-30

  • Fixed issue where some entity labels were not displaying on map
  • Added methods to manually register for map click and event listeners MapstedMapApi.shared.addMapTileEventListenerDelegate(delegate: self) MapstedMapApi.shared.addMapVectorElementListenerDelegate(delegate: self) MapstedMapApi.shared.addMapListenerDelegate(delegate: self)
  • Fixed the issue in Recenter property function on MapstedMapApi when property data is not yet loaded into memory

v5.3.9 (Xcode 15.0, 14.3.1, Simulator)

Release Date: 2024-01-25

  • Added geofence-sdk support
  • Minor bug fixes

Past Releases

v5.3.8 (Xcode 15.0, 14.3.1, Simulator)

Release Date: 2024-01-19

  • Blue dot floor change enhancements for complex scenarios which include partial landings and/or short pauses (e.g., elevator stops)
  • Added speech instruction for the Destination reached scenario
  • Fixed blue dot heading / vision cone issue which would occasionally occur
  • Bug fix to ensure that basemap is downloaded automatically when a property download is triggered via core-sdk
  • Minor bug fixes

v5.3.7 (Xcode 15.0, 14.3.1, Simulator)

Release Date: 2023-12-20

  • Fixed some compilation issues which were impacting integrating the mobile-sdk with react-native

v5.3.6 (Xcode 15.0, 14.3.1, Simulator)

Release Date: 2023-12-12

  • Minor bug fix for building detection in some cases where correlated erroneous GPS data is observed

v5.3.5 (Xcode 15.0, 14.3.1, Simulator)

Release Date: 2023-12-06

  • Added additional feature for improved map-sdk memory releasing (i.e., MapstedMapApi.shared.unloadMapResources())

v5.3.4 (Xcode 15.0, 14.3.1, Simulator)

Release Date: 2023-11-29

  • Additional features for map-sdk compass button (click listener, configure the automated processing for rotation or click processing)
  • Resolved route progress feature for map-sdk

v5.3.3 (Xcode 15.0, 14.3.1, Simulator)

Release Date: 2023-11-24

  • Bug fix associated with point-of-interest list generation
  • Bug fix for distance-time estimation on RoutePreview screen while in wayfinding only mode

v5.3.2 (Xcode 15.0, 14.3.1, Simulator)

Release Date: 2023-11-23

  • Bug fix for wayfinding mode
  • Bug fix associated with blue dot building detection

v5.3.1 (Xcode 15.0, 14.3.1, Simulator)

Release Date: 2023-11-21

  • Added utility method to map-sdk for recentering map camera on property MapstedMapApi.shared.centerOnProperty(...)
  • Added option to manually disable location permissions pop-up (MNSettingUtils.shared.enableLocationServices = false)

v5.3.0 (Xcode 15.0, 14.3.1, Simulator)

Release Date: 2023-11-07

  • Added addIcon(...) functionality to mapApi
  • Bug fix for filterAndSortSearchables in coreApi

v5.2.9 (Xcode 15.0, 14.3.1, Simulator)

Release Date: 2023-11-02

  • Code restructuring to migrate Map Overlays feature to map-sdk
  • Bug fix for routing priority via escalators

v5.2.8 (Xcode 15.0, 14.3.1, Simulator)

Release Date: 2023-10-30

  • Added support for dark mode

v5.2.7 (Xcode 15.0, 14.3.1, Simulator)

Release Date: 2023-10-19

  • Additional wayfinding enhancements when routing via intermediary buildings
  • Added method to fetch the property or building level entity based on propertyId, buildingId and entityId.

v5.2.6 (Xcode 15.0, Simulator)

Release Date: 2023-10-13

  • Fixed periodic blue dot initialization issues when near entrance/exits

v5.2.5 (Xcode 15.0, Simulator)

Release Date: 2023-10-11

  • This includes fixes for routing via intermediary buildings

v5.2.4 (Xcode 15.0, Simulator)

Release Date: 2023-10-04

  • Added heading accuracy changed callback (CoreApi.LocationManager.addPhoneHeadingAccuracyChangeListener)

v5.2.3 (Xcode 15.0)

Release Date: 2023-09-25

  • Support for iOS 17 (requiring update to Xcode 15.0)

v5.2.2 (Xcode 14.3.1, Simulator)

Release Date: 2023-09-21

  • Routing fix for property routes involving multiple intermediary buildings
  • Added ability to configure whether or not Bluetooth permissions should be re

v5.2.1 (Xcode 14.3.1)

Release Date: 2023-09-15

  • Added language support for English (US)

v5.2.0 (Xcode 14.3.1)

Release Date: 2023-09-11

  • Bug fix for some scenarios where the routing footer was getting hidden when navigation was started

v5.1.9 (Xcode 14.3.1)

Release Date: 2023-09-07

  • Bug fix for some scenarios where the property was not plotting on the first request

v5.1.8 (Xcode 14.3.1)

Release Date: 2023-09-06

  • Minor routing enhancements
  • Bug fix related to floor transitions (in some rare scenarios)

v5.1.7 (Xcode 14.3.1)

Release Date: 2023-08-31

  • Bug fix for rare scenarios where map download callbacks were both being called properly
  • Enhancements for floor transitions

v5.1.6 (Xcode 14.3.1)

Release Date: 2023-08-25

  • Enhancements to route generation time
  • Enhancements for complex property routing scenarios involving multiple intermediary buildings

v5.1.5 (Xcode 14.3.1)

Release Date: 2023-08-17

  • SDK size reduction (no change in features)

v5.1.4 (Xcode 14.3.1)

Release Date: 2023-07-28

  • Bug fix for routing preferences between elevator, escalator, stairs, or ramps
  • Improved threading when handling position changes and heading changes

v5.1.3 (Xcode 14.3.1)

Release Date: 2023-07-11

  • Upgraded core positioning module for enhanced positioning accuracy

v5.1.2 (Xcode 14.3.1)

Release Date: 2023-07-06

  • Recompiled SDK with Xcode 14.3.1

v5.1.1 (Xcode 14.3)

Release Date: 2023-06-26

  • Customization of the compass button (icon and position on the map view)
  • Customization of the copyright label (bottom margin)
  • Changes to CoreInitCallback methods to expose enums for onFailure and onStatusUpdate
  • Fixed an issue where blue dot was not appearing when using fake GPS

v5.1 (Xcode 14.3)

Release Date: 2023-06-20

  • BearingCallback replaced with separate callbacks for PhoneHeading, UserHeading, and FusedHeading (coreApi.heading())
  • Added ability to programatically enable/disable snapping of blue dot to route path (coreApi.location().enableSnapBlueDotToRoute(...))
  • Added getDistanceTimeToEndOfRoute and getUserDistanceTimeToRoute to MNRouteUserProgress callback

v5.0 (Xcode 14.3)

Release Date: 2023-06-15

New Features * Map styles and theme customization (e.g., colour schemes) via Manage CMS * Support for CMS Staging/UAT mode

Changes

  • Added auto setting for distance units to automatically handle metric vs. imperial depending on locale

v4.6

v4.6.35

Release Date: 2023-06-10

  • Location positioning enhancements
  • Improved outdoor-indoor transition smoothness
  • Minor bug fixes, stability improvements, and performance enhancements

Past Releases

v4.6.34

Release Date: 2023-05-19

  • Location positioning enhancements
  • Improved outdoor-indoor transition smoothness
  • Improved blue dot stability
  • Minor bug fixes, stability improvements, and performance enhancements

v4.6.33

Release Date: 2023-04-28

  • Location positioning enhancements
  • Enhanced property-specific parameter optimizations
  • Improvements to on-the-fly self-learning
  • Minor bug fixes, stability improvements, and performance enhancements

v4.6.29

Release Date: 2023-03-20

  • Wayfinding
  • Improved wayfinding route generation (~4x faster)
  • Updated RouteInstruction callback to include next key point information (e.g., Take elevator up then turn right)
  • Added Waypoint as part of route destination reached callback
  • Improved routing instruction quality in several scenarios
  • Resolved crash which could occur periodically occur when transitioning between properties
  • Location positioning enhancements
  • Improved blue dot responsiveness
  • Increased blue dot robustness/stability

v4.6.16

Release Date: 2022-10-14

  • Added BlueDotCriteria to sdk to allow for control of when to supply blue dot (e.g., disable blue dot when missing sensors or best-effort?)
  • Added valid blue dot callback to notify when unreliable data is being received
  • Location positioning enhancements
  • Positioning enhancements for devices with missing sensors

v4.6.15

Release Date: 2022-09-29

  • Added getMercatorAccuracy() to IAccuracy interface (used for plotting on map)
  • getAccuracy() reports distances in real-meters while getMercatorAccuracy() reports distances in map-meters

v4.6.14

Release Date: 2022-09-26

  • Geofence
  • Introduced sdk-geofence and sdk-geofence-offline
  • Allows for programmatic geofence creation/triggers/listeners
  • Location simulator
  • Added feature for sdk developers to programmatically specify blue dot path for development testing
  • Blue dot
  • Removed ripple effect to provide single error boundary which dynamically updates

v4.6

Release Date: 2022-05-12

  • Mobile SDK restructuring
  • CoreApi: Modulorized and unified Android/iOS interfaces
  • MapApi: Modulorized (Android)
  • Routing: Refactored for a more intuitive, easy-to-use interface
  • Alerts: Scheduled and emergency
  • Firebase notification support for emergency alerts
  • Ability to view/navigate to designated safe areas
  • Map overlays
  • Support for customizable overlays with dynamic zooming
  • Deeplinks
  • Support for deeplink-based routing, feed, map, open app, etc.
  • Enhanced real-time positioning support for lower-end devices
  • Minor bug fixes, stability improvements, and performance enhancements