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
shadowstoShow3DMapOptions, which enables shadow rendering. Shadows stay off when the option is omitted.Shadows.autois the recommended value: it picks a quality tier from the device and turns shadows off where they cannot render.Shadows.enableduses the default settings,Shadows.disabledturns shadows off, andShadows.customsets them explicitly.
mapView.show3dMap(
options: Show3DMapOptions(
shadows: .auto
)
) { result in
if case .success = result {
print("Map shown")
}
}
-
ShadowsOptions.qualityaccepts.low,.medium, or.high..highuses the highest-quality preset and can allocate a 4096 shadow map. On mobile,Shadows.enabledand aShadowsOptionsthat omitsqualityare capped at.mediumto bound VRAM. PassShadowsOptions(quality: .high)to force the high tier. -
ShadowsOptions.frustumModeis.venue(the default) or.zoom..venuecaps the shadow light frustum at the shadow casters' bounding sphere, so a small venue keeps sharper shadows when zoomed out..zoomderives the frustum from zoom alone.ShadowsOptions.visibleAtZoomLevelsets the zoom level where shadows fade in and defaults to15. -
ShadowsOptionsalso exposesdebug,baseColor,shadowOpacity,pcfSamples,pcfSpread,shadowBias,normalBias,shadowMapSize,sunAzimuth, andsunElevationfor explicit control. -
Added
travelDistanceOptionstoFindNearestOptions, which appliesexcludedConnectionsandzoneswhenmodeis.travelDistance, soQuery.nearestranks results the same waygetDirectionsdoes under the same constraints. A result that can only be reached through an excluded connection, or through a zone whose cost isInfinity, is omitted. The reporteddistanceincludes zone cost, so it can be larger thanmaxDistance.accessibleandconnectionIdWeightMapare 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
costAccumulationtoDirectionZone, which controls when a zone'scostis charged.CostAccumulation.perNodeis the default, so existing routes are unchanged: every navigation node the route steps onto inside the zone adds the cost.CostAccumulation.perZoneEntrycharges the cost once each time the route enters the zone. Moving inside the zone adds nothing, and entering again charges again..perZoneEntryis intended to become the default in the next major version. A cost ofInfinitystill 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
textWraptoLabelAppearanceandLabelState.Appearance, which controls how aLabelbreaks onto multiple lines.LabelTextWrap.maxWidthis the default and fills each line until the next word would passmaxWidth.LabelTextWrap.balancekeeps the same number of lines and makes them as even in length as possible. Single-lineLabels are unchanged, andmaxLinesstill 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
aligntoAddText3DPointOptionsandInitializeText3DState, which sets the horizontal alignment ofText3Dcontent toText3DAlign.left,.center, or.right. The default is.center.
mapView.text3D.add(
target: coordinate,
content: "Gate A12",
options: AddText3DPointOptions(
align: .left
)
)
- Added
visibleThroughGeometrytoShapeUpdateStateandShapeState. Whentrue, aShaperenders on top of walls, floors, and other geometry; depth testing and writing are disabled and theShapeis given an always-on-top render order. The default isfalse, andgetStatereturns the value that was set.
mapView.updateState(
shape: shape,
state: ShapeUpdateState(visibleThroughGeometry: true)
)
- Added
text3dstoClickPayloadandHoverPayload, which lists the 3D texts an interaction passed through. Each entry is aText3DRefthat carries the text'sid.
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. TheAnchorScancarrieslatitude,longitude, and optionallysource,timestamp,accuracy, andfloorLevel.AnchorSourceis.vps,.qr, or.manual; an anchor without a source is not sent. A missingtimestampdefaults 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
.dpOptimalpath 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
LabelandMarkerocclusion, removing brief frame stalls while the camera moves.
Fixes
- Fixed an issue where default
.greedyLospath 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
Spaceside texture also tinted the top face. - Fixed an issue where replacing a legacy
Spacetexture with a plain texture kept the old repeat, offset, and rotation. - Fixed an issue where re-hydrating a bundle from
toJSONBundledrew each EnterpriseSpacetexture twice. - Fixed an issue where dashes on a ribbon
Pathdisappeared, 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
updateStatesets a floor'sfootprint. - Fixed an issue where releasing a drag on a
ModelorMarkerfired aclick, including a drag that ended near where it started. - Fixed an issue where fading an instanced
Modelreplaced each material's own opacity, so transparent parts of the model appeared as a halo. - Fixed an issue where a
ModelwithvisibleThroughGeometry = truedrew nested meshes twice, leaving stray geometry away from the pin. - Fixed an issue where
MarkerzIndexdid not change stacking order.zIndexnow sets stacking against siblingMarkers when aMarkeris added or updated. - Fixed an issue where the hidden placement was tried in list order for
MarkerplacementandLabeltextPlacement. The hidden placement is now always tried last, wherever it is listed. Also fixed an issue where creating aMarkerwith its ownplacementreplaced the default center-first placement forMarkers created afterwards. - Fixed an issue where a truncated right-to-left
Labeldrew...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
updateStateon a pointText3Ddid not show a newpositionuntil a later interaction. The text now redraws after the new layout is ready. - Fixed an issue where
updateStateon anImage3DViewignoredflipImagesToFaceCamera,position,rotation,width,height, andverticalOffset. - Fixed an issue where
Directionsinstructionsdropped 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.cameraChangefired once for each camera property inside a single camera update. One update now publishes oneEvents.cameraChangewith the final camera transform. An update that leaves the transform unchanged no longer publishesEvents.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 placesLabels for the map and rendersAnnotations as icon-onlyLabels. The returnedAutoElements.markerslist is empty.MapView.__EXPERIMENTAL__autoremains and still createsMarkers forAnnotations. 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 byPaths.addand byNavigationOptions.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)
)
)
-
geometryis.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. -
dashconfigures dashed paths.dash.enabledturns dashing on.dashedremains as the boolean switch.dash.cornerRadiusranges from0(sharp) to1(fully rounded) and defaults to0. It applies to ribbon geometry. Adashwith onlyenabled: trueuses width-scaled dashes (size1.2,gapSize0.6).dash.modeis.widthScaling(the default),.lengthScaling, or.absolute. -
smoothingsets corner tension andcornerRadiusin metres. It is separate fromGetDirectionsOptions.smoothing, which simplifies the route. -
xraysets how the path looks when it passes behind geometry:opacity,color,tint, anddithering. -
endcapExtension,billboarding, andborderapply to ribbon geometry.endcapExtensionis a start and end pair in metres. A value above0extends the path and draws a rounded cap.0is a square end. The default is0.5and0.5.billboardingis.off,.on, or.thresholdin degrees from0to90(default80). -
Added
methodandincludeDoorBufferNodestoGetDirectionsOptions.Smoothing.configured.methodis.greedyLos(the default),.rdp, or.dpOptimal.includeDoorBufferNodeskeeps door-adjacent nodes during simplification. It defaults totruefor.rdpandfalsefor.dpOptimal, and.greedyLosignores it. Existing smoothing defaults are unchanged.GetDirectionsOptions.Smoothing.withRadiusis deprecated. It still setsradiusandenabled, and cannot setmethodorincludeDoorBufferNodes.
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
showAllFloorsIncludedInNavigationtoMultiFloorViewOptions. When enabled, every floor a navigationPathtraverses is rendered, including floors above the current floor on a descending route, so thePathand its vertical connection segments stay visible. The default isfalse.
mapView.show3dMap(
options: Show3DMapOptions(
multiFloorView: MultiFloorViewOptions(
enabled: true,
showAllFloorsIncludedInNavigation: true
)
)
) { result in
if case .success = result {
print("Map shown")
}
}
- Added
slopeEnabled,slopeBearing, andslopeFactortoGeometryUpdateStateandGeometryState. WhenslopeEnabledistrue, the top face tilts into a flat ramp along a compass bearing while the floor stays flat.slopeBearingis in degrees (0is north, increasing clockwise).slopeFactorranges from-1to1, where0is flat and1slopes down in the bearing direction.
mapView.updateState(
space: space,
state: GeometryUpdateState(
height: 6.0,
slopeEnabled: true,
slopeBearing: 350.0,
slopeFactor: 1.0
)
)
-
Added
opensMessageandclosesMessagetoOpeningHoursSpecification. These strings replace the displayed open or close time for special hours, such as "Hours may vary". They appear on the entries inEnterpriseLocation.operationHours.rawandLocationProfile.openingHours.raw, and follow the active language. -
Added
fuzzyandprefixtoSearch.queryandSearch.suggest. Onquery,enterpriseCategories,enterpriseLocations, andplacescan each set their own values. Onsuggest,enterpriseLocationsandplacescan set them.fuzzyof0disables typo tolerance. A value greater than0and less than1is a fraction of the term length. A value of1or greater is an edit count. The default is0.2.prefixcontrols as-you-type matching and defaults totrue. 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
Labelmemory use on maps with many labels, including icon-only labels.
Fixes
- Fixed an issue where
MapData.checkForUpdatesfailed 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
Nodereferenced a neighbor that was missing from the map. - Fixed an issue where the end of a Blue Dot tethered navigation
Pathdisappeared when the route looped back near the user. - Fixed an issue where
Labels withmaxLinesgreater 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 everyLabelcurrently on the map.
mapView.labels.getAll { result in
if case .success(let labels) = result {
print("\(labels.count) labels on the map")
}
}
- Added
scalingStrategytoBlueDotOptions.AccuracyRingandBlueDotState.AccuracyRingState. The defaultAccuracyRingScalePreset.trueScalekeeps the ring at the reported accuracy in real-world metres.AccuracyRingScalePreset.clampViewportcaps 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 aClickPayload, matchingEvents.click. A long-press does not also emitEvents.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 aCheckForUpdatesResultwithhasChangesandupdatedAt. Maps hydrated from a local bundle viahydrateMapDatado 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.nearestperformance in travel-distance mode, especially when searching many destinations across all floors.
Fixes
- Fixed an issue where
Markers.getAllomittedMarkers anchored to aSpace,Door,Node, or other non-coordinate target. - Fixed an issue where
Query.nearestwithmodeset to.travelDistanceandlimitset to.allFloorsranked 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.focusOnin outdoor mode ignoredscreenOffsetsand 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.cameraChangetwice 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 isSdkLogLevel.info, so verboseSdkLogLevel.debugoutput 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
iconBorderRadiusFactortoLabelAppearanceandLabelState.Appearance, which controls the corner rounding of aLabel'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, where1(the default) is a circle,0is a square, and values in between round proportionally. It can be set when adding aLabelor 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
enable2DCollisionstoBlueDotOptionsandBlueDotState(defaultfalse). When enabled, nearbyLabels andMarkers yield to the Blue Dot instead of painting over it.Labels rankedCollisionRankingTier.alwaysVisiblecan still overlap the Blue Dot.
mapView.blueDot.enable(options: BlueDotOptions(enable2DCollisions: true))
- Added
cameraLiftAnimationOptionstoDynamicFocusOptionsandDynamicFocusState, which customizes the camera elevation lift on floor change whenMultiFloorViewOptions.updateCameraElevationOnFloorChangeis 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
Modelmoved withupdateStatewould become unhittable, so hover and click events no longer detected it at its new position. - Fixed an issue where
Pathhover height was approximately twice the specifiedverticalOffset. - Fixed an issue where a
Modelwith clipping enabled would jump to twice its intended world position after a subsequentupdateState.
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 toPointOfInterest,Door,Annotation,Node, andSpace, results can now includeMapObject,LocationProfile,Connection,Area, andFacade. These map to newFindNearestResult.Featurecases (.mapObject,.locationProfile,.connection,.area, and.facade) and their matchingMapDataTypevalues in theincludelist
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
geometryTextandfloorTextvisibility sub-axes toFloorState.Text3D, so consumer-added 3D text and baked floor text can be toggled independently of the overallvisibleflag.floorTextreveals through open-to-below voids, whilegeometryTextstays 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
markersmethod toNavigation, accessible viamapView.navigation.markers, which returns the departure, destination, and connectionMarkers drawn for the current route as strongly typedNavigationMarkervalues. EachNavigationMarkerexposes itsmarkerand aNavigationMarkerType(.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
markersproperty toNavigationStateand wired thenavigationStateChangeevent onEvents, so navigationMarkers can be observed as the current route changes -
Added the
interactiveproperty toPathStateandPathUpdateState, allowingPaths to be made clickable at runtime so they receive click and hover events (defaults tofalse)
mapView.updateState(path: path, state: PathUpdateState(interactive: true))
- Added the
isConnectionSegmentanddistanceproperties toPathSegment
Fixes
- Fixed an issue where the
onMVFParsedcallback onGetMapDataWithCredentialsOptionsandGetMapDataWithAccessTokenOptionswas never invoked. It now fires once after the map data is fetched and parsed, delivering a strongly typedMVFmodel. 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
activeFloorcase toDynamicFocusMode, 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 likedefaultFloor
dynamicFocus.enable(options: DynamicFocusOptions(
mode: .activeFloor,
autoFocus: true,
setFloorOnFocus: true
)) { _ in }
- Added the
layoutIdproperty toGetMapDataWithCredentialsOptionsandGetMapDataWithAccessTokenOptionsfor 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
displayArrowsOnPathproperty toPathSectionHighlightOptionsto independently control whether direction arrows are drawn inside a highlighted path section, regardless of the path-level setting -
Added the
interactivityproperty toGeometryState,GeometryUpdateState,ShapeState, andShapeUpdateState. TheInteractivetype supports.boolean(true)and.boolean(false)(with.trueand.falseconvenience 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
interactiveonGeometryState,GeometryUpdateState,ShapeState, andShapeUpdateStatehas been deprecated in favor ofinteractivity, 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
IconsAPI, accessible viamapView.icons, for working with Mappedin's CDN-backed icon library. The API mirrors the@mappedin/iconsweb 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 viainitialize. New strongly typed models includeMappedinIcon,IconType,IconSubtype,IconCategory, andIconCdnRegion
// 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
visibleproperty toBlueDotOptions,AccuracyRing, andHeadingto control the visibility of Blue Dot components independently -
Added
AutoZoomThresholdsenum (.disabled,.enabled,.enabledWith(options:)) toDynamicFocusOptionsandDynamicFocusStatefor configuringDynamicFocusauto-zoom behavior
let options = DynamicFocusOptions(
autoZoomThresholds: .enabledWith(options: .init(debug: true))
)
- Added
.floorStack(FloorStack)case to theFocusTargetenum, with conveniencefocusOnandgetFocusOnTransformoverloads onCamerafor focusing on aFloorStack
mapView.camera.focusOn(.floorStack(floorStack))
-
Added
Events.cameraScreenOffsetsChangeevent to listen for camera screen offset changes -
Added
.pixels(String)case toWidthfor pixel-based width values (e.g."20px") -
Added
Navigation.trackCoordinatemethod for path tethering and travelled-path tracking, withTetheredOptions,TravelledOptions,TrackCoordinateOptions,TrackCoordinateResult,TrackingMode,CoordinateOutsideThresholdMode, andOutsideThresholdPathStylemodels
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.dotPositionUpdateevent that emits smoothedCoordinateupdates suitable for feeding intoNavigation.trackCoordinate -
Added
includeNonPublicproperty toGetDirectionsOptionsto allow routing through non-public spaces and connections -
Added
interactiveproperty toAddImageOptionsandinteractive/cursorproperties toImageStateandImageUpdateState.Image3DViewis now exposed inClickPayloadandHoverPayloadimagesandtarget
Deprecated
BlueDot.update()has been deprecated in favor ofBlueDot.forcePosition()orBlueDot.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.forcePositionmethod 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.reportPositionmethod 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, andisSensorEnabledfor controlling individual positioning sensor sources -
Added -
BlueDotEvents.anchorSetandBlueDotEvents.anchorExpiredevents withPositionAnchorpayload 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 -
floorGapMultiplierandfloorGapFallbackproperties toMultiFloorViewOptionsfor finer control over floor spacing in multi-floor view -
Added -
animatedproperty toAddMarkerOptionsto control whetherMarkers animate when added -
Added -
MaterialSide.autocase for automatic material side selection based on opacity -
Added -
EventsManagerAPI accessible viamapView.mapData.eventsManagerfor loading and querying CMS events. Includesload(),getEvents(),getById(), andgetByLocationId()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 -
positionproperty toShapeStateandShapeUpdateState, enabling reading and updating the position ofShapes
// 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 3DModels for a venue -
Added -
MultiFloorViewEffectStatemodel and related APIs for configuring visual effects on floors visible through open-to-belowSpaces in multi-floor view. Access the current state viaGlobalState.multiFloorViewand update it at runtime viaGlobalStateUpdate.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.globalStateChangeevent emitted whenupdateGlobalState()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.atmethod to find all geometry objects (Spaces,MapObjects,Areas,Floors) at a given coordinate, with typed results returned asQueryAtResult
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.collisionsEnabledproperty to control whether floor images participate in collision detection -
Added -
ModelUpdateState.clippingPlaneZOffsetproperty to control model clipping plane. Use.infinityto disable clipping
// Disable clipping for a model
let noClipState = ModelUpdateState(clippingPlaneZOffset: .infinity)
// Set explicit clipping plane offset
let clipState = ModelUpdateState(clippingPlaneZOffset: 5.0)
- Added -
DynamicFocusmethods for full API parity:preloadFloors()- Preloads initial floors for improved rendering performancesetIndoor()andsetOutdoor()- Forces indoor or outdoor view state regardless of zoom levelsetDefaultFloorForStack(floorStack:floor:)andresetDefaultFloorForStack(floorStack:)- Manages default floors forFloorStacksgetDefaultFloorForStack(floorStack:)andgetCurrentFloorForStack(floorStack:)- Gets default and current floorssetCurrentFloorForStack(floorStack:floor:)- Sets the current visible floor for aFloorStackexclude(floorStack:)/exclude(floorStacks:)andinclude(floorStack:)/include(floorStacks:)- Excludes or includesFloorStacks from Dynamic Focus visibility changesdestroy()- Destroys theDynamicFocusinstance 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.isEnterpriseModeproperty 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 -
BlueDotsupport viaMapView.blueDotextension with enable/disable/update/follow/getters and typed event subscriptions. Includes CoreLocation integration for native location and heading updates. New models includeBlueDotState,BlueDotOptions,BlueDotUpdateOptions,FollowMode, andFollowCameraOptions -
Added -
MapView.dynamicFocusextension providingenable,disable,getState,updateState, andfocusmethods for Dynamic Focus functionality. Includes new modelsDynamicFocusOptions,DynamicFocusState,DynamicFocusMode, andDynamicFocusAnimationOptions -
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.searchTagsproperty for accessing location search tags -
Added -
allFloorsoption toQuery.nearest()to search across all floors instead of just the current floor -
Added -
images3Dgetter toPointOfInterest,Space,Area, andMapObjectclasses with newImage3DViewmodel -
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.onmethod for subscribing to map data events. This enables listening for events such as language changes on the map data object. UseMapData.changeLanguageto change the current language and subscribe to changes usingMapDataEvents.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.text3dproperty to access 3D text state for a floor -
Added -
LocationProfile.extraproperty to access additional profile data -
Added -
enterpriseLocationproperty toSpaceandMapObject, providing direct access to enterprise location data when available -
Added -
LocationProfile.logoImageproperty as a replacement for the deprecatedlogoproperty -
Added - Strongly typed
MapData.hydrateMapDataoptions 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
MultiFloorViewOptionsproperties for customizing floor footprints in multi-floor view:footprintColor- Sets the color of the floor footprintfootprintOpacity- Controls the opacity of the floor footprintfootprintOutline- Configures the outline appearance of the floor footprint
-
Changed -
MultiFloorViewOptions.floorGapnow supports both a numeric value or anautosetting for automatic gap calculation between floors -
Fixed - Bridge serialization issue where
FloorStack.geoJSONand 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.logohas been deprecated in favor ofLocationProfile.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.preloadFloorsoption to preload floors. - Added -
MultiFloorViewOptions.floorGapoption to set the gap between floors. - Fixed -
Show3DMapOptions.initialFloorshould 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.getStateandMapView.updateStateshould 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.