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, supplyingnull
will now remove theIcon
- Added ability to add click listener to
CustomMapParams.Icon
and enable/disable automatic click or rotation handling (viaCustomMapParams
) - 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 withmap-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 forselectPropertyAndDrawIfNeeded
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 toplotProperty
andplotBuilding
without triggering a "selection"- Added various callbacks for
MapApi
methods to be notified when action is complete (e.g.,selectEntity
,setSelectedBuilding
) CoreApi
methodgetCached(...)
for accessing cachedPropertyData
has been deprecated and replaced bygetData(...)
which provides an async access toPropertyData
. This method will fetch cachedPropertyData
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
inloc-marketing-sdk
- Fixed several
LiveData
flow issues forapp-template-mall
andapp-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 ofRoutePreview
screen,mapUiApi.events().launchRoutePreview(routeResponse)
- Refactored creation of
Waypoint
objects fromWaypointHelper.from(...)
toWaypoint.from(...)
- Refactored prefetching map data to
core-sdk
(specified viaCoreParams
), 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 requirefloorId
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 andplay-services-auth
to v20.6.0.
Changes
- Removed
context
fromcoreApi.location().getQuickRoughEstimate(...)
- Replaced
MapUiApi.LocationServicesCallback
withCoreApi.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 aboolean
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 servicessdk-map
restructure to be more modularsdk-map-ui
restructure to be more modular
New Features
CoreParams
added for customization ofsdk-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
andCustomMapParams
must now be supplied for initializationMapstedSdkController
renamed toMapstedMapUiApi
- Removed various singleton instances
BearingCallback
replaced with separate callbacks forPhoneHeading
,UserHeading
, andFusedHeading
(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 propertyMapstedMapApi.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 tomapApi
- Bug fix for
filterAndSortSearchables
incoreApi
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 foronFailure
andonStatusUpdate
- 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 forPhoneHeading
,UserHeading
, andFusedHeading
(coreApi.heading()
)- Added ability to programatically enable/disable snapping of blue dot to route path (
coreApi.location().enableSnapBlueDotToRoute(...)
) - Added
getDistanceTimeToEndOfRoute
andgetUserDistanceTimeToRoute
toMNRouteUserProgress
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