Skip to main content
Version: 6.0

Release Notes

Mappedin SDK for iOS release notes are posted here and this page will be kept up-to-date as updates are released.

6.11.0 - November 18, 2026​

Packages​

  • @mappedin/blue-dot: 6.31.0-beta.0
  • @mappedin/dynamic-focus: 6.31.0-beta.0
  • @mappedin/events: 6.31.0-beta.0
  • @mappedin/icons: 8.4.1
  • @mappedin/mappedin-js: 6.31.0

Features​

  • Upgraded to Mappedin JS v6.31.0

  • Added shadows to Show3DMapOptions, which enables shadow rendering. Shadows stay off when the option is omitted. Shadows.auto is the recommended value: it picks a quality tier from the device and turns shadows off where they cannot render. Shadows.enabled uses the default settings, Shadows.disabled turns shadows off, and Shadows.custom sets them explicitly.

mapView.show3dMap(
options: Show3DMapOptions(
shadows: .auto
)
) { result in
if case .success = result {
print("Map shown")
}
}
  • ShadowsOptions.quality accepts .low, .medium, or .high. .high uses the highest-quality preset and can allocate a 4096 shadow map. On mobile, Shadows.enabled and a ShadowsOptions that omits quality are capped at .medium to bound VRAM. Pass ShadowsOptions(quality: .high) to force the high tier.

  • ShadowsOptions.frustumMode is .venue (the default) or .zoom. .venue caps the shadow light frustum at the shadow casters' bounding sphere, so a small venue keeps sharper shadows when zoomed out. .zoom derives the frustum from zoom alone. ShadowsOptions.visibleAtZoomLevel sets the zoom level where shadows fade in and defaults to 15.

  • ShadowsOptions also exposes debug, baseColor, shadowOpacity, pcfSamples, pcfSpread, shadowBias, normalBias, shadowMapSize, sunAzimuth, and sunElevation for explicit control.

  • Added travelDistanceOptions to FindNearestOptions, which applies excludedConnections and zones when mode is .travelDistance, so Query.nearest ranks results the same way getDirections does under the same constraints. A result that can only be reached through an excluded connection, or through a zone whose cost is Infinity, is omitted. The reported distance includes zone cost, so it can be larger than maxDistance. accessible and connectionIdWeightMap are not yet supported here.

mapData.query.nearest(
origin: origin,
include: [.pointOfInterest],
options: FindNearestOptions(
mode: .travelDistance,
travelDistanceOptions: FindNearestTravelOptions(
excludedConnections: [elevator],
zones: [avoidanceZone]
)
)
) { result in
if case .success(let nearest) = result {
print("Found \(nearest?.count ?? 0) results")
}
}
  • Added costAccumulation to DirectionZone, which controls when a zone's cost is charged. CostAccumulation.perNode is the default, so existing routes are unchanged: every navigation node the route steps onto inside the zone adds the cost. CostAccumulation.perZoneEntry charges the cost once each time the route enters the zone. Moving inside the zone adds nothing, and entering again charges again. .perZoneEntry is intended to become the default in the next major version. A cost of Infinity still blocks the zone.
mapData.getDirections(
from: start,
to: destination,
options: GetDirectionsOptions(
zones: [
DirectionZone(
cost: 1000,
costAccumulation: .perZoneEntry,
geometry: departmentPolygon
)
]
)
) { result in
if case .success = result {
print("Directions calculated")
}
}
  • Added textWrap to LabelAppearance and LabelState.Appearance, which controls how a Label breaks onto multiple lines. LabelTextWrap.maxWidth is the default and fills each line until the next word would pass maxWidth. LabelTextWrap.balance keeps the same number of lines and makes them as even in length as possible. Single-line Labels are unchanged, and maxLines still truncates with ....
mapView.labels.add(
target: space,
text: "Restrooms and guest services are straight ahead past the fountain",
options: AddLabelOptions(
labelAppearance: LabelAppearance(
maxLines: 4,
textWrap: .balance
)
)
)
  • Added align to AddText3DPointOptions and InitializeText3DState, which sets the horizontal alignment of Text3D content to Text3DAlign.left, .center, or .right. The default is .center.
mapView.text3D.add(
target: coordinate,
content: "Gate A12",
options: AddText3DPointOptions(
align: .left
)
)
  • Added visibleThroughGeometry to ShapeUpdateState and ShapeState. When true, a Shape renders on top of walls, floors, and other geometry; depth testing and writing are disabled and the Shape is given an always-on-top render order. The default is false, and getState returns the value that was set.
mapView.updateState(
shape: shape,
state: ShapeUpdateState(visibleThroughGeometry: true)
)
  • Added text3ds to ClickPayload and HoverPayload, which lists the 3D texts an interaction passed through. Each entry is a Text3DRef that carries the text's id.
mapView.on(Events.click) { payload in
if let text = payload?.text3ds?.first {
print("Clicked 3D text \(text.id)")
}
}
  • Added BlueDot.recordAnchor, which records an analytics anchor without moving the Blue Dot. The AnchorScan carries latitude, longitude, and optionally source, timestamp, accuracy, and floorLevel. AnchorSource is .vps, .qr, or .manual; an anchor without a source is not sent. A missing timestamp defaults to now when the anchor is recorded.
mapView.blueDot.recordAnchor(
scan: AnchorScan(
latitude: 43.6426,
longitude: -79.3871,
source: .qr,
accuracy: 3.0,
floorLevel: 1
)
) { result in
if case .success = result {
print("Anchor recorded")
}
}

