Web SDK Release Notes

v6.0.1-alpha.33

July 24, 2024

Changes

• [Breaking] addPath now returns a promise, allowing the animation to be awaited.
• [Breaking] Style changes will now fire the outdoor-style-loaded event, instead of firing the outdoor-view-loaded event. The latter will only be fired on initial load.
• Improved camera controls and interactions with multi-finger touch. Multi-finger touch will no longer trigger a click event, and releasing a finger will no longer abruptly end camera movement.

Features

• The Maplibre map is now exposed via Outdoor.map for advanced usage.
• Added support for geometry textures when provided in the map data.
• Added a light option for the Mappedin watermark.
• The map geometry can be updated during runtime by passing a new style to Style.setFromStyleCollection.
• Added viewId property to getMapData to specify the editor Map View to fetch.

Fixes

• Fixed cases where a simplified path would cut corners too sharply.

v6.0.1-alpha.32

July 17, 2024

Features

• focusOn will now accept an Annotation as the target.

Fixes

• Fixed an issue causing hiddenLayersUnderGeometry to be ignored on some maps.
• Fixed an issue where multi-floor paths could draw a straight line from start to finish, ignoring connections.

v6.0.1-alpha.31

July 15, 2024

Features

• Added a "low" option for marker and label rank.

Fixes

• Fixed an issue where layersHiddenByGeometry would fail if a layer name was not present in the outdoor style.
• Fixed an issue where marker z-index wasn't 3D accurate. The marker nearest to the camera will now be on top.

v6.0.1-alpha.30

July 8, 2024

Fixes

• Duplicate marker and label IDs are now rejected.
• Fixed an issue preventing the outdoor-view-loaded event from firing.
• Fixed a crash which could occur when the map has no interior walls.

v6.0.1-alpha.29

July 4, 2024

Features

• getMapData now optionally accepts an accessToken string in place of key and secret.

v6.0.1-alpha.28

July 2, 2024

Fixes

• Resolves an issue where maps with multiple styles for spaces and obstructions would fail to load all geometry.

v6.0.1-alpha.27

July 2, 2024

Fixes

• Resolved an issue where iOS would darken the canvas after the user has * moved to another tab.
• Resolved an issue where applying a new outdoor style could add layers above the indoor map.
• Duplicate entity IDs in the data are now rejected.

v6.0.1-alpha.26

June 28, 2024

This update introduces a completely new SDK architecture enabling faster load times, less memory consumption, real time 2D colliders, and more. Please reach out if there are any unexpected changes after upgrading to v6.0.1-alpha.26.

Changes

• [Breaking] Increased the default iconSize of label icons from 10 pixels to 20 pixels.
• [Breaking] Decreased the default iconPadding of label icons from 4 pixels to 2 pixels.
• [Breaking] Camera.animate has been renamed to Camera.animateTo.
• [Breaking] maxZoomLevel and minZoomLevel setters have been replaced with setMaxZoomLevel and setMinZoomLevel methods.
• [Breaking] The priority property for labels and markers has been renamed rank in updateState.
• [Breaking] The elements in the DOM have shifted. It is not recommended to rely on or modify the Mappedin elements in the DOM.

Features

• Colliders such as labels and markers adjust position in real time during camera events.
• Initial camera bearing, pitch, and zoomLevel can be set in the options for show3dMap.

Copy
await show3dMap(document.getElementById('mappedin-map'), mapData, {
	bearing: 45,
	pitch: 45,
	zoomLevel: 19,
});

• Labels.all will automatically use the icon for spaces and points of interest if one has been set in the editor.
• The color of the top of the walls can now be set independently of the rest of the wall.

Copy
await show3dMap(document.getElementById('mappedin-map'), mapData, {
	wallTopColor: '#000000',
});

• The ‘click’ event returns a new property, pointerEvent, which can be used to differentiate between mouse clicks.

Copy
mapView.on('click', async event => {
	const [space] = event.spaces;
	if (!space) return;
	switch (event.pointerEvent.button) {
		case 0:
			const { coordinate } = event;
			const label = space.name || `Clicked: Lat: ${coordinate.latitude} Lon: ${coordinate.longitude}`;

			mapView.Labels.add(coordinate, label);
			break;
		case 2:
			mapView.Camera.focusOn(space);
			break;
	}
});

• Outdoor layers below indoor geometry can be hidden using the outdoorView.layersHiddenByGeometry option for show3dMap.

Fixes

• Fixed loading of geometry styles.
• Reduced memory consumption.
• Reduced bundle size.

v6.0.1-alpha.25

June 13, 2024

• Version bump only.

v6.0.1-alpha.24

June 12, 2024

Features

• Marker position can now be updated instantly using setPosition or over time using animateTo.

Changes

• outdoorViewToken and outdoorViewStyle have been deprecated in favor of outdoorView.token and outdoorView.style on TShow3DMapOptions. They will be removed in a future release.

Copy
outdoorView = {
  token: ''
  style: ''
}

• Multi-finger touch will no longer count as a click event.

Fixes

