MapViewExtensions - @magiclane/maps-sdk API Reference

Home > @magiclane/maps-sdk > MapViewExtensions

MapViewExtensions class

Map View Extensions

A compact set of view-scoped helpers that extend the native map view with lightweight, platform-proxied utilities for view tuning and small integrations. Exposes convenience features for performance and interaction tuning as well as integrations with sensing/positioning subsystems.

Common tasks are enforcing zoom limits and toggling performance optimizations for lower-end devices, switching reduced-rate navigation updates, enabling or disabling enhanced position-tracking visualizations (optionally driven by a specific data source and rendering settings), and querying the current tracked positions or tracking state.

Maps & 3D Scene

Signature:

export declare class MapViewExtensions

Constructors

Constructor	Modifiers	Description
(constructor)()		Creates a new instance of MapViewExtensions

Properties

Property	Modifiers	Type	Description
isTrackedPositions	`readonly`	boolean	Check if tracked position is started in the map view
lowEndCPUOptimizations		boolean	Get low end CPU optimizations flag.
mapId	`readonly`	number	Gets the map ID
maximumAllowedZoomLevel		number	Get the maximum allowed zoom level.
minimumAllowedZoomLevel		number	Get the minimum allowed zoom level.
navigationRouteLowRateUpdate		boolean	Gets navigation route low rate update flag
pointerId	`readonly`	number \| bigint	Gets the pointer ID
trackedPositions	`readonly`	Coordinates[]	Get the current tracked positions as a coordinates list

Methods

Method	Modifiers	Description
getHighlightGroupItemIndex(idx, highlightId)		Get group highlighted item index for the given highlighted item index (in original list)
startTrackPositions({ updatePositionMs, settings, dataSource, }, input)		Start the sense data source improved position tracking on map by rendering a marker polyline between relevant map links points
stopTrackPositions()		Stops the sense data source improved position tracking on map