Release Notes
Mappedin SDK for Android release notes are posted here and this page will be kept up-to-date as updates are released.
v6.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
- 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(
Show3DMapOptions(
shadows = Shadows.Auto,
),
) { result ->
result.onSuccess { Log.d("MapView", "Map shown") }
}
-
ShadowsOptions.qualityacceptsShadowsOptions.Quality.LOW,MEDIUM, orHIGH.HIGHuses the highest-quality preset and can allocate a 4096 shadow map. On mobile,Shadows.Enabledand aShadowsOptionsthat omitsqualityare capped atMEDIUMto bound VRAM. PassShadowsOptions(quality = ShadowsOptions.Quality.HIGH)to force the high tier. -
ShadowsOptions.frustumModeisShadowsOptions.FrustumMode.VENUE(the default) orZOOM.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 appliesexcludedConnectionsandzoneswhenmodeisFindNearestOptions.Mode.TRAVEL_DISTANCE, 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 = listOf(MapDataType.POINT_OF_INTEREST),
options = FindNearestOptions(
mode = FindNearestOptions.Mode.TRAVEL_DISTANCE,
travelDistanceOptions = FindNearestTravelOptions(
excludedConnections = listOf(elevator),
zones = listOf(avoidanceZone),
),
),
) { result ->
result.onSuccess { nearest ->
Log.d("Query", "Found ${nearest?.size ?: 0} results")
}
}
- Added
costAccumulationtoDirectionZone, which controls when a zone'scostis charged.CostAccumulation.PER_NODEis the default, so existing routes are unchanged: every navigation node the route steps onto inside the zone adds the cost.CostAccumulation.PER_ZONE_ENTRYcharges the cost once each time the route enters the zone. Moving inside the zone adds nothing, and entering again charges again.PER_ZONE_ENTRYis 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 = listOf(
DirectionZone(
cost = 1000.0,
costAccumulation = CostAccumulation.PER_ZONE_ENTRY,
geometry = departmentPolygon,
),
),
),
) { result ->
result.onSuccess { Log.d("Directions", "Directions calculated") }
}
- Added
textWraptoLabelAppearanceandLabelState.Appearance, which controls how aLabelbreaks onto multiple lines.LabelTextWrap.MAX_WIDTHis 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 = LabelTextWrap.BALANCE,
),
),
)
- Added
aligntoAddText3DPointOptionsandInitializeText3DState, which sets the horizontal alignment ofText3Dcontent toText3DAlign.LEFT,CENTER, orRIGHT. The default isCENTER.
mapView.text3D.add(
target = coordinate,
content = "Gate A12",
options = AddText3DPointOptions(
align = Text3DAlign.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,
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 ->
payload?.text3ds?.firstOrNull()?.let { text ->
Log.d("MapView", "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.AnchorSourceisVPS,QR, orMANUAL; an anchor without a source is not sent. A missingtimestampdefaults to now when the anchor is recorded.
mapView.blueDot.recordAnchor(
AnchorScan(
latitude = 43.6426,
longitude = -79.3871,
source = AnchorSource.QR,
accuracy = 3.0,
floorLevel = 1,
),
) { result ->
result.onSuccess { Log.d("BlueDot", "Anchor recorded") }
}
Performance
- Improved directions performance on large maps, including
DP_OPTIMALpath 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
GREEDY_LOSpath 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
MarkerPlacement.HIDDENwas tried in list order forMarkerplacementandLabelTextPlacement.HIDDENwas tried in list order forLabeltextPlacement.HIDDENis now always tried last, wherever it is listed. Also fixed an issue where creating aMarkerwith its ownplacementreplaced the defaultlistOf(MarkerPlacement.CENTER, MarkerPlacement.HIDDEN)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.
v6.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
- 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 ->
result.onSuccess { elements ->
Log.d("MapView", "Created ${elements.labels.size} labels")
}
}
- Added path rendering options on
AddPathOptions, used byPaths.addand byNavigationOptions.pathOptions.
mapView.paths.add(
directions.coordinates,
AddPathOptions(
geometry = AddPathOptions.Geometry.RIBBON,
smoothing = AddPathOptions.Smoothing(tension = 0.15, cornerRadius = 0.5),
border = AddPathOptions.Border(enabled = true, color = "darken"),
endcapExtension = 0.5 to 0.5,
billboarding = AddPathOptions.Billboarding.Threshold(80.0),
dash = AddPathOptions.Dash(
enabled = true,
mode = AddPathOptions.Dash.Mode.WIDTH_SCALING,
size = 1.2,
gapSize = 0.6,
),
xray = AddPathOptions.Xray(opacity = 0.25, tint = 0.3, dithering = 2.0),
),
)
-
geometryisAddPathOptions.Geometry.TUBE(the default round path) orAddPathOptions.Geometry.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.modeisWIDTH_SCALING(the default),LENGTH_SCALING, orABSOLUTE. -
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.5to0.5.billboardingisOff,On, or aThresholdin degrees from0to90(default80). -
Added
methodandincludeDoorBufferNodestoGetDirectionsOptions.Smoothing.Configured.methodisGREEDY_LOS(the default),RDP, orDP_OPTIMAL.includeDoorBufferNodeskeeps door-adjacent nodes during simplification. It defaults totrueforRDPandfalseforDP_OPTIMAL, andGREEDY_LOSignores it. Existing smoothing defaults are unchanged.GetDirectionsOptions.Smoothing.WithRadiusis deprecated. It still setsradiusandenabled, and cannot setmethodorincludeDoorBufferNodes.
mapData.getDirections(
start,
end,
GetDirectionsOptions(
smoothing = GetDirectionsOptions.Smoothing.Configured(
enabled = true,
method = GetDirectionsOptions.Smoothing.Method.DP_OPTIMAL,
includeDoorBufferNodes = true,
radius = 0.4,
),
),
) { result ->
result.onSuccess { directions ->
directions?.let { mapView.navigation.draw(it) }
}
}
- 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(
Show3DMapOptions(
multiFloorView = MultiFloorViewOptions(
enabled = true,
showAllFloorsIncludedInNavigation = true,
),
),
) { result ->
result.onSuccess {
Log.d("MapView", "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,
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(
"coffee",
Search.QueryOptions(
enterpriseLocations = Search.QueryOptions.EnterpriseLocationOptions(
fuzzy = 0.0,
prefix = false,
),
),
) { result ->
result.onSuccess { searchResult ->
Log.d("Search", "Found ${searchResult?.locations?.size ?: 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.
v6.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
- Added
Labels.getAll, which returns everyLabelcurrently on the map.
mapView.labels.getAll { result ->
result.onSuccess { labels ->
labels.forEach { label ->
Log.d("MappedinDemo", "Label: ${label.text}")
}
}
}
- Added
scalingStrategytoBlueDotOptions.AccuracyRingandBlueDotState.AccuracyRingState, which controls how the accuracy ring's on-screen size is derived from the reported accuracy. The default isAccuracyRingScalePreset.TRUE_SCALE, which draws the ring at real-world metres.AccuracyRingScalePreset.CLAMP_VIEWPORTkeeps true scale but caps the ring diameter at 60% of the smaller viewport dimension so a coarse GPS fix does not swallow the map.
mapView.blueDot.enable(
BlueDotOptions(
accuracyRing = BlueDotOptions.AccuracyRing(
scalingStrategy = AccuracyRingScalePreset.CLAMP_VIEWPORT,
),
),
)
- Added
Events.LongPress, which fires after a pointer is held in place for approximately 500 milliseconds without panning. The payload is aClickPayload, matchingEvents.Click. A long-press does not also emitEvents.Click.
mapView.on(Events.LongPress) { payload ->
payload?.space?.let { space ->
Log.d("MapView", "Long-pressed ${space.name}")
}
}
- Added
checkForUpdatestoMapData, 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.
mapData.checkForUpdates { result ->
result.onSuccess { update ->
if (update?.hasChanges == true) {
// re-load with getMapData
}
}
}
- Added
updatedAttoMapData, which returns the timestamp reported by the API when the map data was loaded.
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.nearestwith travel-distance mode and an all-floors limit 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 a two-finger pinch fired a map
Events.Click. - 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 simplified
Paths could curve through nearby obstacles instead of taking a straight line from start to end. - Fixed an issue where panning the camera fired
Events.CameraChangetwice for each movement.
v6.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
- 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(SdkLogLevel.DEBUG)
// Quiet the SDK entirely
mapView.setLogLevel(SdkLogLevel.SILENT)
- Added
iconBorderRadiusFactortoLabelAppearanceandLabelState.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, 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,
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.ALWAYS_VISIBLEcan still overlap the Blue Dot.
mapView.blueDot.enable(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(
DynamicFocusOptions(
cameraLiftAnimationOptions = CameraAnimationOptions(
duration = 500,
easing = EasingFunction.EASE_IN_OUT,
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.
v6.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
- Expanded the feature types returned by
Query.nearest(accessed throughMapView.mapData.query) to includeMapObject,LocationProfile,Connection,Area, andFacade, in addition to the previously supportedPointOfInterest,Door,Annotation,Node, andSpace. Each result is returned as the correspondingFindNearestResult.Featuresubclass.
mapView.mapData.query.nearest(
coordinate,
listOf(MapDataType.AREA, MapDataType.CONNECTION),
) { result ->
result.onSuccess { results ->
results?.forEach { nearest ->
when (val feature = nearest.feature) {
is FindNearestResult.Feature.AreaFeature -> { /* feature.area */ }
is FindNearestResult.Feature.ConnectionFeature -> { /* feature.connection */ }
else -> { /* ... */ }
}
}
}
}
- Added independent
geometryTextandfloorTextvisibility sub-axes toFloorState.Text3D, returned byMapView.getStatefor aFloor.geometryTextreports the visibility of consumer-added 3D text (current floor only), whilefloorTextreports the visibility of baked floor text, which can reveal through open-to-below voids. The existingvisibleflag continues to represent the entire Text3D layer.
v6.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
- Added
Navigation.markers, accessible viaMapView.navigation, which returns the departure, destination, and connectionMarkers drawn for the current route as strongly-typedNavigationMarkerobjects (each exposing amarkerand aNavigationMarkerType).
mapView.navigation.markers { result ->
result.onSuccess { markers ->
markers.forEach { navMarker ->
when (navMarker.type) {
NavigationMarkerType.DEPARTURE -> { /* ... */ }
NavigationMarkerType.DESTINATION -> { /* ... */ }
NavigationMarkerType.CONNECTION -> { /* ... */ }
}
}
}
}
-
Added
markerstoNavigationState, which is delivered to native subscribers of thenavigation-state-changeevent viaEvents.NavigationStateChange. -
Added
interactivetoPathStateandPathUpdateState(defaultfalse), which makes aPathclickable at runtime so it can dispatch click and hover events.
mapView.updateState(path, PathUpdateState(interactive = true))
-
Added
isConnectionSegmentanddistancetoPathSegment. -
Upgraded to Mappedin JS v6.22.0.
Fixes
- Fixed an issue where the
onMVFParsedcallback onGetMapDataWithCredentialsOptionsandGetMapDataWithAccessTokenOptionswas never invoked. When provided, it now fires once after the map data is fetched and parsed, receiving a strongly-typedMVFmodel.
v6.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
- Added
interactivitytoGeometryState,GeometryUpdateState,ShapeState, andShapeUpdateState, which controls how geometry and shapes participate in pointer-event raycasting. The newInteractivetype supportsInteractive.Boolean(true)(fires hover and click handlers),Interactive.Boolean(false)(captures the raycast so nothing behind it receives events, but fires no handler), andInteractive.PassThrough(skips the geometry entirely so events fall through to whatever is rendered behind it). TheTrueandFalseconvenience values are also provided. The existing booleaninteractiveproperty is now deprecated in favour ofinteractivity.
mapView.updateState(
space,
GeometryUpdateState(interactivity = GeometryState.Interactive.PassThrough),
) { }
-
Added
displayArrowsOnPathtoPathSectionHighlightOptions, which independently controls whether direction arrows are drawn inside a highlighted section of aPath, regardless of the path-leveldisplayArrowsOnPathsetting. -
Added
DynamicFocusMode.ACTIVE_FLOOR, a new Dynamic Focus mode that preserves the user's last selected floor across outdoor and indoor zoom cycles, rather than resetting to the building's default floor asDynamicFocusMode.DEFAULT_FLOORdoes.
dynamicFocus.enable(
DynamicFocusOptions(
mode = DynamicFocusMode.ACTIVE_FLOOR,
autoFocus = true,
setFloorOnFocus = true,
),
)
-
Added
layoutIdtoGetMapDataWithCredentialsOptionsandGetMapDataWithAccessTokenOptions, which accepts"draft"to load unpublished enterprise maps. -
Upgraded to Mappedin JS v6.21.1.
v6.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
- Added an Icons API via
MapView.icons(theIconsclass) for looking up and fetching Mappedin icons, mirroring@mappedin/iconsfrom Mappedin JS. It exposes lookup methods (getByName,getByType,getBySubtype,getByCategory,getByTags,getAll,getSmallIcon), SVG fetching (fetchSvg), prefetching and caching (prefetch,prefetchByType,prefetchBySubtype,prefetchByCategory,isCached,getCachedSvg,clearCache), and CDN region selection viainitialize. New strongly-typed modelsMappedinIcon,IconType,IconSubtype,IconCategory, andIconCdnRegionsupport the API, which works without a loaded map.
// Fetch all transit icons and retrieve the SVG for one of them
mapView.icons.getByCategory(IconCategory.TRANSPORTATION) { result ->
result.onSuccess { icons ->
val icon = icons.firstOrNull() ?: return@onSuccess
mapView.icons.fetchSvg(icon.name) { svgResult ->
svgResult.onSuccess { svg -> Log.d("Icons", svg) }
}
}
}
- Upgraded to Mappedin JS v6.20.0.
v6.3.0 - May 20, 2026
Features
- Added
Navigation.trackCoordinate()for path tethering and travelled-path tracking. IncludesTetheredOptions,TravelledOptions,TrackCoordinateOptions,TrackingMode,CoordinateOutsideThresholdMode, andOutsideThresholdPathStylemodels for complete control over coordinate tracking behavior along navigation paths.
val handle = mapView.navigation.trackCoordinate(
coordinate,
TrackCoordinateOptions.Tethered(
TetheredOptions(
tetherThresholdDistance = 5.0,
coordinateOutsideThresholdMode = CoordinateOutsideThresholdMode.TETHER_AND_DASH,
outsideThresholdPathStyle = OutsideThresholdPathStyle.DASHED_BOXES,
),
),
) { result -> }
-
Added
BlueDotEvents.DotPositionUpdateevent, which emits smoothedCoordinateupdates suitable for feeding intoNavigation.trackCoordinate(). -
Added
GetDirectionsOptions.includeNonPublicto allow routing through non-public spaces and connections. -
Added
interactiveproperty toAddImageOptionsand correspondinginteractiveandcursorproperties toImageStateandImageUpdateState.Image3DViewis now included inClickPayloadandHoverPayloadimagesandtargetproperties. -
Added
visibleproperty toBlueDotOptions,BlueDotOptions.AccuracyRing, andBlueDotOptions.Headingfor independent visibility control of Blue Dot components. Whenvisibleis set tofalseonBlueDotOptions, the dot is hidden but the accuracy ring and heading cone may still render based on their ownvisiblesettings.
mapView.blueDot.enable(BlueDotOptions(
visible = false,
accuracyRing = BlueDotOptions.AccuracyRing(visible = true),
heading = BlueDotOptions.Heading(visible = false),
))
- Added
AutoZoomThresholdstoDynamicFocusOptionsandDynamicFocusStatefor automatic zoom threshold calculation, replacing manualindoorZoomThresholdandoutdoorZoomThresholdconfiguration.
val options = DynamicFocusOptions(
autoFocus = true,
autoZoomThresholds = AutoZoomThresholds.Enabled(debug = true),
)
mapView.dynamicFocus.enable(options) { }
-
Added
FloorStackas a cameraFocusTargetviaFocusTarget.FloorStackTarget, with conveniencefocusOnandgetFocusOnTransformoverloads onCamera. -
Added
Events.CameraScreenOffsetsChangeevent, emitted when camera screen offsets change. -
Added pixel-based
Widthsupport viaWidth.Pixelsfor specifying path widths in pixels (e.g.,"20px").
Deprecated
- Deprecated
BlueDot.update(). UseforcePosition()to set an authoritative position that overrides all sensors, orreportPosition()to feed a confidence-weighted position into the fusion engine.
v6.2.0 - April 2, 2026
Features
- Added
forcePosition()andreportPosition()methods toBlueDotfor manual positioning.forcePosition()overrides all sensors for a specified duration, whilereportPosition()blends with other sensors using confidence weighting.
val target = ForcePositionTarget(
latitude = 43.46106,
longitude = -80.52220,
heading = 90.0
)
mapView.blueDot.forcePosition(target, durationMs = 30_000) { result ->
result.onSuccess { Log.d("Demo", "Position forced for 30s") }
}
-
Added sensor management methods to
BlueDot:enableSensor(),disableSensor(),checkSensorPermission(),requestSensorPermission(), andisSensorEnabled()for fine-grained control over individual sensors in the fusion engine. -
Added
AnchorSetandAnchorExpiredevents to notify when forced position anchors are created and expire. -
Added
EventsManageronMapData.eventsManagerfor loading and querying CMS events. Includesload(),getEvents(),getById(), andgetByLocationId()methods, withEventMetaData,EventVideo, andEventsManagerOptionsmodels.
mapView.mapData.eventsManager.load { loadResult ->
loadResult.onSuccess {
mapView.mapData.eventsManager.getEvents { eventsResult ->
eventsResult.onSuccess { events ->
for (event in events) {
Log.d("Events", "${event.name}: ${event.startDate} - ${event.endDate}")
}
}
}
}
}
- Added
positionproperty toShapeStateandShapeUpdateState, enabling getting and settingShapepositions.
// Get the position of a shape
mapView.getState(shape) { result ->
result.onSuccess { state ->
Log.d("Shape", "Position: ${state?.position?.latitude}, ${state?.position?.longitude}")
}
}
// Move a shape to a new position
val newPosition = Coordinate(latitude = 43.46, longitude = -80.52)
mapView.updateState(shape, ShapeUpdateState(position = newPosition))
-
Added
Models.all()method to load all CMS-defined 3DModels for a venue. -
Added
MultiFloorViewEffectStatefor configuring visual effects on inactive floors visible through open-to-below spaces, including darken, desaturate, and wash-out effects with depth controls. Configurable at init time viaMultiFloorViewOptionsor at runtime viaGlobalStateUpdate.multiFloorView.
// Configure visual effects at init time
val options = Show3DMapOptions(
multiFloorView = MultiFloorViewOptions(
spacesOpenToBelowEnabled = true,
spacesOpenToBelowVisualEffectEnabled = true,
spacesOpenToBelowVisualEffectDarkenAmount = 0.3,
spacesOpenToBelowVisualEffectDesaturateAmount = 0.7
)
)
// Update visual effects at runtime
mapView.updateGlobalState(GlobalStateUpdate(
multiFloorView = GlobalStateUpdate.MultiFloorViewEffectStateUpdate(
spacesOpenToBelowVisualEffectDarkenAmount = 0.5
)
))
-
Added
Events.GlobalStateChangeevent, emitted whenupdateGlobalState()is called. -
Added
floorGapMultiplierandfloorGapFallbackproperties toMultiFloorViewOptionsfor additional control over floor spacing in multi-floor view. -
Added
animatedproperty toAddMarkerOptionsto controlMarkervisibility transitions. -
Added
MaterialSide.AUTOoption that automatically chooses front or double-sided rendering based on opacity. -
Added
screenOffsets,pitch, andzoomLevelproperties toShow3DMapOptions.
6.2.0-beta.1 - February 13, 2026
-
Upgraded to Mappedin JS v6.14.0
-
Added -
Query.at(coordinate)method to find all geometry objects (Spaces,MapObjects,Areas,Floors) at a given coordinate, with typed results returned asQueryAtResult
val coord = Coordinate(latitude = 43.861, longitude = -78.947, floorId = "floor1")
mapData.query.at(coord) { result ->
result.onSuccess { atResults ->
atResults?.forEach { queryResult ->
when (queryResult) {
is QueryAtResult.SpaceResult -> Log.d("Query", "Space: ${queryResult.space.name}")
is QueryAtResult.MapObjectResult -> Log.d("Query", "MapObject: ${queryResult.mapObject.name}")
is QueryAtResult.AreaResult -> Log.d("Query", "Area: ${queryResult.area.name}")
is QueryAtResult.FloorResult -> Log.d("Query", "Floor: ${queryResult.floor.name}")
}
}
}
}
- Added -
DynamicFocusmethods for complete control over floor visibility and view state management: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
mapView.dynamicFocus.setIndoor()
// Set current floor for a floor stack
mapView.dynamicFocus.setCurrentFloorForStack(building.floorStack, floor2) { }
// Exclude a building from dynamic focus visibility changes
mapView.dynamicFocus.exclude(parkingGarage.floorStack) { }
// Clean up when done
mapView.dynamicFocus.destroy()
- Added -
MapData.isEnterpriseMode()method to programmatically determine whether a map uses CMS/Enterprise or Maker data. Runtime warnings are now logged when using data types that don't match the map's data source
mapData.isEnterpriseMode { result ->
result.onSuccess { isEnterprise ->
if (isEnterprise) {
mapData.getByType(MapDataType.ENTERPRISE_LOCATION) { locResult ->
// Handle enterprise locations
}
} else {
mapData.getByType(MapDataType.LOCATION_PROFILE) { locResult ->
// Handle maker locations
}
}
}
}
-
Added -
FloorState.Images.collisionsEnabledproperty to control whether floor images participate in collision detection -
Added - Footprint properties to
FloorStateandFloorUpdateState:basementMaskEnabled,ceilingThickness,ceilingVisible, andoutline -
Added -
ModelUpdateState.clippingPlaneZOffsetproperty to control model clipping plane. UseDouble.POSITIVE_INFINITYto disable clipping
// Disable clipping for a model
val noClipState = ModelUpdateState(clippingPlaneZOffset = Double.POSITIVE_INFINITY)
// Set explicit clipping plane offset
val clipState = ModelUpdateState(clippingPlaneZOffset = 5.0)
6.2.0-beta.0 - February 2, 2026
-
Upgraded to Mappedin JS v6.13.0
-
Added -
BlueDotsupport withBlueDotOptions,BlueDotPositionUpdateand associated events for displaying the user's position on the map -
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 -
MapView.hydrateMapDataFromURL(url, options)for hydrating map data directly from a URL -
Added -
MapView.getCacheUrl(...)andMapView.getAssetUrl(...)helper methods for building URLs to cached and asset files -
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 ->
payload?.let { language ->
Log.d("MapData", "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 -
Fixed - Android Studio code assists (autocomplete, quick documentation, and quick fixes) now work correctly with
EnterpriseLocationtypes. -
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
// Create a FeatureCollection containing the Feature of the Area
val shapeFeatureCollection =
JSONObject().apply {
put("type", "FeatureCollection")
put(
"features",
JSONArray().apply {
put(
JSONObject().apply {
put("type", areaGeoJSON.optString("type"))
areaGeoJSON.optJSONObject("properties")?.let {
put("properties", it)
}
areaGeoJSON.optJSONObject("geometry")?.let {
put("geometry", it)
}
},
)
},
)
}
// Draw the shape
mapView.shapes.add(
shapeFeatureCollection,
PaintStyle(color = color, opacity = opacity, altitude = altitude, height = height),
) {}
// ✅ After
// Get the GeoJSON Feature from the area
val feature = area.geoJSON ?: return
// Create a FeatureCollection containing the single Feature
val featureCollection = FeatureCollection(features = listOf(feature))
// Draw the shape using the strongly-typed API
mapView.shapes.add(
featureCollection,
PaintStyle(color = color, opacity = opacity, altitude = altitude, height = height),
) {}
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
mapView.on("click") { payload ->
val clickPayload = payload as? ClickPayload
}
// ❌ Before
mapView.on(Events.CLICK) { payload ->
val clickPayload = payload as? ClickPayload
}
// ✅ After
mapView.on(Events.Click) { clickPayload ->
}
6.1.0-alpha.1 - December 19, 2025
- Added - LabelAppearance.iconScale property to control the scale of the icon.
- Fixed -
MapData.getByIdnot returning the correct type.
⚠️ Breaking Changes
- Fixed - Removed duplicate inline implementation of Interpolation and Width.
// ❌ Before
AddPathOptions(
width = AddPathOptions.Width.Fixed(1.0),
)
// ✅ After
AddPathOptions(
width = Width.Value(1.0),
)
- Fixed -
MapView.getStateandMapView.updateStateshould use data classes and not plain objects.
// ❌ Before
mapView.updateState(space, mapOf("interactive" to true)) { }
// ✅ After
mapView.updateState(space, GeometryUpdateState(interactive = true)) { }
6.0.0-alpha.1 - December 4, 2025
- Upgraded to Mappedin JS v6.7.0.
6.0.0-alpha.0 - December 3, 2025
- Initial release of Mappedin SDK for Android v6.