Performance​

  • Improved directions performance on large maps, including .dpOptimal path smoothing.
  • Improved path arrow animation performance, resulting in lower CPU use while arrows animate.
  • Improved shadow rendering performance, resulting in higher frame rates while the camera moves and lower memory use.
  • Improved frame rates while panning and interacting with large maps.
  • Improved Label and Marker occlusion, removing brief frame stalls while the camera moves.

Fixes​

  • Fixed an issue where default .greedyLos path smoothing drew a node-to-node zigzag through an open area with a clear line of sight. The path now collapses across that open area. The first step still follows the edge the router chose, so smoothing does not cut across a zone the route was avoiding.
  • Fixed an issue where a Space side texture also tinted the top face.
  • Fixed an issue where replacing a legacy Space texture with a plain texture kept the old repeat, offset, and rotation.
  • Fixed an issue where re-hydrating a bundle from toJSONBundle drew each Enterprise Space texture twice.
  • Fixed an issue where dashes on a ribbon Path disappeared, and which dashes disappeared changed with zoom.
  • Fixed an issue where floor footprints were visible by default. Footprints stay hidden until multi-floor view shows them, or until updateState sets a floor's footprint.
  • Fixed an issue where releasing a drag on a Model or Marker fired a click, including a drag that ended near where it started.
  • Fixed an issue where fading an instanced Model replaced each material's own opacity, so transparent parts of the model appeared as a halo.
  • Fixed an issue where a Model with visibleThroughGeometry = true drew nested meshes twice, leaving stray geometry away from the pin.
  • Fixed an issue where Marker zIndex did not change stacking order. zIndex now sets stacking against sibling Markers when a Marker is added or updated.
  • Fixed an issue where the hidden placement was tried in list order for Marker placement and Label textPlacement. The hidden placement is now always tried last, wherever it is listed. Also fixed an issue where creating a Marker with its own placement replaced the default center-first placement for Markers created afterwards.
  • Fixed an issue where a truncated right-to-left Label drew ... at the start of the text. The ellipsis now sits at the end of the text.
  • Fixed an issue where shadows on a floor high above the ground, or on a floor with a large altitude, drifted away from the walls and could disappear on the highest floors.
  • Fixed an issue where a tall shadow caster lost part of its ground shadow, and the missing piece shifted while panning.
  • Fixed an issue where shadows stopped rendering after a zoom change while they were faded out.
  • Fixed an issue where updateState on a point Text3D did not show a new position until a later interaction. The text now redraws after the new layout is ready.
  • Fixed an issue where updateState on an Image3DView ignored flipImagesToFaceCamera, position, rotation, width, height, and verticalOffset.
  • Fixed an issue where Directions instructions dropped a turn at a corner that was not a fork. A bearing change of about 18° or more is now reported as a turn, whether or not another corridor leaves that point.
  • Fixed an issue where floor footprints, including exterior walls and ceilings, did not receive shadows.
  • Fixed an issue where a below-ground floor showed no shadows when that floor was in view.
  • Fixed an issue where Events.cameraChange fired once for each camera property inside a single camera update. One update now publishes one Events.cameraChange with the final camera transform. An update that leaves the transform unchanged no longer publishes Events.cameraChange.

6.10.0 - September 30, 2026​

Packages​

  • @mappedin/blue-dot: 6.29.0-beta.0
  • @mappedin/dynamic-focus: 6.29.0-beta.0
  • @mappedin/events: 6.29.0-beta.0
  • @mappedin/icons: 8.4.1
  • @mappedin/mappedin-js: 6.29.0

Features​

  • Upgraded to Mappedin JS v6.29.0

  • Added MapView.auto, which places Labels for the map and renders Annotations as icon-only Labels. The returned AutoElements.markers list is empty. MapView.__EXPERIMENTAL__auto remains and still creates Markers for Annotations. It is deprecated.

mapView.auto { result in
if case .success(let elements) = result {
print("Created \(elements.labels.count) labels")
}
}
  • Added path rendering options on AddPathOptions, used by Paths.add and by NavigationOptions.pathOptions.
mapView.paths.add(
coordinates: directions.coordinates,
options: AddPathOptions(
geometry: .ribbon,
smoothing: AddPathOptions.Smoothing(tension: 0.15, cornerRadius: 0.5),
border: AddPathOptions.Border(enabled: true, color: "darken"),
endcapExtension: (0.5, 0.5),
billboarding: .threshold(80),
dash: AddPathOptions.Dash(
enabled: true,
mode: .widthScaling,
size: 1.2,
gapSize: 0.6
),
xray: AddPathOptions.Xray(opacity: 0.25, tint: 0.3, dithering: 2.0)
)
)
  • geometry is .tube (the default round path) or .ribbon (a flat path). A dashed ribbon draws each dash as its own shape. A dashed tube paints the dash pattern on one continuous path.

  • dash configures dashed paths. dash.enabled turns dashing on. dashed remains as the boolean switch. dash.cornerRadius ranges from 0 (sharp) to 1 (fully rounded) and defaults to 0. It applies to ribbon geometry. A dash with only enabled: true uses width-scaled dashes (size 1.2, gapSize 0.6). dash.mode is .widthScaling (the default), .lengthScaling, or .absolute.

  • smoothing sets corner tension and cornerRadius in metres. It is separate from GetDirectionsOptions.smoothing, which simplifies the route.

  • xray sets how the path looks when it passes behind geometry: opacity, color, tint, and dithering.

  • endcapExtension, billboarding, and border apply to ribbon geometry. endcapExtension is a start and end pair in metres. A value above 0 extends the path and draws a rounded cap. 0 is a square end. The default is 0.5 and 0.5. billboarding is .off, .on, or .threshold in degrees from 0 to 90 (default 80).

  • Added method and includeDoorBufferNodes to GetDirectionsOptions.Smoothing.configured. method is .greedyLos (the default), .rdp, or .dpOptimal. includeDoorBufferNodes keeps door-adjacent nodes during simplification. It defaults to true for .rdp and false for .dpOptimal, and .greedyLos ignores it. Existing smoothing defaults are unchanged. GetDirectionsOptions.Smoothing.withRadius is deprecated. It still sets radius and enabled, and cannot set method or includeDoorBufferNodes.

