Skip to content
Developers Docs

Mapsted Maps - Mobile Docs
Mapsted Maps - Mobile Docs Mapsted Analytics - 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.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

Past Releases

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

Past Releases

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