• Fixed a case where some generic styles were being exported.

v6.0.1-alpha.23

May 22, 2024

Features

• Customize the outdoor style using the outdoorViewStyle property of TShow3DMapOptions. The property expects a URL to a style specification conforming to the Maplibre Style Spec.

Changes

• The wall shading now darkens the color instead of setting it grey. Shading is now noticeable on all objects.

Before	After

• The watermark should no longer disappear at some zoom levels. As a side effect, the default sizing of the watermark has changed.

Before	After
Sizing was based on vertical height of the screen.	Sizing is now 150px wide by default.

v6.0.1-alpha.22

May 15, 2024

Changes

• [Breaking] The type of TCameraAnimationOptions.easing has been changed to EasingCurve. The accepted values of this property remain the same.
• Markers.removeAll() now has a return type of Marker[].

v6.0.1-alpha.21

May 13, 2024

Changes

• [Breaking] The default value of label iconFit has been changed to "cover". Previously, the default value was "fill".

Fixes

• Fixed an issue causing the onMVFParsed callback of getMapData to never fire.
• Fixed an issue with watermark visibility.

v6.0.1-alpha.20

May 2, 2024

Features

• Added new options to customize the location of the watermark. The watermark padding option now accepts an object with top, right, bottom, left to fine-tune it.
• (Breaking) Added support for JPEG and PNG images in Floating Label icons. In addition to this, icons are now clipped in a circle to prevent overflow. New appearance options have been added to customize the icons.

Copy
mapView.Labels.add(space, space.name, {
  appearance: {
    marker: {
      iconSize: 20,
      iconFit: 'fill',
      iconPadding: 4,
      icon: 'http://www.example.com/dog.jpeg',
    },
  },
});

The new iconFit property determines how the icon should be scaled within the circle. 'fill' is now default.

Fill (default)	Contain	Cover

The padding property sets the amount of space between the icon and the border. The icon may shrink based on this value.

padding: 0	padding: 10

v6.0.1-alpha.19

April 30, 2024

Features

• It is now possible to specify the radius of the raycast for directions smoothing.

Copy
mapView.getDirections(departure, destination, {
  smoothing: { radius: 3 } // 3 metre radius
});

By default, radius is set to 1.8 metres.

Fixes

• Fixed a race condition when doing mapView.Navigation.clear() directly after calling mapView.Navigation.draw(directions).

v6.0.1-alpha.18

April 25, 2024

Fixes

• Fixed an issue where directions may be missing distances between instructions.

v6.0.1-alpha.17

April 23, 2024

Fixes

• Resolved an issue with installing the package from NPM.

v6.0.1-alpha.16

April 23, 2024

• Version bump only.

v6.0.1-alpha.15

April 19, 2024

Fixes

• Connection weights were not being properly accounted for, causing all connection types to be prioritized equally. This has been corrected.
• Fixed SafeAreaInsets not working when focusing on a single point.

v6.0.1-alpha.14

April 12, 2024

• Version bump only

v6.0.1-alpha.13

April 10, 2024

Features

• The MapView contains a new controller called Exporter. With Exporter, the rendered map can be converted to GLTF.

Copy
const gltf = await mapView.Exporter.getCurrentSceneGLTF();

v6.0.1-alpha.12

April 2, 2024

Fixes

• The navigation path should no longer traverse through walls.
• Fixed an issue with the watermark.

v6.0.1-alpha.11

March 26, 2024

Fixes

• Resolved an issue where some maps didn't render exterior walls. In cases where the map is missing styles for exterior walls, they will default to the indoor wall style.

v6.0.1-alpha.10

March 25, 2024

• Version bump only.

v6.0.1-alpha.9

March 19, 2024

• Version bump only.

v6.0.1-alpha.8

March 18, 2024

Fixes

• Halved memory usage during map initial load.
• The outline effect no longer retains line thickness while zooming out with inertia.
• Labels render correctly now on Intel integrated GPUs.

v6.0.1-alpha.7

March 12, 2024

Changes

• The default color of the exit connection navigation button is now blue instead of purple.

Fixes

• The focusOn animation no longer resets the min and max zoom levels.
• If directions have less than 2 coordinates, navigation will now warn and prevent drawing the path.
• The Coordinate class is now data layer agnostic, making it easier to test and create directly.

v6.0.1-alpha.5

February 28, 2024

Features

• All map data objects now accurately include hyperlink metadata under the property links.

Fixes

• The default type for map data objects is now object, instead of unknown. This will no longer warn of unknown object kind.

v6.0.1-alpha.4

February 27, 2024

Fixed

• The polygon outline opacity is now interpolated as the camera zooms out. This improves the outline appearance at the furthest zoom level.

Before/After:

v6.0.1-alpha.3

February 27, 2024

We're testing a new version of the Mappedin Web SDK and we'd love to hear your feedback! Mappedin Web SDK v6 alpha adds first class support for maps built with app.mappedin.com.

Please note that breaking changes will occur. We encourage you to contact us with any issues or feedback, and regularly check this page for detailed release notes and API changes.