mapData.getDirections(
from: start,
to: end,
options: GetDirectionsOptions(
smoothing: .configured(
radius: 0.4,
enabled: true,
method: .dpOptimal,
includeDoorBufferNodes: true
)
)
) { result in
if case .success(let directions) = result, let directions {
mapView.navigation.draw(directions: directions)
}
}
  • Added showAllFloorsIncludedInNavigation to MultiFloorViewOptions. When enabled, every floor a navigation Path traverses is rendered, including floors above the current floor on a descending route, so the Path and its vertical connection segments stay visible. The default is false.
mapView.show3dMap(
options: Show3DMapOptions(
multiFloorView: MultiFloorViewOptions(
enabled: true,
showAllFloorsIncludedInNavigation: true
)
)
) { result in
if case .success = result {
print("Map shown")
}
}
  • Added slopeEnabled, slopeBearing, and slopeFactor to GeometryUpdateState and GeometryState. When slopeEnabled is true, the top face tilts into a flat ramp along a compass bearing while the floor stays flat. slopeBearing is in degrees (0 is north, increasing clockwise). slopeFactor ranges from -1 to 1, where 0 is flat and 1 slopes down in the bearing direction.
mapView.updateState(
space: space,
state: GeometryUpdateState(
height: 6.0,
slopeEnabled: true,
slopeBearing: 350.0,
slopeFactor: 1.0
)
)
  • Added opensMessage and closesMessage to OpeningHoursSpecification. These strings replace the displayed open or close time for special hours, such as "Hours may vary". They appear on the entries in EnterpriseLocation.operationHours.raw and LocationProfile.openingHours.raw, and follow the active language.

  • Added fuzzy and prefix to Search.query and Search.suggest. On query, enterpriseCategories, enterpriseLocations, and places can each set their own values. On suggest, enterpriseLocations and places can set them. fuzzy of 0 disables typo tolerance. A value greater than 0 and less than 1 is a fraction of the term length. A value of 1 or greater is an edit count. The default is 0.2. prefix controls as-you-type matching and defaults to true. Omitting either option keeps the existing behaviour.

mapData.search.query(
term: "coffee",
options: Search.QueryOptions(
enterpriseLocations: Search.QueryOptions.EnterpriseLocationOptions(
fuzzy: 0.0,
prefix: false
)
)
) { result in
if case .success(let searchResult) = result {
print("Found \(searchResult?.locations?.count ?? 0) locations")
}
}

Performance​

  • Improved Label memory use on maps with many labels, including icon-only labels.

Fixes​

  • Fixed an issue where MapData.checkForUpdates failed for a hydrated map that uses the EU gateway.
  • Fixed an issue where a two-finger pinch stopped working when the second finger landed on a layer above the map.
  • Fixed an issue where borders failed to render on geometry that contains a hole, and were missing on smooth outlines.
  • Fixed an issue where map data failed to load when a Node referenced a neighbor that was missing from the map.
  • Fixed an issue where the end of a Blue Dot tethered navigation Path disappeared when the route looped back near the user.
  • Fixed an issue where Labels with maxLines greater than 2 rendered only the first two lines.

6.9.0 - September 15, 2026​

Packages​

  • @mappedin/blue-dot: 6.27.0-beta.0
  • @mappedin/dynamic-focus: 6.27.0-beta.0
  • @mappedin/events: 6.27.0-beta.0
  • @mappedin/icons: 8.4.1
  • @mappedin/mappedin-js: 6.27.0

Features​

  • Upgraded to Mappedin JS v6.27.0

  • Added Labels.getAll, which returns every Label currently on the map.

mapView.labels.getAll { result in
if case .success(let labels) = result {
print("\(labels.count) labels on the map")
}
}
  • Added scalingStrategy to BlueDotOptions.AccuracyRing and BlueDotState.AccuracyRingState. The default AccuracyRingScalePreset.trueScale keeps the ring at the reported accuracy in real-world metres. AccuracyRingScalePreset.clampViewport caps the ring diameter at 60% of the smaller viewport dimension so a coarse GPS fix does not swallow the map.
mapView.blueDot.enable(
options: BlueDotOptions(
accuracyRing: BlueDotOptions.AccuracyRing(
scalingStrategy: .clampViewport
)
)
)
  • Added Events.longPress, which fires after a tap is held in place for approximately 500 milliseconds without panning or a second finger. The payload is a ClickPayload, matching Events.click. A long-press does not also emit Events.click.
