Search Support GitHub Product Blog CMS

Android SDK v4 Changelog

Last updated:

Changelog for the MapsIndoors Android SDK. This document structure is based on Keep a Changelog and the project adheres to Semantic Versioning.

[4.1.0] 2023-02-21

Deprecated

  • Deprecated MPBuilding.getInitialZIndex() and added getInitialFloorIndex() to replace it
  • Deprecated MPBuilding.getFloorByZIndex() and added getFloorByIndex to replace it
  • Deprecated MPDataSetCache.setScope(Context, MPDataSetCacheScope) and added `setScope(MPDataSetCacheScope) to replace it
  • Deprecated MPDataSetCacheItem.getCacheSize(Context) and added getCacheSize() to replace it
  • Deprecated MPDirectionsService(Context) CTOR and added MPDirectionsService() to replace it
  • Deprecated MPFloor.getZIndex() and added getFloorIndex to replace it
  • Deprecated MPFloor.setZIndex() and added setFloorIndex to replace it
  • Deprecated MPRouteCoordinate.getZIndex() and added getFloorIndex to replace it
  • Deprecated MPRouteCoordinate.setZIndex() and added setFloorIndex to replace it
  • Deprecated MPSolutionInfo as it duplicates information from MPSolution

Fixed

  • Fixed ANY_DOMAIN livedata domain not having any effect
  • Fixed rare issue where collision between markers could cause a crash
  • Fixed issue where setting some listeners could cause a crash
  • Fixed reference documentation around MPVenue.getName(), see the migration guide for more information
  • Various fixes and improvements

[4.0.5] 2023-01-26

Added

  • Added Extension functions for converters, these are usable from kotlin projects

Fixed

  • Fixed issue where SDK would try to use destroyed context to access files directory
  • Fixed MPSelectionBehavior and MPFilterBehavior super class MPMapBehavior not being public
  • Fixed a number of memory leaks

[4.0.4] 2023-01-17

Fixed

  • Fixed issue with the livedata SDK where subscribing to some domains would subscribe to multiple domains instead
  • Fixed issue where MPApiKeyValidator would send multiple errors instead of just one
  • Fixed issue where the SDK would update UI elements on non-main thread
  • Fixed memory leaks where the map view was leaked

[4.0.3] 2023-01-05

Added

  • Added factory methods fromValue(int) and fromStringValue(String) to MPCollisionHandling
  • Added removeOnFloorUpdateListener(OnFloorUpdateListener) to MapControl
  • Added isInside(MPLatLng) method to MPGeometry

Deprecated

  • Deprecated getCurrentStyle() and setCurrentStyle(String) in MPFloor

Fixed

  • Fixed issue where main and solution type rules could not be fetched by name
  • Fixed issue where SDK would crash during startup
  • Fixed issue where giving MPPoints with no floorIndexes to MPDirectionsService would result in bugged routes
  • Fixed issue when generating MPPolygonGeometry from MPMultiPolygonGeometry
  • Fixed memory leak where the SDK would hold onto the maps FrameLayout
  • Fixed issues that could occur if the SDK is shut down during startup

[4.0.2] 2022-11-02

Added

  • Added Reverse Geocoding interface
    • It can be used to fetch mapsindoors data from a given geographical coordinate
  • Added ability to use a Context when building a MPMapConfig, instead of an Activity

Fixed

  • Fixed 2D model rendering related issues
  • Fixed Live Data badges in some cases overlapping the icon or label
  • Fixed issue with Main Display Rule not being respected in some instances
  • Fixed race-condition crash that could occur on Google Maps

[4.0.1] 2022-10-18

Added

  • Added getLocationsByExternalIds to MapsIndoors
    • This can be used to get a list of locations based on a corresponding list of external ids
  • Exposed layer names on Mapbox implementation, allowing custom layers to be inserted between MapsIndoors layers
    • The list of layers can be accessed from the MPLayers class

Fixed

  • Fixed issue with display rule inheritance from the main display rule
  • Fixed memory issue that could occur when loading a large amount of 2D models
  • Various minor fixes

[4.0.0] 2022-09-29

Added

  • Support for new map providers
    • Mapbox
      • MapsIndoors can now be packaged with the Mapbox v10 SDK
  • 2D Model support
    • The Android SDK is now capable of displaying 2D Models (also known as Ground Overlays)
  • goTo()
    • A new method for moving the camera to MapsIndoors locations, this new method goTo() can be used with any class that implements MPEntity, which includes but is not limited to MPLocation, MPFloor, and MPBuilding
  • Solution Config
    • The Android SDK now supports the Solution Config
    • This also introduces the new Main Display Rule, which is bundled into the solution config, along with collision handling, clustering and 3D (walls and extrusions) opacity

Changed

  • Maven package changes
    • With the move to supporting multiple map platforms, we had to move some stuff around in the package, the SDK can now be downloaded via these maven dependencies
      • 'com.mapspeople.mapsindoors:googlemaps:4.0.0'
      • 'com.mapspeople.mapsindoors:mapbox:4.0.0'
  • Naming convention
    • All public classes now has a MP prefix, with the exemption of MapControl, MapsIndoors and some listeners
    • New interfaces will use the MPI prefix
    • Some public classes will have a [INTERNAL] at the top of their javadoc, these classes are used for communication between the core SDK and map platform specific code. Refrain from using these classes unless you know what you are doing
  • Display Rules
    • Display rules have been reworked completely
    • It has been reduced to a single class MPDisplayRule
    • It is now reference based, thus any changes to the rule are instantaneous
    • MPDisplayRuleOptions has been added and is used to bulk edit display rules
    • Display rules can be reset with reset() this will return the display rule to the state it has in the CMS
  • Display search results
    • Has been renamed to setFilter(), and have been reworked completely
    • Now takes a MPFilterBehavior, which is used to dictate the behavior of the filter on the map
  • Selection
    • Selection, like filtering, has improved, it now uses a MPSelectionBehavior which is used to dictate the behavior of the selection on the map
  • Initialization (MapsIndoors and MapControl)
    • Now MapsIndoors is initialized with the load(appContext, APIKey, listener) method. This applies to both initial initialization, and when updating the context or API key
    • MapControl no longer has a public constructor and initializer method, it now uses a factory method create(MPMapConfig, onMapControlReady)
      • The onMapControlReady listener will wait for MapControl to finish initializing, this guarantees that MapControl cannot be aquired in a broken state
      • The MPMapConfig is a collection of settings that previously had to be set on MapControl at various stages of initialization to take effect. These are now bundled into a single package that take effect when MapControl finishes initializing
        • These settings can still be updated individually at runtime
  • Routing
    • MPRoutingProvider has been renamed to MPDirectionsService to align with other platforms
    • MPDirectionsRenderer has been simplified in use, after creation MPDirectionsRenderer(MapControl), setRoute(MPRoute) can be called and it will display the route on the map
  • Clustering and Collision handling has been moved from MPAppConfig to MPSolutionConfig, and have recieved proper typing, Collision handling is now defined by an enum MPCollisionHandling
    • Collision handling now has multiple states that allow for better control of how markers are shown on the map

Removed

  • The MPPositionProvider interface has been reduced to 3 methods thare are essential for interfacing a position provider with the SDK
  • A large amount of unused/unwanted/unusable classes have been removed from the SDK

Fixed

  • Optimized memory management of icons
  • Display rules are now applied much more consistently