Skip to main content
Version: 6.0

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 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(
Show3DMapOptions(
shadows = Shadows.Auto,
),
) { result ->
result.onSuccess { Log.d("MapView", "Map shown") }
}
  • ShadowsOptions.quality accepts ShadowsOptions.Quality.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 = ShadowsOptions.Quality.HIGH) to force the high tier.

  • ShadowsOptions.frustumMode is ShadowsOptions.FrustumMode.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 FindNearestOptions.Mode.TRAVEL_DISTANCE, 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 = 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 costAccumulation to DirectionZone, which controls when a zone's cost is charged. CostAccumulation.PER_NODE is the default, so existing routes are unchanged: every navigation node the route steps onto inside the zone adds the cost. CostAccumulation.PER_ZONE_ENTRY charges the cost once each time the route enters the zone. Moving inside the zone adds nothing, and entering again charges again. PER_ZONE_ENTRY 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 = listOf(
DirectionZone(
cost = 1000.0,
costAccumulation = CostAccumulation.PER_ZONE_ENTRY,
geometry = departmentPolygon,
),
),
),
) { result ->
result.onSuccess { Log.d("Directions", "Directions calculated") }
}
  • Added textWrap to LabelAppearance and LabelState.Appearance, which controls how a Label breaks onto multiple lines. LabelTextWrap.MAX_WIDTH 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 = LabelTextWrap.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 = Text3DAlign.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,
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 ->
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. 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(
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_OPTIMAL 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 GREEDY_LOS 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 MarkerPlacement.HIDDEN was tried in list order for Marker placement and LabelTextPlacement.HIDDEN was tried in list order for Label textPlacement. HIDDEN is now always tried last, wherever it is listed. Also fixed an issue where creating a Marker with its own placement replaced the default listOf(MarkerPlacement.CENTER, MarkerPlacement.HIDDEN) 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.

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 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 ->
result.onSuccess { elements ->
Log.d("MapView", "Created ${elements.labels.size} labels")
}
}
  • Added path rendering options on AddPathOptions, used by Paths.add and by NavigationOptions.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),
),
)
  • geometry is AddPathOptions.Geometry.TUBE (the default round path) or AddPathOptions.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.

  • 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 WIDTH_SCALING (the default), LENGTH_SCALING, 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 to 0.5. billboarding is Off, On, or a Threshold in degrees from 0 to 90 (default 80).

  • Added method and includeDoorBufferNodes to GetDirectionsOptions.Smoothing.Configured. method is GREEDY_LOS (the default), RDP, or DP_OPTIMAL. includeDoorBufferNodes keeps door-adjacent nodes during simplification. It defaults to true for RDP and false for DP_OPTIMAL, and GREEDY_LOS 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(
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 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(
Show3DMapOptions(
multiFloorView = MultiFloorViewOptions(
enabled = true,
showAllFloorsIncludedInNavigation = true,
),
),
) { result ->
result.onSuccess {
Log.d("MapView", "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,
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(
"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 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.

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 every Label currently on the map.
mapView.labels.getAll { result ->
result.onSuccess { labels ->
labels.forEach { label ->
Log.d("MappedinDemo", "Label: ${label.text}")
}
}
}
  • Added scalingStrategy to BlueDotOptions.AccuracyRing and BlueDotState.AccuracyRingState, which controls how the accuracy ring's on-screen size is derived from the reported accuracy. The default is AccuracyRingScalePreset.TRUE_SCALE, which draws the ring at real-world metres. AccuracyRingScalePreset.CLAMP_VIEWPORT keeps 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 a ClickPayload, matching Events.Click. A long-press does not also emit Events.Click.
mapView.on(Events.LongPress) { payload ->
payload?.space?.let { space ->
Log.d("MapView", "Long-pressed ${space.name}")
}
}
  • Added checkForUpdates to MapData, 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.
mapData.checkForUpdates { result ->
result.onSuccess { update ->
if (update?.hasChanges == true) {
// re-load with getMapData
}
}
}
  • Added updatedAt to MapData, which returns the timestamp reported by the API when the map data was loaded.

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 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.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 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.CameraChange twice 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 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(SdkLogLevel.DEBUG)

// Quiet the SDK entirely
mapView.setLogLevel(SdkLogLevel.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,
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.ALWAYS_VISIBLE can still overlap the Blue Dot.
mapView.blueDot.enable(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(
DynamicFocusOptions(
cameraLiftAnimationOptions = CameraAnimationOptions(
duration = 500,
easing = EasingFunction.EASE_IN_OUT,
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.

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 through MapView.mapData.query) to include MapObject, LocationProfile, Connection, Area, and Facade, in addition to the previously supported PointOfInterest, Door, Annotation, Node, and Space. Each result is returned as the corresponding FindNearestResult.Feature subclass.
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 geometryText and floorText visibility sub-axes to FloorState.Text3D, returned by MapView.getState for a Floor. geometryText reports the visibility of consumer-added 3D text (current floor only), while floorText reports the visibility of baked floor text, which can reveal through open-to-below voids. The existing visible flag 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 via MapView.navigation, which returns the departure, destination, and connection Markers drawn for the current route as strongly-typed NavigationMarker objects (each exposing a marker and a NavigationMarkerType).
mapView.navigation.markers { result ->
result.onSuccess { markers ->
markers.forEach { navMarker ->
when (navMarker.type) {
NavigationMarkerType.DEPARTURE -> { /* ... */ }
NavigationMarkerType.DESTINATION -> { /* ... */ }
NavigationMarkerType.CONNECTION -> { /* ... */ }
}
}
}
}
  • Added markers to NavigationState, which is delivered to native subscribers of the navigation-state-change event via Events.NavigationStateChange.

  • Added interactive to PathState and PathUpdateState (default false), which makes a Path clickable at runtime so it can dispatch click and hover events.

mapView.updateState(path, PathUpdateState(interactive = true))
  • Added isConnectionSegment and distance to PathSegment.

  • Upgraded to Mappedin JS v6.22.0.

Fixes​

  • Fixed an issue where the onMVFParsed callback on GetMapDataWithCredentialsOptions and GetMapDataWithAccessTokenOptions was never invoked. When provided, it now fires once after the map data is fetched and parsed, receiving a strongly-typed MVF model.

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 interactivity to GeometryState, GeometryUpdateState, ShapeState, and ShapeUpdateState, which controls how geometry and shapes participate in pointer-event raycasting. The new Interactive type supports Interactive.Boolean(true) (fires hover and click handlers), Interactive.Boolean(false) (captures the raycast so nothing behind it receives events, but fires no handler), and Interactive.PassThrough (skips the geometry entirely so events fall through to whatever is rendered behind it). The True and False convenience values are also provided. The existing boolean interactive property is now deprecated in favour of interactivity.
mapView.updateState(
space,
GeometryUpdateState(interactivity = GeometryState.Interactive.PassThrough),
) { }
  • Added displayArrowsOnPath to PathSectionHighlightOptions, which independently controls whether direction arrows are drawn inside a highlighted section of a Path, regardless of the path-level displayArrowsOnPath setting.

  • 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 as DynamicFocusMode.DEFAULT_FLOOR does.

dynamicFocus.enable(
DynamicFocusOptions(
mode = DynamicFocusMode.ACTIVE_FLOOR,
autoFocus = true,
setFloorOnFocus = true,
),
)
  • Added layoutId to GetMapDataWithCredentialsOptions and GetMapDataWithAccessTokenOptions, 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 (the Icons class) for looking up and fetching Mappedin icons, mirroring @mappedin/icons from 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 via initialize. New strongly-typed models MappedinIcon, IconType, IconSubtype, IconCategory, and IconCdnRegion support 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. Includes TetheredOptions, TravelledOptions, TrackCoordinateOptions, TrackingMode, CoordinateOutsideThresholdMode, and OutsideThresholdPathStyle models 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.DotPositionUpdate event, which emits smoothed Coordinate updates suitable for feeding into Navigation.trackCoordinate().

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

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

  • Added visible property to BlueDotOptions, BlueDotOptions.AccuracyRing, and BlueDotOptions.Heading for independent visibility control of Blue Dot components. When visible is set to false on BlueDotOptions, the dot is hidden but the accuracy ring and heading cone may still render based on their own visible settings.

mapView.blueDot.enable(BlueDotOptions(
visible = false,
accuracyRing = BlueDotOptions.AccuracyRing(visible = true),
heading = BlueDotOptions.Heading(visible = false),
))
  • Added AutoZoomThresholds to DynamicFocusOptions and DynamicFocusState for automatic zoom threshold calculation, replacing manual indoorZoomThreshold and outdoorZoomThreshold configuration.
val options = DynamicFocusOptions(
autoFocus = true,
autoZoomThresholds = AutoZoomThresholds.Enabled(debug = true),
)
mapView.dynamicFocus.enable(options) { }
  • Added FloorStack as a camera FocusTarget via FocusTarget.FloorStackTarget, with convenience focusOn and getFocusOnTransform overloads on Camera.

  • Added Events.CameraScreenOffsetsChange event, emitted when camera screen offsets change.

  • Added pixel-based Width support via Width.Pixels for specifying path widths in pixels (e.g., "20px").

Deprecated​

  • Deprecated BlueDot.update(). Use forcePosition() to set an authoritative position that overrides all sensors, or reportPosition() to feed a confidence-weighted position into the fusion engine.

v6.2.0 - April 2, 2026​

Features​

  • Added forcePosition() and reportPosition() methods to BlueDot for manual positioning. forcePosition() overrides all sensors for a specified duration, while reportPosition() 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(), and isSensorEnabled() for fine-grained control over individual sensors in the fusion engine.

  • Added AnchorSet and AnchorExpired events to notify when forced position anchors are created and expire.

  • Added EventsManager on MapData.eventsManager for loading and querying CMS events. Includes load(), getEvents(), getById(), and getByLocationId() methods, with EventMetaData, EventVideo, and EventsManagerOptions models.

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 position property to ShapeState and ShapeUpdateState, enabling getting and setting Shape positions.
// 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 3D Models for a venue.

  • Added MultiFloorViewEffectState for 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 via MultiFloorViewOptions or at runtime via GlobalStateUpdate.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.GlobalStateChange event, emitted when updateGlobalState() is called.

  • Added floorGapMultiplier and floorGapFallback properties to MultiFloorViewOptions for additional control over floor spacing in multi-floor view.

  • Added animated property to AddMarkerOptions to control Marker visibility transitions.

  • Added MaterialSide.AUTO option that automatically chooses front or double-sided rendering based on opacity.

  • Added screenOffsets, pitch, and zoomLevel properties to Show3DMapOptions.

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 as QueryAtResult

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 - DynamicFocus methods for complete control over floor visibility and view state management:
    • 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
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.collisionsEnabled property to control whether floor images participate in collision detection

  • Added - Footprint properties to FloorState and FloorUpdateState: basementMaskEnabled, ceilingThickness, ceilingVisible, and outline

  • Added - ModelUpdateState.clippingPlaneZOffset property to control model clipping plane. Use Double.POSITIVE_INFINITY to 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 - BlueDot support with BlueDotOptions, BlueDotPositionUpdate and associated events for displaying the user's position on the map

  • 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 - MapView.hydrateMapDataFromURL(url, options) for hydrating map data directly from a URL

  • Added - MapView.getCacheUrl(...) and MapView.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.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 ->
payload?.let { language ->
Log.d("MapData", "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

  • Fixed - Android Studio code assists (autocomplete, quick documentation, and quick fixes) now work correctly with EnterpriseLocation types.

  • 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
// 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.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
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.getById not 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.getState and MapView.updateState should 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.