mapView.on(Events.longPress) { payload in
if let space = payload?.space {
print("Long-pressed \(space.name)")
}
}
  • Added MapData.checkForUpdates, which checks whether the map data has changed since it was loaded without downloading the full bundle. It returns a CheckForUpdatesResult with hasChanges and updatedAt. Maps hydrated from a local bundle via hydrateMapData do not have a load-time timestamp and will fail.
  • Added MapData.updatedAt, which returns the timestamp reported by the API when the map data was loaded.
mapData.checkForUpdates { result in
switch result {
case .success(let update):
if update?.hasChanges == true {
// re-load with getMapData
}
case .failure(let error):
print("Error: \(error)")
}
}

Performance​

  • Improved Query.nearest performance in travel-distance mode, especially when searching many destinations across all floors.

Fixes​

  • Fixed an issue where Markers.getAll omitted Markers anchored to a Space, Door, Node, or other non-coordinate target.
  • Fixed an issue where Query.nearest with mode set to .travelDistance and limit set to .allFloors ranked destinations by straight-line distance instead of travel distance, so a destination on another floor could be chosen over a nearby one on the same floor.
  • Fixed an issue where Camera.focusOn in outdoor mode ignored screenOffsets and inset padding, so the camera centred on the full viewport instead of the visible map area.
  • Fixed an issue where direction arrows on short sloped connection Paths, such as escalators, appeared stretched.
  • Fixed an issue where a two-finger pinch fired a map Events.click.
  • Fixed an issue where panning the camera fired Events.cameraChange twice for each movement.
  • Fixed an issue where simplified Paths could curve through nearby obstacles instead of taking a straight line from start to end.

6.8.0 - August 18, 2026​

Packages​

  • @mappedin/blue-dot: 6.24.1-beta.0
  • @mappedin/dynamic-focus: 6.24.1-beta.0
  • @mappedin/events: 6.24.1-beta.0
  • @mappedin/icons: 8.4.1
  • @mappedin/mappedin-js: 6.24.1

Features​

  • Upgraded to Mappedin JS v6.24.1

  • Added MapView.setLogLevel, which sets the underlying Mappedin JS SDK log verbosity at runtime. The default is SdkLogLevel.info, so verbose SdkLogLevel.debug output is opt-in. The method can be called before or after the map has loaded.

// Re-enable verbose SDK logging
mapView.setLogLevel(.debug)

// Quiet the SDK entirely
mapView.setLogLevel(.silent)
  • Added iconBorderRadiusFactor to LabelAppearance and LabelState.Appearance, which controls the corner rounding of a Label's icon pin so it can render as a rounded square instead of only a circle. The value is a fraction of half the pin's size, where 1 (the default) is a circle, 0 is a square, and values in between round proportionally. It can be set when adding a Label or updated at runtime.
mapView.labels.add(
target: space,
text: space.name,
options: AddLabelOptions(
labelAppearance: LabelAppearance(iconBorderRadiusFactor: 0.5)
)
)

mapView.updateState(
label: label,
state: LabelUpdateState(appearance: LabelAppearance(iconBorderRadiusFactor: 1.0))
)
  • Added enable2DCollisions to BlueDotOptions and BlueDotState (default false). When enabled, nearby Labels and Markers yield to the Blue Dot instead of painting over it. Labels ranked CollisionRankingTier.alwaysVisible can still overlap the Blue Dot.
mapView.blueDot.enable(options: BlueDotOptions(enable2DCollisions: true))
  • Added cameraLiftAnimationOptions to DynamicFocusOptions and DynamicFocusState, which customizes the camera elevation lift on floor change when MultiFloorViewOptions.updateCameraElevationOnFloorChange is enabled. Defaults to a 500 ms ease-in-out animation that can be interrupted.
mapView.dynamicFocus.enable(
options: DynamicFocusOptions(
cameraLiftAnimationOptions: CameraAnimationOptions(
duration: 500,
easing: .easeInOut,
interruptible: true
)
)
)

Fixes​

  • Fixed an issue where a Model moved with updateState would become unhittable, so hover and click events no longer detected it at its new position.
  • Fixed an issue where Path hover height was approximately twice the specified verticalOffset.
  • Fixed an issue where a Model with clipping enabled would jump to twice its intended world position after a subsequent updateState.

6.7.0 - July 28, 2026​

Packages​

  • @mappedin/blue-dot: 6.23.0-beta.0
  • @mappedin/dynamic-focus: 6.23.0-beta.0
  • @mappedin/events: 6.23.0-beta.0
  • @mappedin/icons: 8.4.0
  • @mappedin/mappedin-js: 6.23.0

Features​

  • Upgraded to Mappedin JS v6.23.0

  • Expanded the feature types returned by Query.nearest. In addition to PointOfInterest, Door, Annotation, Node, and Space, results can now include MapObject, LocationProfile, Connection, Area, and Facade. These map to new FindNearestResult.Feature cases (.mapObject, .locationProfile, .connection, .area, and .facade) and their matching MapDataType values in the include list

mapData.query.nearest(origin: origin, include: [.mapObject, .connection, .area]) { result in
if case .success(let results) = result {
results?.forEach { queryResult in
switch queryResult.feature {
case .connection(let connection):
print("Connection at \(queryResult.distance)m")
case .area(let area):
print("Area \(area.name) at \(queryResult.distance)m")
default:
break
}
}
}
}
  • Added the geometryText and floorText visibility sub-axes to FloorState.Text3D, so consumer-added 3D text and baked floor text can be toggled independently of the overall visible flag. floorText reveals through open-to-below voids, while geometryText stays current-floor only

