Skip to main content


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

iOS Version Requirements

MapsIndoors SDK v4 requires at least iOS 13 and Xcode 14.

[4.1.3] 2023-06-07


  • The haloWidth parameter of setMapLabelFont() now renders on Google Maps as well.
  • The polygonStrokeWidth property of a DisplayRule is now being respected.
  • The info window on Google Maps is shown at the correct position.

[4.1.2] 2023-06-01


  • MPMapControlDelegate has been enhanced to enable listening to camera movements.


  • The iconSize property of a DisplayRule is now being respected, so icons show up with the intended size.
  • MPCustomFloorSelector has been rewired, allowing users to personalize the floor selection.
  • Map padding is now available for Mapbox, allowing users to adjust the spacing around the map.
  • The background color and solid color of a rendered route can now be customized.
  • The halo effect on labels is now available for use, enhancing the visual appearance of labels.
  • MPMapControl.setFilter() no longer crashes.

[4.1.1] 2023-05-23


  • The MapsIndoorsMapbox Cocoapod now uses the correct version of Mapbox

[4.1.0] 2023-05-17


  • Mapbox version now 10.13.1 which adds:
    • Extrusions of Walls and Rooms


  • Multi-line label cut-off
  • Marker missing when selecting location
  • Clustering icon size fix
  • Mapbox 10.13.1 fixes some Layers glitching
  • Fixed some known bugs

[4.0.3] 2023-04-21



  • Icons are now respecting zoom levels in Display Rules
  • Labels are now respecting zoom levels in Display Rules inherited from the Location Type
  • MPMapControl.hideFloorSelector now actually hides the floor selector

[4.0.2] 2023-04-13


  • A number of rendering issues have been corrected.
  • An issue that could prevent a route from being correctly created.

[4.0.1] 2023-04-05


  • Fixed crash with Mapbox when panning around the map.

[4.0.0] 2023-03-31

Version 4 of the MapsIndoors SDK has changed significantly compared to version 3. There is a migration guide that describes the changes.


  • Support for new map providers
    • MapsIndoors can now be used with the Mapbox v10 SDK.
  • goTo(entity:)
    • 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 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 and clustering.
  • New Cocoapods
    • The main Cocoapod to use is either MapsIndoorsGoogleMaps or MapsIndoorsMapbox depending on the map engine to use.
      • Both of these Cocoapods are dependent on the MapsIndoors and MapsIndoorsCore Cocoapods and will automatically include them.
      • Most classes in MapsIndoorsCore are public but meant for communication between the core SDK and map platform specific code. These classes are not described in the reference docs. Refrain from using these classes unless you know what you are doing.


  • Initialisation of MapsIndoors
    • The interface to initiate the SDK is improved for smaller and safer implementations.
    • Initialise MapsIndoors with MPMapsIndoors.shared.load(apiKey: "YOUR_MAPSINDOORS_API_KEY")
  • Initialization of MapControl
    • In order to support multiple map engines an MPMapConfig is needed.
    • The MPMapConfig is then used to create a MapControl: let mapControl = MPMapsIndoors.createMapControl(mapConfig: mapConfig).
  • Display Rules
    • Display Rules have been reworked completely.
    • Display Rules are now reference based, thus any changes to a rule are instantaneous.
    • Display Rules can be reset with reset(). This will return the display rule to the state it has in the CMS.
  • The iOS SDK Reference Docs have been modernised and are now available at
  • Many interface changes. See migration guide for help in migrating from MapsIndoors SDK v3.
  • Minimum iOS version supported is iOS 13.
  • Required Xcode version is Xcode 14.