6.6.0 - July 17, 2026​

Packages​

  • @mappedin/blue-dot: 6.22.0-beta.0
  • @mappedin/dynamic-focus: 6.22.0-beta.0
  • @mappedin/events: 6.22.0-beta.0
  • @mappedin/icons: 8.4.0
  • @mappedin/mappedin-js: 6.22.0

Features​

  • Upgraded to Mappedin JS v6.22.0

  • Added the markers method to Navigation, accessible via mapView.navigation.markers, which returns the departure, destination, and connection Markers drawn for the current route as strongly typed NavigationMarker values. Each NavigationMarker exposes its marker and a NavigationMarkerType (.departure, .destination, or .connection)

mapView.navigation.markers { result in
if case .success(let markers) = result {
for navMarker in markers {
switch navMarker.type {
case .departure: break
case .destination: break
case .connection: break
}
}
}
}
  • Added the markers property to NavigationState and wired the navigationStateChange event on Events, so navigation Markers can be observed as the current route changes

  • Added the interactive property to PathState and PathUpdateState, allowing Paths to be made clickable at runtime so they receive click and hover events (defaults to false)

mapView.updateState(path: path, state: PathUpdateState(interactive: true))
  • Added the isConnectionSegment and distance properties to PathSegment

Fixes​

  • Fixed an issue where the onMVFParsed callback on GetMapDataWithCredentialsOptions and GetMapDataWithAccessTokenOptions was never invoked. It now fires once after the map data is fetched and parsed, delivering a strongly typed MVF model. Providing this callback increases initial map load time, so only set it when the parsed MVF is required

6.5.0 - July 1, 2026​

Packages​

  • @mappedin/blue-dot: 6.21.1-beta.0
  • @mappedin/dynamic-focus: 6.21.1-beta.0
  • @mappedin/events: 6.21.1-beta.0
  • @mappedin/icons: 8.3.0
  • @mappedin/mappedin-js: 6.21.1

Features​

  • Upgraded to Mappedin JS v6.21.1

  • Added the activeFloor case to DynamicFocusMode, which preserves the last floor a consumer or end-user selected across outdoor-to-indoor zoom cycles, rather than resetting to the building's default floor like defaultFloor

dynamicFocus.enable(options: DynamicFocusOptions(
mode: .activeFloor,
autoFocus: true,
setFloorOnFocus: true
)) { _ in }
  • Added the layoutId property to GetMapDataWithCredentialsOptions and GetMapDataWithAccessTokenOptions for loading a draft (unpublished) enterprise map. Set it to "draft" to fetch the latest unpublished changes. This requires an Enterprise API key and only applies to maps made in Mappedin CMS
let options = GetMapDataWithCredentialsOptions(
key: "enterprise-key",
secret: "enterprise-secret",
mapId: "mapId",
layoutId: "draft"
)
  • Added the displayArrowsOnPath property to PathSectionHighlightOptions to independently control whether direction arrows are drawn inside a highlighted path section, regardless of the path-level setting

  • Added the interactivity property to GeometryState, GeometryUpdateState, ShapeState, and ShapeUpdateState. The Interactive type supports .boolean(true) and .boolean(false) (with .true and .false convenience values) as well as .passThrough, which lets pointer events fall through to whatever is rendered behind the geometry

mapView.updateState(space, state: GeometryUpdateState(
interactivity: .passThrough
)) { _ in }

Deprecated​

  • interactive on GeometryState, GeometryUpdateState, ShapeState, and ShapeUpdateState has been deprecated in favor of interactivity, which also supports the pass-through state

6.4.0 - June 5, 2026​

Packages​

  • @mappedin/blue-dot: 6.20.0-beta.0
  • @mappedin/dynamic-focus: 6.20.0-beta.0
  • @mappedin/events: 6.20.0-beta.0
  • @mappedin/icons: 8.3.0
  • @mappedin/mappedin-js: 6.20.0

Features​

  • Upgraded to Mappedin JS v6.20.0

  • Added the Icons API, accessible via mapView.icons, for working with Mappedin's CDN-backed icon library. The API mirrors the @mappedin/icons web package and is map-independent, so it can be used without a loaded map. It includes lookup methods (getByName, getByType, getBySubtype, getByCategory, getByTags, getAll, getSmallIcon), SVG fetching (fetchSvg), pre-fetching (prefetch, prefetchByType, prefetchBySubtype, prefetchByCategory), cache management (isCached, getCachedSvg, clearCache), and CDN region selection via initialize. New strongly typed models include MappedinIcon, IconType, IconSubtype, IconCategory, and IconCdnRegion

// Look up an icon by name
mapView.icons.getByName(name: "information") { result in
if case .success(let icon) = result {
print(icon.url)
}
}

// Fetch the raw SVG markup for an icon
mapView.icons.fetchSvg(name: "information") { result in
if case .success(let svg) = result {
// Render the SVG
}
}

// Pre-fetch all icons in a category for offline use
mapView.icons.prefetchByCategory(category: .foodAndDrink) { _ in }

6.3.0 - May 20, 2026​

  • Upgraded to Mappedin JS v6.19.0

Features​

  • Added visible property to BlueDotOptions, AccuracyRing, and Heading to control the visibility of Blue Dot components independently

  • Added AutoZoomThresholds enum (.disabled, .enabled, .enabledWith(options:)) to DynamicFocusOptions and DynamicFocusState for configuring DynamicFocus auto-zoom behavior

let options = DynamicFocusOptions(
autoZoomThresholds: .enabledWith(options: .init(debug: true))
)
  • Added .floorStack(FloorStack) case to the FocusTarget enum, with convenience focusOn and getFocusOnTransform overloads on Camera for focusing on a FloorStack
mapView.camera.focusOn(.floorStack(floorStack))
  • Added Events.cameraScreenOffsetsChange event to listen for camera screen offset changes

  • Added .pixels(String) case to Width for pixel-based width values (e.g. "20px")

  • Added Navigation.trackCoordinate method for path tethering and travelled-path tracking, with TetheredOptions, TravelledOptions, TrackCoordinateOptions, TrackCoordinateResult, TrackingMode, CoordinateOutsideThresholdMode, and OutsideThresholdPathStyle models

let handle = mapView.navigation.trackCoordinate(
origin: startCoordinate,
destinations: [destinationSpace],
options: TrackCoordinateOptions(
mode: .tethered,
tethered: TetheredOptions(
outsideThresholdMode: .smoothTransition,
outsideThresholdDistance: 5.0
)
)
) { result in /* ... */ }

mapView.blueDot.on(.dotPositionUpdate) { payload in
handle?.update(coordinate: payload.coordinate)
}
  • Added BlueDotEvents.dotPositionUpdate event that emits smoothed Coordinate updates suitable for feeding into Navigation.trackCoordinate

  • Added includeNonPublic property to GetDirectionsOptions to allow routing through non-public spaces and connections

  • Added interactive property to AddImageOptions and interactive/cursor properties to ImageState and ImageUpdateState. Image3DView is now exposed in ClickPayload and HoverPayload images and target

Deprecated​

  • BlueDot.update() has been deprecated in favor of BlueDot.forcePosition() or BlueDot.reportPosition()
// Before (deprecated)
mapView.blueDot.update(
position: BlueDotPositionUpdate(
latitude: .value(lat),
longitude: .value(lng),
floorId: .id(floorId)
),
options: BlueDotUpdateOptions(animate: true)
) { _ in }

// After
mapView.blueDot.reportPosition(
options: ManualPositionOptions(
latitude: lat,
longitude: lng,
floorLevel: floorLevel,
confidence: 1.0
)
) { _ in }

6.2.0 - April 2, 2026​

  • Upgraded to Mappedin JS v6.17.1

  • Added - BlueDot.forcePosition method to override all positioning sensors with a fixed position for a specified duration

let target = BlueDot.ForcePositionTarget(
latitude: 43.5186,
longitude: -80.5394,
heading: 90.0,
floorLevel: 1
)
mapView.blueDot.forcePosition(position: target, durationMs: 30000) { result in
// Position forced
}
  • Added - BlueDot.reportPosition method to feed a confidence-weighted position into the positioning fusion engine
let options = ManualPositionOptions(
latitude: 43.5186,
longitude: -80.5394,
accuracy: 5.0,
confidence: 0.8
)
mapView.blueDot.reportPosition(options: options) { result in
// Position reported
}
  • Added - Blue Dot sensor management methods: enableSensor, disableSensor, checkSensorPermission, requestSensorPermission, and isSensorEnabled for controlling individual positioning sensor sources

  • Added - BlueDotEvents.anchorSet and BlueDotEvents.anchorExpired events with PositionAnchor payload for monitoring anchor lifecycle

mapView.blueDot.on(BlueDotEvents.anchorSet) { payload in
guard let anchor = payload?.anchor else { return }
print("Anchor set: \(anchor.sensorId) at \(anchor.latitude), \(anchor.longitude)")
}
  • Added - floorGapMultiplier and floorGapFallback properties to MultiFloorViewOptions for finer control over floor spacing in multi-floor view

  • Added - animated property to AddMarkerOptions to control whether Markers animate when added

  • Added - MaterialSide.auto case for automatic material side selection based on opacity

  • Added - EventsManager API accessible via mapView.mapData.eventsManager for loading and querying CMS events. Includes load(), getEvents(), getById(), and getByLocationId() methods

mapView.mapData.eventsManager.load { result in
if case .success = result {
mapView.mapData.eventsManager.getEvents { eventsResult in
if case .success(let events) = eventsResult {
for event in events {
print("\(event.name): \(event.startDate) - \(event.endDate)")
}
}
}
}
}
  • Added - position property to ShapeState and ShapeUpdateState, enabling reading and updating the position of Shapes
// Get the position of a shape
mapView.getState(shape: shape) { result in
if case .success(let state) = result {
print("Shape position: \(state?.position.latitude), \(state?.position.longitude)")
}
}

// Move a shape to a new position
let newPosition = Coordinate(latitude: 43.46, longitude: -80.52)
mapView.updateState(shape: shape, state: ShapeUpdateState(position: newPosition))
  • Added - Models.all() method to load all CMS-defined 3D Models for a venue

  • Added - MultiFloorViewEffectState model and related APIs for configuring visual effects on floors visible through open-to-below Spaces in multi-floor view. Access the current state via GlobalState.multiFloorView and update it at runtime via GlobalStateUpdate.multiFloorView

// Configure visual effects at init time
let options = Show3DMapOptions(
multiFloorView: MultiFloorViewOptions(
spacesOpenToBelowEnabled: true,
spacesOpenToBelowVisualEffectEnabled: true,
spacesOpenToBelowVisualEffectDarkenAmount: 0.3,
spacesOpenToBelowVisualEffectDesaturateAmount: 0.7
)
)

// Update visual effects at runtime
mapView.updateGlobalState(update: GlobalStateUpdate(
multiFloorView: GlobalStateUpdate.MultiFloorViewEffectStateUpdate(
spacesOpenToBelowVisualEffectDarkenAmount: 0.5
)
))
  • Added - Events.globalStateChange event emitted when updateGlobalState() is called

  • Fixed - an issue where facades could cover the map when calling setMap

6.2.0-beta.1 - February 13, 2026​

  • Upgraded to Mappedin JS v6.14.0

  • Added - Query.at method to find all geometry objects (Spaces, MapObjects, Areas, Floors) at a given coordinate, with typed results returned as QueryAtResult

mapView.mapData.query.at(coordinate: coordinate) { result in
switch result {
case .success(let results):
results?.forEach { queryResult in
switch queryResult {
case .space(let space):
mapView.updateState(space: space, state: GeometryUpdateState(color: "#FF6B35"))
case .mapObject(let mapObject):
print("MapObject at point: \(mapObject.name)")
case .area(let area):
print("Area at point: \(area.name)")
case .floor(let floor):
print("Floor at point: \(floor.name)")
default:
break
}
}
case .failure(let error):
print("Query.at failed: \(error)")
}
}
  • Added - FloorState.Images.collisionsEnabled property to control whether floor images participate in collision detection

  • Added - ModelUpdateState.clippingPlaneZOffset property to control model clipping plane. Use .infinity to disable clipping

// Disable clipping for a model
let noClipState = ModelUpdateState(clippingPlaneZOffset: .infinity)

// Set explicit clipping plane offset
let clipState = ModelUpdateState(clippingPlaneZOffset: 5.0)
  • Added - DynamicFocus methods for full API parity:
    • preloadFloors() - Preloads initial floors for improved rendering performance
    • setIndoor() and setOutdoor() - Forces indoor or outdoor view state regardless of zoom level
    • setDefaultFloorForStack(floorStack:floor:) and resetDefaultFloorForStack(floorStack:) - Manages default floors for FloorStacks
    • getDefaultFloorForStack(floorStack:) and getCurrentFloorForStack(floorStack:) - Gets default and current floors
    • setCurrentFloorForStack(floorStack:floor:) - Sets the current visible floor for a FloorStack
    • exclude(floorStack:) / exclude(floorStacks:) and include(floorStack:) / include(floorStacks:) - Excludes or includes FloorStacks from Dynamic Focus visibility changes
    • destroy() - Destroys the DynamicFocus instance and cleans up event listeners
// Force indoor view
dynamicFocus.setIndoor()

// Set current floor for a floor stack
dynamicFocus.setCurrentFloorForStack(floorStack: building.floorStack, floor: floor2) { _ in }

// Exclude a building from dynamic focus visibility changes
dynamicFocus.exclude(floorStack: parkingGarage.floorStack)

// Clean up when done
dynamicFocus.destroy()
  • Added - MapData.isEnterpriseMode property to determine whether the loaded map uses CMS/Enterprise or Maker data. Runtime warnings are now logged when requesting data types that do not match the active data source
mapView.mapData.isEnterpriseMode { result in
switch result {
case .success(let isEnterprise):
if isEnterprise {
mapView.mapData.getByType(.enterpriseLocation) { (locResult: Result<[EnterpriseLocation], Error>) in
// Handle enterprise locations
}
} else {
mapView.mapData.getByType(.locationProfile) { (locResult: Result<[LocationProfile], Error>) in
// Handle maker locations
}
}
case .failure(let error):
print("Error: \(error)")
}
}

6.2.0-beta.0 - February 2, 2026​

  • Upgraded to Mappedin JS v6.13.0

  • Added - BlueDot support via MapView.blueDot extension with enable/disable/update/follow/getters and typed event subscriptions. Includes CoreLocation integration for native location and heading updates. New models include BlueDotState, BlueDotOptions, BlueDotUpdateOptions, FollowMode, and FollowCameraOptions

  • Added - MapView.dynamicFocus extension providing enable, disable, getState, updateState, and focus methods for Dynamic Focus functionality. Includes new models DynamicFocusOptions, DynamicFocusState, DynamicFocusMode, and DynamicFocusAnimationOptions

  • Added - Experimental MapView.__EXPERIMENTAL__auto() method for automatic label and marker setup

  • Added - hydrateMapDataFromURL(url:options:) method for hydrating map data directly from a URL

  • Added - Cache URL handling with mappedin-cache:// scheme and FileManager helper to build cache URLs

  • Added - Support for loading maps from MVF filename for improved offline capabilities

  • Added - LocationProfile.searchTags property for accessing location search tags

  • Added - allFloors option to Query.nearest() to search across all floors instead of just the current floor

  • Added - images3D getter to PointOfInterest, Space, Area, and MapObject classes with new Image3DView model

  • Improved - Map loading performance by optimizing how map data is passed to the WebView

6.2.0-alpha.3 - January 16, 2026​

  • Upgraded to Mappedin JS v6.11.0

  • Added - MapData.on method for subscribing to map data events. This enables listening for events such as language changes on the map data object. Use MapData.changeLanguage to change the current language and subscribe to changes using MapDataEvents.languageChange

// Change the map language to Spanish
mapView.mapData.changeLanguage("es")

// Listen for language change events
mapView.mapData.on(MapDataEvents.languageChange) { payload in
if let language = payload {
print("Language changed to \(language.name) (\(language.code))")
}
}
  • Added - FloorState.text3d property to access 3D text state for a floor

  • Added - LocationProfile.extra property to access additional profile data

  • Added - enterpriseLocation property to Space and MapObject, providing direct access to enterprise location data when available

  • Added - LocationProfile.logoImage property as a replacement for the deprecated logo property

  • Added - Strongly typed MapData.hydrateMapData options parameter for better type safety when hydrating cached map data

  • Added - Support for caching map data in binary format for improved offline performance

  • Added - Experimental support for Spaces that are open to below in multi-floor view. When enabled, floors will render with cutouts for Spaces like atriums that span multiple levels, creating a more realistic visualization. Enable this feature using MultiFloorViewOptions.spacesOpenToBelowEnabled

  • Added - New MultiFloorViewOptions properties for customizing floor footprints in multi-floor view:

    • footprintColor - Sets the color of the floor footprint
    • footprintOpacity - Controls the opacity of the floor footprint
    • footprintOutline - Configures the outline appearance of the floor footprint
  • Changed - MultiFloorViewOptions.floorGap now supports both a numeric value or an auto setting for automatic gap calculation between floors

  • Fixed - Bridge serialization issue where FloorStack.geoJSON and other complex GeoJSON properties were not being passed correctly over the native bridge. This resolves issues when accessing GeoJSON data from floor stacks and related objects

  • Deprecated - LocationProfile.logo has been deprecated in favor of LocationProfile.logoImage

6.2.0-alpha.2 - January 8, 2026​

  • Upgraded to Mappedin JS v6.10.0
  • Added - getDirections must also accept an array of NavigationTarget
  • Added - Coordinate.geoJSON
  • Fixed - mapView.updateState is not working on walls or doors
  • Fixed - getDirectionsMultiDestination's to method should use NavigationTarget not Any
  • Removed - Duplicated unused standalone classes of Point, LineString and MultiPolygon that are defined in Geometry

⚠️ Breaking Changes​

  • Changed - Clean up remaining generic types
  • Changed - Strongly type .geoJSON properties
  • Changed - Shapes.add should be strongly typed
// ❌ Before
// Get the GeoJSON from the area
guard let areaGeoJSON = area.geoJSON else { return }

// Create a FeatureCollection containing the Feature of the Area
var shapeFeatureCollection: [String: Any] = [
"type": "FeatureCollection",
"features": []
]

var feature: [String: Any] = [
"type": areaGeoJSON["type"] as? String ?? "Feature"
]

if let properties = areaGeoJSON["properties"] as? [String: Any] {
feature["properties"] = properties
}

if let geometry = areaGeoJSON["geometry"] as? [String: Any] {
feature["geometry"] = geometry
}

shapeFeatureCollection["features"] = [feature]

// Draw the shape
mapView.shapes.add(
geometry: shapeFeatureCollection,
style: PaintStyle(color: color, altitude: altitude, height: height, opacity: opacity)
) { _ in }

// ✅ After
// Get the GeoJSON Feature from the area
guard let feature = area.geoJSON else { return }

// Create a FeatureCollection containing the single Feature
let featureCollection = FeatureCollection(features: [feature])

// Draw the shape using the typed API
mapView.shapes.add(
geometry: featureCollection,
style: PaintStyle(color: color, altitude: altitude, height: height, opacity: opacity)
) { _ in }

6.2.0-alpha.1 - December 30, 2025​

  • Upgraded to Mappedin JS v6.9.1.
  • Added - Show3DMapOptions.preloadFloors option to preload floors.
  • Added -MultiFloorViewOptions.floorGap option to set the gap between floors.
  • Fixed - Show3DMapOptions.initialFloor should accept only a string.

⚠️ Breaking Changes​

  • Changed - Strongly type MapView.on parameters and return values
// ❌ Before
self.mapView.on("click") { [weak self] payload in
guard let self = self,
let clickPayload = payload as? ClickPayload,
}

// ❌ Before
self.mapView.on(Events.click) { [weak self] payload in
guard let self = self,
let clickPayload = payload as? ClickPayload,
}

// ✅ After
self.mapView.on(Events.click) { [weak self] clickPayload in
guard let self = self
}

6.1.0-alpha.1 - December 19, 2025​

  • Added - LabelAppearance.iconScale property to control the scale of the icon.

⚠️ Breaking Changes​

  • Fixed - Removed duplicate inline implementation of Interpolation and Width.
// ❌ Before
let opts = AddPathOptions(width: .fixed(1.0))

// ✅ After
let opts = AddPathOptions(width: .value(1.0))
  • Fixed - MapView.getState and MapView.updateState should use data classes and not plain objects.
// ❌ Before
self.mapView.updateState(target: space, state: ["interactive": interactive]) { _ in }

// ✅ After
self.mapView.updateState(space: space, state: GeometryUpdateState(interactive: interactive))

6.0.0-alpha.0 - December 12, 2025​

  • Initial release of Mappedin SDK for iOS v6.