Interface for interacting with the location view. More...

Inherits Finalizable.

Public Member Functions
void	setSublocationId (int id)
	Method is used to switch the location view between sublocations (e.g., floors).

int	getSublocationId ()
	Returns current sublocation ID if set, otherwise null.

void	setOperatingMode (OperatingMode mode)
	Sets the operating mode of the location view OperatingMode. Default: indoor_only.

OperatingMode	getOperatingMode ()
	Returns the current operating mode OperatingMode.

String	getAttribution ()
	Attribution text for the outdoor tiles. Comes from `tileProvider.attribution` when set. A null vector source uses the OSM default.

Camera	getEnclosingCamera (BoundingBox boundingBox)
	Camera that fits boundingBox into the current focus rect. Uses `focusRect` when set, otherwise the full viewport. Keeps the current azimuth and tilt (tilt fit is approximate).

Camera	getEnclosingCameraWithFocus (BoundingBox boundingBox, ScreenRect? focusRect, double? azimuth, double? tilt)
	Camera that fits boundingBox, with optional overrides. Null `focusRect` / `azimuth` / `tilt` keep the current window values (`focusRect` property, current camera). Azimuth and tilt are degrees, same units as Camera.

GlobalPoint	screenPositionToGlobal (math.Point< double > point)
	Converts screen coordinates (pixels) to WGS84 coordinates.

CircleMapObject	addCircleMapObject ()
	Creates and adds a circle map object to the location view.

bool	removeCircleMapObject (CircleMapObject circleMapObject)
	Removes a circle map object from the location view.

IconMapObject	addIconMapObject ()
	Creates and adds an icon map object to the location view.

bool	removeIconMapObject (IconMapObject iconMapObject)
	Removes an icon map object from the location view.

ClusterMapObjectController	addClusterMapObjectController ()
	Creates an icon map object controller for the location view.

bool	removeClusterMapObjectController (ClusterMapObjectController controller)
	Removes an icon map object controller from the location view.

PolygonMapObject	addPolygonMapObject ()
	Creates and adds a polygon map object to the location view.

bool	removePolygonMapObject (PolygonMapObject polygonMapObject)
	Removes a polygon map object from the location view.

PolylineMapObject	addPolylineMapObject ()
	Creates and adds a polyline map object to the location view.

GeoJsonImport	addGeoJson (String geoJson, int? sublocationId)
	Adds polygons and lines from one GeoJSON document on a floor. Accepts a FeatureCollection, a Feature, or one geometry, the same inputs as a GeoJSON source. Polygon holes become `LocationPolygon.innerRings`. Points are skipped. Returns null when the document is not JSON. The host styles the returned objects.

PointBatch	addPointBatch ()
	Creates one arrow cloud. Replace its points each frame.

bool	removePointBatch (PointBatch pointBatch)
	Removes an arrow cloud.

bool	removePolylineMapObject (PolylineMapObject polylineMapObject)
	Removes a polyline map object from the location view.

DottedPolylineMapObject	addDottedPolylineMapObject ()
	Creates and adds a polyline points map object to the location view.

bool	removeDottedPolylineMapObject (DottedPolylineMapObject dottedPolylineMapObject)
	Removes a polyline points map object from the location view.

ModelMapObject	addModelMapObject ()
	Creates and adds a 3D model map object (Wavefront OBJ + texture via ModelProvider).

bool	removeModelMapObject (ModelMapObject modelMapObject)
	Removes a model map object from the location view.

void	removeAllMapObjects ()
	Removes all map objects from the location view.

void	pickMapObjectAt (math.Point< double > point)
	Selects a visible, interactive map object at the specified screen position.

void	pickMapFeatureAt (math.Point< double > point)
	Selects visible map features (e.g., venues) at the specified screen position.

void	addPickListener (PickListener listener)
	Adds a PickListener to receive picking result events.

void	removePickListener (PickListener listener)
	Removes a previously added PickListener.

void	addInputListener (InputListener listener)
	Adds an InputListener to receive input events.

void	removeInputListener (InputListener listener)
	Removes a previously added InputListener.

void	addCameraListener (CameraListener listener)
	Adds a CameraListener to receive camera movement events.

void	removeCameraListener (CameraListener listener)
	Removes a previously added CameraListener.

void	addSublocationChangeListener (SublocationChangeListener listener)
	Adds listener for sublocation change events.

void	removeSublocationChangeListener (SublocationChangeListener listener)
	Removes previously added sublocation change listener.

void	addBuildingListener (BuildingListener listener)
	Adds listener for outdoor scenario: when camera focuses on a building or leaves it.

void	removeBuildingListener (BuildingListener listener)
	Removes previously added indoor building listener.

void	flyTo (Camera camera, int duration, CameraCallback callback)
	Moves the map camera to a new position with a smooth pan-and-zoom (fly) animation.

void	moveTo (Camera camera, int duration, AnimationType animationType, CameraCallback callback)
	Moves the map camera to a new position with an easing animation.

bool	selectMapFeature (String featureId)
	Selects a map feature by its feature ID.

bool	deselectMapFeature (String featureId)
	Deselects a map feature by its feature ID.

void	deselectAllMapFeatures ()
	Deselects all currently selected map features.

void	applyLayerFilter (String layer, List< MapFilterCondition > conditions)
	Applies a typed filter to a specific map layer.

bool	isValid ()

Static Public Member Functions
static void	setDebugFlag (DebugFlag flag, bool on)
	Sets the state of a debug flag.

static bool	getDebugFlag (DebugFlag flag)
	Gets the state of a debug flag.

Public Attributes
MapTheme get	mapTheme
	Outdoor vector basemap color theme MapTheme. Indoor rasters, venues, and user map objects are unchanged. Default: light.

TileProvider get	tileProvider
	Outdoor tile source TileProvider. `kind` `vector` draws MVT (`schema` must match the tiles). `kind` `raster` draws PNG, JPEG, or WebP imagery and hides outdoor vector geometry and labels. `schema` is ignored for raster. Indoor floors stay on top. Null (default) uses OSM Shortbread at vector.openstreetmap.org. When `mbtiles` is set, tiles are read only from that file.

AttributionAlignment get	attributionAlignment
	Screen placement of the OSM attribution overlay AttributionAlignment. Default: right + bottom. Visible only in outdoor / outdoor_indoor modes.

double get	zoomFactor
	Specifies the zoom level of the location view, in pixels per meter. Default: approximately 100 meters across the screen width.

double get	minZoomFactor
	Minimum zoom level for the location view (pixels per meter).

double get	maxZoomFactor
	Maximum zoom level for the location view (pixels per meter).

bool get	stickToBorder
	Specifies whether sublocation content sticks to screen borders.

Camera get	camera
	Current camera position (look-at in WGS84). Camera.

ScreenRect get	focusRect
	Area of the viewport used when fitting a bounding box. Null (default) is the full view. Set this for a floor selector, follow-me button, or POI card so `getEnclosingCamera` keeps geometry in the remaining rectangle. Coordinates are screen pixels ScreenRect.

VisibleRegion get	focusRegion
	Four corners of `focusRect` in WGS84, or `visibleRegion` when `focusRect` is null VisibleRegion.

VisibleRegion get	visibleRegion
	Four corners of the current viewport in WGS84 VisibleRegion. Corners are ray-cast onto the ground plane, same as `screenPositionToGlobal`. With tilt the shape is a trapezoid.

bool get	rotateGestureEnabled
	Specifies whether rotation gestures (e.g., two-finger rotation) are enabled.

bool get	tiltGesturesEnabled
	Specifies whether tilt gestures (e.g., two-finger parallel pan) are enabled.

bool get	scrollGesturesEnabled
	Specifies whether scroll gestures (e.g., pan gesture) are enabled.

bool get	zoomGesturesEnabled
	Specifies whether zoom gestures (e.g., two-finger pinch) are enabled.

double get	pickRadius
	Extra slop around the hit target, in density-independent pixels. Applied as a screen-pixel radius for points/lines and as a margin around a label's real AABB. Default: 5 dp.

List< String > get	selectedMapFeatures
	List of currently selected map feature IDs.

Detailed Description

Interface for interacting with the location view.

Referenced from LocationView.

Definition at line 56 of file location_window.dart.

Member Function Documentation

◆ addBuildingListener()

void LocationWindow.addBuildingListener ( BuildingListener listener )

Adds listener for outdoor scenario: when camera focuses on a building or leaves it.

Parameters

listener Indoor building listener BuildingListener.

Dart code snippet:

_locationWindow!.addBuildingListener(_buildingListener!);

print('Added building listener');

◆ addCameraListener()

void LocationWindow.addCameraListener ( CameraListener listener )

Adds a CameraListener to receive camera movement events.

Parameters

listener The CameraListener instance CameraListener.

Note: Remove the listener when no longer needed.

Dart code snippet:

    // Add camera listener
    _cameraListener = CameraListenerImpl();
    _locationWindow!.addCameraListener(_cameraListener!);
    print("Added camera listener");

◆ addCircleMapObject()

CircleMapObject LocationWindow.addCircleMapObject ( )

Creates and adds a circle map object to the location view.

Returns: A CircleMapObject instance CircleMapObject if successful, null otherwise.

Dart code snippet:

    // Add circle map object
    _circleMapObject = _locationWindow!.addCircleMapObject();
    print("Added circle map object");

◆ addClusterMapObjectController()

ClusterMapObjectController LocationWindow.addClusterMapObjectController ( )

Creates an icon map object controller for the location view.

Returns: Cluster controller instance ClusterMapObjectController.

Dart code snippet:

_clusterMapObjectController = _locationWindow!.addClusterMapObjectController();

print("Added cluster map object controller");

◆ addDottedPolylineMapObject()

DottedPolylineMapObject LocationWindow.addDottedPolylineMapObject ( )

Creates and adds a polyline points map object to the location view.

Returns: A DottedPolylineMapObject instance DottedPolylineMapObject if successful, null otherwise.

Dart code snippet:

    // Add dotted polyline map object
    _dottedPolylineMapObject = _locationWindow!.addDottedPolylineMapObject();
    print("Added dotted polyline map object");

◆ addGeoJson()

GeoJsonImport LocationWindow.addGeoJson	(	String	geoJson,
		int?	sublocationId )

Adds polygons and lines from one GeoJSON document on a floor. Accepts a FeatureCollection, a Feature, or one geometry, the same inputs as a GeoJSON source. Polygon holes become LocationPolygon.innerRings. Points are skipped. Returns null when the document is not JSON. The host styles the returned objects.

Parameters

geoJson	GeoJSON text.
sublocationId	Floor for every object, or null for the outdoor map.

Dart code snippet:

    String geoJson = '{"type":"FeatureCollection","features":[{"type":"Feature","geometry":{"type":"Polygon","coordinates":[[[37.617,55.751],[37.619,55.751],[37.619,55.752],[37.617,55.751]],[[37.6174,55.7512],[37.6176,55.7512],[37.6176,55.7514],[37.6174,55.7512]]]}},{"type":"Feature","geometry":{"type":"LineString","coordinates":[[37.617,55.751],[37.620,55.753]]}}]}';
    GeoJsonImport imported = locationWindow.addGeoJson(geoJson, 7);
    print("GeoJSON polygons ${imported.polygons.length}, lines ${imported.polylines.length}");

◆ addIconMapObject()

IconMapObject LocationWindow.addIconMapObject ( )

Creates and adds an icon map object to the location view.

Returns: An IconMapObject instance IconMapObject if successful, null otherwise.

Dart code snippet:

    // Add icon map object
    _iconMapObject = _locationWindow!.addIconMapObject();
    print("Added icon map object");

◆ addInputListener()

void LocationWindow.addInputListener ( InputListener listener )

Adds an InputListener to receive input events.

Parameters

listener The InputListener instance InputListener.

Note: Remove the listener when no longer needed.

Dart code snippet:

    // Add input listener
    _inputListener = InputListenerImpl();
    _locationWindow!.addInputListener(_inputListener!);
    print("Added input listener");

◆ addModelMapObject()

ModelMapObject LocationWindow.addModelMapObject ( )

Creates and adds a 3D model map object (Wavefront OBJ + texture via ModelProvider).

Returns: A ModelMapObject instance ModelMapObject if successful, null otherwise.

Dart code snippet:

_modelMapObject = _locationWindow!.addModelMapObject();

print("Added model map object: ${_modelMapObject != null}");

◆ addPickListener()

void LocationWindow.addPickListener ( PickListener listener )

Adds a PickListener to receive picking result events.

Parameters

listener The PickListener instance PickListener.

Note: Remove the listener when no longer needed.

Dart code snippet:

    // Add pick listener
    _pickListener = PickListenerImpl();
    _locationWindow!.addPickListener(_pickListener!);
    print("Added pick listener");

◆ addPointBatch()

PointBatch LocationWindow.addPointBatch ( )

Creates one arrow cloud. Replace its points each frame.

Returns: A PointBatch PointBatch, or null on failure.

Dart code snippet:

    PointBatch batch = locationWindow.addPointBatch();
    batch.setPoints([
      PointSprite(GlobalPoint(55.751, 37.617), 0, Color(0xCCFF8000), 5),
      PointSprite(GlobalPoint(55.752, 37.618), 90, Color(0xCC0080FF), 5),
    ], 7);
    int? hit = batch.hitTest(math.Point<double>(12, 8), 8);
    print("PointBatch hit $hit");

◆ addPolygonMapObject()

PolygonMapObject LocationWindow.addPolygonMapObject ( )

Creates and adds a polygon map object to the location view.

Returns: A PolygonMapObject instance PolygonMapObject if successful, null otherwise.

Dart code snippet:

    // Add polygon map object
    _polygonMapObject = _locationWindow!.addPolygonMapObject();
    print("Added polygon map object");

◆ addPolylineMapObject()

PolylineMapObject LocationWindow.addPolylineMapObject ( )

Creates and adds a polyline map object to the location view.

Returns: A PolylineMapObject instance PolylineMapObject if successful, null otherwise.

Dart code snippet:

    // Add polyline map object
    _polylineMapObject = _locationWindow!.addPolylineMapObject();
    print("Added polyline map object");

◆ addSublocationChangeListener()

void LocationWindow.addSublocationChangeListener ( SublocationChangeListener listener )

Adds listener for sublocation change events.

Parameters

listener Sublocation change listener SublocationChangeListener.

Dart code snippet:

_locationWindow!.addSublocationChangeListener(listener);

print("Added sublocation change listener");

◆ applyLayerFilter()

void LocationWindow.applyLayerFilter	(	String	layer,
		List< MapFilterCondition >	conditions )

Applies a typed filter to a specific map layer.

Parameters

layer	The map layer to apply the filter to.
conditions	List of conditions (property + allowed values). Empty list resets the filter (show all).

Dart code snippet:

    // Apply filter to venues layer
    final conditions = [MapFilterCondition(property: "category", values: ["Toilet", "Cafe"])];
    _locationWindow!.applyLayerFilter("venues", conditions);
    print("Applied layer filter: show venues with category Toilet or Cafe");

◆ deselectAllMapFeatures()

void LocationWindow.deselectAllMapFeatures ( )

Deselects all currently selected map features.

Dart code snippet:

    // Deselect all map features
    _locationWindow!.deselectAllMapFeatures();
    print("Deselected all map features");

◆ deselectMapFeature()

bool LocationWindow.deselectMapFeature ( String featureId )

Deselects a map feature by its feature ID.

Parameters

featureId The feature ID from the mapFeaturePickResult PickListener.

Returns: true if the operation is successful, false otherwise.

Dart code snippet:

    // Deselect specific map feature
    bool deselected = _locationWindow!.deselectMapFeature(featureId);
    print("Deselected map feature $featureId: $deselected");

◆ flyTo()

void LocationWindow.flyTo	(	Camera	camera,
		int	duration,
		CameraCallback	callback )

Moves the map camera to a new position with a smooth pan-and-zoom (fly) animation.

Parameters

camera	The new camera position Camera.
duration	Animation duration in milliseconds (-1 derives it from the distance).
callback	Callback to execute when the animation completes CameraCallback.

Dart code snippet:

    // Fly to position with smooth animation
    GlobalPoint targetPoint = GlobalPoint(150.0, 250.0);
    Camera targetCamera = Camera(targetPoint, 75.0, 45.0, 30.0);
    CameraCallback callback = CameraCallback(
      onMoveFinished: (completed) {
        if (completed) {
          print("Fly to animation completed successfully");
        } else {
          print("Fly to animation was cancelled");
        }
      },
    );
    _locationWindow!.flyTo(targetCamera, 2000, callback);
    print("Started fly to animation to point (${targetPoint.latitude}, ${targetPoint.longitude})");

◆ getAttribution()

String LocationWindow.getAttribution ( )

Attribution text for the outdoor tiles. Comes from tileProvider.attribution when set. A null vector source uses the OSM default.

Dart code snippet:

final attribution = _locationWindow!.getAttribution();

print("Attribution: $attribution");

◆ getDebugFlag()

static bool LocationWindow.getDebugFlag ( DebugFlag flag )

static

Gets the state of a debug flag.

Parameters

flag	The debug flag to query DebugFlag.

Returns: true if the debug flag is enabled, false otherwise.

Dart code snippet:

bool infosOn = LocationWindow.getDebugFlag(DebugFlag.INFOS);

print("Debug flag INFOS enabled: $infosOn");

◆ getEnclosingCamera()

Camera LocationWindow.getEnclosingCamera ( BoundingBox boundingBox )

Camera that fits boundingBox into the current focus rect. Uses focusRect when set, otherwise the full viewport. Keeps the current azimuth and tilt (tilt fit is approximate).

Parameters

boundingBox WGS84 bounding box to enclose.

Dart code snippet:

    BoundingBox boundingBox = BoundingBox(
        GlobalPoint(55.75, 37.61), GlobalPoint(55.76, 37.63));
    Camera camera = _locationWindow!.getEnclosingCamera(boundingBox);
    print("Camera that fits bounding box: $camera");

◆ getEnclosingCameraWithFocus()

Camera LocationWindow.getEnclosingCameraWithFocus	(	BoundingBox	boundingBox,
		ScreenRect?	focusRect,
		double?	azimuth,
		double?	tilt )

Camera that fits boundingBox, with optional overrides. Null focusRect / azimuth / tilt keep the current window values (focusRect property, current camera). Azimuth and tilt are degrees, same units as Camera.

Dart code snippet:

    Camera padded = _locationWindow!.getEnclosingCameraWithFocus(
      boundingBox,
      focus,
      null,
      null,
    );
    print("Camera that fits bounding box in focus rect: $padded");

◆ getOperatingMode()

OperatingMode LocationWindow.getOperatingMode ( )

Returns the current operating mode OperatingMode.

Dart code snippet:

OperatingMode currentMode = _locationWindow!.getOperatingMode();

print("Current operating mode: $currentMode");

◆ getSublocationId()

int LocationWindow.getSublocationId ( )

Returns current sublocation ID if set, otherwise null.

Dart code snippet:

    int? currentId = _locationWindow!.getSublocationId();
    if (currentId != null) {
      print("Current sublocation id: $currentId");
    } else {
      print("Current sublocation id is not set");
    }

◆ isValid()

bool LocationWindow.isValid ( )

◆ moveTo()

void LocationWindow.moveTo	(	Camera	camera,
		int	duration,
		AnimationType	animationType,
		CameraCallback	callback )

Moves the map camera to a new position with an easing animation.

Parameters

camera	The new camera position Camera.
duration	Animation duration in milliseconds (-1 for default duration).
animationType	The type of easing animation AnimationType.
callback	Callback to execute when the animation completes CameraCallback.

Dart code snippet:

    // Move to position with linear animation
    GlobalPoint targetPoint = GlobalPoint(200.0, 300.0);
    Camera targetCamera = Camera(targetPoint, 100.0, 90.0, 0.0);
    CameraCallback callback = CameraCallback(
      onMoveFinished: (completed) {
        print("Move to with linear animation ${completed ? 'completed' : 'cancelled'}");
      },
    );
    _locationWindow!.moveTo(targetCamera, 1500, AnimationType.LINEAR, callback);
    print("Started move to with linear animation");

◆ pickMapFeatureAt()

void LocationWindow.pickMapFeatureAt ( math.Point< double > point )

Selects visible map features (e.g., venues) at the specified screen position.

Parameters

point Position in screen pixels to pick from. Results are delivered to the PickListener via onMapFeaturePickComplete PickListener.

Dart code snippet:

    // Pick map feature at screen position
    math.Point<double> featurePoint = math.Point<double>(150.0, 250.0);
    _locationWindow!.pickMapFeatureAt(featurePoint);
    print("Picked map feature at screen position (${featurePoint.x}, ${featurePoint.y})");

◆ pickMapObjectAt()

void LocationWindow.pickMapObjectAt ( math.Point< double > point )

Selects a visible, interactive map object at the specified screen position.

Parameters

point Position in screen pixels to pick from. Results are delivered to the PickListener via onMapObjectPickComplete PickListener.

Dart code snippet:

    // Pick map object at screen position
    math.Point<double> screenPoint = math.Point<double>(100.0, 200.0);
    _locationWindow!.pickMapObjectAt(screenPoint);
    print("Picked map object at screen position (${screenPoint.x}, ${screenPoint.y})");

◆ removeAllMapObjects()

void LocationWindow.removeAllMapObjects ( )

Removes all map objects from the location view.

Dart code snippet:

    // Remove all map objects
    _locationWindow!.removeAllMapObjects();
    print("Removed all map objects");

◆ removeBuildingListener()

void LocationWindow.removeBuildingListener ( BuildingListener listener )

Removes previously added indoor building listener.

Parameters

listener Listener instance to remove BuildingListener.

Dart code snippet:

_locationWindow!.removeBuildingListener(_buildingListener!);

print('Removed building listener');

◆ removeCameraListener()

void LocationWindow.removeCameraListener ( CameraListener listener )

Removes a previously added CameraListener.

Parameters

listener The CameraListener instance to remove CameraListener.

Dart code snippet:

    // Remove camera listener
    _locationWindow!.removeCameraListener(_cameraListener!);
    _cameraListener = null;
    print("Removed camera listener");

◆ removeCircleMapObject()

bool LocationWindow.removeCircleMapObject ( CircleMapObject circleMapObject )

Removes a circle map object from the location view.

Parameters

circleMapObject The circle map object instance CircleMapObject.

Returns: true if the operation is successful, false otherwise.

Dart code snippet:

    // Remove circle map object
    if (_circleMapObject != null) {
      bool removed = _locationWindow!.removeCircleMapObject(_circleMapObject!);
      print("Removed circle map object: $removed");
      _circleMapObject = null;
    }

◆ removeClusterMapObjectController()

bool LocationWindow.removeClusterMapObjectController ( ClusterMapObjectController controller )

Removes an icon map object controller from the location view.

Parameters

controller The controller instance to remove.

Returns: true if the operation is successful, false otherwise.

Dart code snippet:

    final controllerRemoved =
        _locationWindow!.removeClusterMapObjectController(controller);
    print("Removed cluster map object controller: $controllerRemoved");

◆ removeDottedPolylineMapObject()

bool LocationWindow.removeDottedPolylineMapObject ( DottedPolylineMapObject dottedPolylineMapObject )

Removes a polyline points map object from the location view.

Parameters

dottedPolylineMapObject The polyline points map object instance DottedPolylineMapObject.

Returns: true if the operation is successful, false otherwise.

Dart code snippet:

    // Remove dotted polyline map object
    if (_dottedPolylineMapObject != null) {
      bool removed = _locationWindow!.removeDottedPolylineMapObject(
        _dottedPolylineMapObject!,
      );
      print("Removed dotted polyline map object: $removed");
      _dottedPolylineMapObject = null;
    }

◆ removeIconMapObject()

bool LocationWindow.removeIconMapObject ( IconMapObject iconMapObject )

Removes an icon map object from the location view.

Parameters

iconMapObject The icon map object instance IconMapObject.

Returns: true if the operation is successful, false otherwise.

Dart code snippet:

    // Remove icon map object
    if (_iconMapObject != null) {
      bool removed = _locationWindow!.removeIconMapObject(_iconMapObject!);
      print("Removed icon map object: $removed");
      _iconMapObject = null;
    }

◆ removeInputListener()

void LocationWindow.removeInputListener ( InputListener listener )

Removes a previously added InputListener.

Parameters

listener The InputListener instance to remove InputListener.

Dart code snippet:

    // Remove input listener
    _locationWindow!.removeInputListener(_inputListener!);
    _inputListener = null;
    print("Removed input listener");

◆ removeModelMapObject()

bool LocationWindow.removeModelMapObject ( ModelMapObject modelMapObject )

Removes a model map object from the location view.

Parameters

modelMapObject The model instance to remove ModelMapObject.

Returns: true if the operation is successful, false otherwise.

Dart code snippet:

    bool removed = _locationWindow!.removeModelMapObject(m);
    print("Removed model map object: $removed");
    _modelMapObject = null;

◆ removePickListener()

void LocationWindow.removePickListener ( PickListener listener )

Removes a previously added PickListener.

Parameters

listener The PickListener instance to remove PickListener.

Dart code snippet:

_locationWindow!.removePickListener(listeners[i]);

print("Removed pick listener $i");

◆ removePointBatch()

bool LocationWindow.removePointBatch ( PointBatch pointBatch )

Removes an arrow cloud.

Returns: true when the batch was on the map.

◆ removePolygonMapObject()

bool LocationWindow.removePolygonMapObject ( PolygonMapObject polygonMapObject )

Removes a polygon map object from the location view.

Parameters

polygonMapObject The polygon map object instance PolygonMapObject.

Returns: true if the operation is successful, false otherwise.

Dart code snippet:

    // Remove polygon map object
    if (_polygonMapObject != null) {
      bool removed = _locationWindow!.removePolygonMapObject(
        _polygonMapObject!,
      );
      print("Removed polygon map object: $removed");
      _polygonMapObject = null;
    }

◆ removePolylineMapObject()

bool LocationWindow.removePolylineMapObject ( PolylineMapObject polylineMapObject )

Removes a polyline map object from the location view.

Parameters

polylineMapObject The polyline map object instance PolylineMapObject.

Returns: true if the operation is successful, false otherwise.

Dart code snippet:

    // Remove polyline map object
    if (_polylineMapObject != null) {
      bool removed = _locationWindow!.removePolylineMapObject(
        _polylineMapObject!,
      );
      print("Removed polyline map object: $removed");
      _polylineMapObject = null;
    }

◆ removeSublocationChangeListener()

void LocationWindow.removeSublocationChangeListener ( SublocationChangeListener listener )

Removes previously added sublocation change listener.

Parameters

listener Listener instance to remove SublocationChangeListener.

Dart code snippet:

_locationWindow!.removeSublocationChangeListener(listener);

print("Removed sublocation change listener");

◆ screenPositionToGlobal()

GlobalPoint LocationWindow.screenPositionToGlobal ( math.Point< double > point )

Converts screen coordinates (pixels) to WGS84 coordinates.

Parameters

point (x,y) coordinates in screen pixels.

Returns: WGS84 coordinates GlobalPoint.

Dart code snippet:

    ScreenPoint screenPoint = ScreenPoint(100.0, 200.0);
    GlobalPoint globalPoint = _locationWindow!.screenPositionToGlobal(screenPoint);
    print("Screen position (${screenPoint.x}, ${screenPoint.y}) converted to WGS84: (${globalPoint.latitude}, ${globalPoint.longitude})");

◆ selectMapFeature()

bool LocationWindow.selectMapFeature ( String featureId )

Selects a map feature by its feature ID.

Parameters

featureId The feature ID from the mapFeaturePickResult PickListener.

Returns: true if the operation is successful, false otherwise.

Dart code snippet:

    // Select map feature by ID
    String featureId = "room_101";
    bool selected = _locationWindow!.selectMapFeature(featureId);
    print("Selected map feature $featureId: $selected");

◆ setDebugFlag()

static void LocationWindow.setDebugFlag	(	DebugFlag	flag,
		bool	on )

static

Sets the state of a debug flag.

Parameters

flag	The debug flag to set DebugFlag.
on	Specifies whether the debug flag is enabled (true) or disabled (false).

Dart code snippet:

    LocationWindow.setDebugFlag(DebugFlag.INFOS, true);
    LocationWindow.setDebugFlag(DebugFlag.STATS, false);
    print("Updated debug flags on LocationWindow");

◆ setOperatingMode()

void LocationWindow.setOperatingMode ( OperatingMode mode )

Sets the operating mode of the location view OperatingMode. Default: indoor_only.

Dart code snippet:

_locationWindow!.setOperatingMode(OperatingMode.OUTDOOR_INDOOR);

print("Set operating mode to OUTDOOR_INDOOR");

◆ setSublocationId()

void LocationWindow.setSublocationId ( int id )

Method is used to switch the location view between sublocations (e.g., floors).

Parameters

id	Sublocation unique identifier Sublocation.

Dart code snippet:

    // Set sublocation ID to switch between floors
    _locationWindow!.setSublocationId(1);
    print("Set sublocation ID to 1 (first floor)");

Member Data Documentation

◆ attributionAlignment

AttributionAlignment get LocationWindow.attributionAlignment

Screen placement of the OSM attribution overlay AttributionAlignment. Default: right + bottom. Visible only in outdoor / outdoor_indoor modes.

Dart code snippet:

_locationWindow!.setAttributionAlignment(alignment);

Definition at line 737 of file location_window.dart.

◆ camera

Camera get LocationWindow.camera

Current camera position (look-at in WGS84). Camera.

Dart code snippet:

    // Set camera position without animation
    _locationWindow!.camera = newCamera;
    print("Set camera position to (${newPoint.latitude}, ${newPoint.longitude}) with zoom 50.0, rotation 0°, tilt 0°");

Definition at line 800 of file location_window.dart.

◆ focusRect

ScreenRect get LocationWindow.focusRect

Area of the viewport used when fitting a bounding box. Null (default) is the full view. Set this for a floor selector, follow-me button, or POI card so getEnclosingCamera keeps geometry in the remaining rectangle. Coordinates are screen pixels ScreenRect.

Dart code snippet:

    ScreenRect focus = ScreenRect(
      ScreenPoint(0, 0),
      ScreenPoint(1000, 1600),
    );
    _locationWindow!.setFocusRect(focus);

Definition at line 815 of file location_window.dart.

◆ focusRegion

VisibleRegion get LocationWindow.focusRegion

Four corners of focusRect in WGS84, or visibleRegion when focusRect is null VisibleRegion.

Dart code snippet:

VisibleRegion focusRegion = _locationWindow!.focusRegion;

print("Focus-rect top-left: ${focusRegion.topLeft}");

Definition at line 828 of file location_window.dart.

◆ mapTheme

MapTheme get LocationWindow.mapTheme

Outdoor vector basemap color theme MapTheme. Indoor rasters, venues, and user map objects are unchanged. Default: light.

Dart code snippet:

_locationWindow!.setMapTheme(MapTheme.DARK);

print("Set map theme to DARK");

Definition at line 706 of file location_window.dart.

◆ maxZoomFactor

double get LocationWindow.maxZoomFactor

Maximum zoom level for the location view (pixels per meter).

Dart code snippet:

    // Set maximum zoom factor
    _locationWindow!.maxZoomFactor = 300.0;
    print("Set maximum zoom factor to 300.0");

Definition at line 774 of file location_window.dart.

◆ minZoomFactor

double get LocationWindow.minZoomFactor

Minimum zoom level for the location view (pixels per meter).

Dart code snippet:

    // Set minimum zoom factor
    _locationWindow!.minZoomFactor = 50.0;
    print("Set minimum zoom factor to 50.0");

Definition at line 762 of file location_window.dart.

◆ pickRadius

double get LocationWindow.pickRadius

Extra slop around the hit target, in density-independent pixels. Applied as a screen-pixel radius for points/lines and as a margin around a label's real AABB. Default: 5 dp.

Dart code snippet:

    // Set pick radius
    _locationWindow!.pickRadius = 10.0;
    print("Set pick radius to 10.0 pixels");

Definition at line 903 of file location_window.dart.

◆ rotateGestureEnabled

bool get LocationWindow.rotateGestureEnabled

Specifies whether rotation gestures (e.g., two-finger rotation) are enabled.

Dart code snippet:

    // Set rotate gesture enabled
    _locationWindow!.rotateGestureEnabled = true;
    print("Set rotate gesture enabled to true");

Definition at line 853 of file location_window.dart.

◆ scrollGesturesEnabled

bool get LocationWindow.scrollGesturesEnabled

Specifies whether scroll gestures (e.g., pan gesture) are enabled.

Dart code snippet:

    // Set scroll gestures enabled
    _locationWindow!.scrollGesturesEnabled = true;
    print("Set scroll gestures enabled to true");

Definition at line 877 of file location_window.dart.

◆ selectedMapFeatures

List<String> get LocationWindow.selectedMapFeatures

List of currently selected map feature IDs.

Dart code snippet:

    // Get list of selected map features
    List<String> selectedFeatures = _locationWindow!.selectedMapFeatures;
    print("Currently selected map features: ${selectedFeatures.length} features");
    for (String feature in selectedFeatures) {
      print("  - $feature");
    }

Definition at line 915 of file location_window.dart.

◆ stickToBorder

bool get LocationWindow.stickToBorder

Specifies whether sublocation content sticks to screen borders.

If true, content sticks to screen bounds; if false, content is centered. Default: true.

Dart code snippet:

    // Set stick to border property
    _locationWindow!.stickToBorder = true;
    print("Set stick to border to true");

Definition at line 787 of file location_window.dart.

◆ tileProvider

TileProvider get LocationWindow.tileProvider

Outdoor tile source TileProvider. kind vector draws MVT (schema must match the tiles). kind raster draws PNG, JPEG, or WebP imagery and hides outdoor vector geometry and labels. schema is ignored for raster. Indoor floors stay on top. Null (default) uses OSM Shortbread at vector.openstreetmap.org. When mbtiles is set, tiles are read only from that file.

Dart code snippet:

    _locationWindow!.setTileProvider(osmHttp);
    _locationWindow!.setTileProvider(null);
    final imagery = TileProvider(
      schema: TileSchema.SHORTBREAD,
      http: HttpTileSource(
        urlTemplate: "https://tile.openstreetmap.org/{z}/{x}/{y}.png",
        headers: null,
        queryParameters: null,
      ),
      mbtiles: null,
      minZoom: 0,
      maxZoom: 19,
      attribution: "© OpenStreetMap contributors",
      kind: TileKind.RASTER,
    );
    _locationWindow!.setTileProvider(imagery);

Definition at line 724 of file location_window.dart.

◆ tiltGesturesEnabled

bool get LocationWindow.tiltGesturesEnabled

Specifies whether tilt gestures (e.g., two-finger parallel pan) are enabled.

Dart code snippet:

    // Set tilt gestures enabled
    _locationWindow!.tiltGesturesEnabled = true;
    print("Set tilt gestures enabled to true");

Definition at line 865 of file location_window.dart.

◆ visibleRegion

VisibleRegion get LocationWindow.visibleRegion

Four corners of the current viewport in WGS84 VisibleRegion. Corners are ray-cast onto the ground plane, same as screenPositionToGlobal. With tilt the shape is a trapezoid.

Dart code snippet:

VisibleRegion visibleRegion = _locationWindow!.visibleRegion;

print("Viewport top-left: ${visibleRegion.topLeft}");

Definition at line 842 of file location_window.dart.

◆ zoomFactor

double get LocationWindow.zoomFactor

Specifies the zoom level of the location view, in pixels per meter. Default: approximately 100 meters across the screen width.

Dart code snippet:

    // Set zoom factor
    _locationWindow!.zoomFactor = 150.0;
    print("Set zoom factor to 150.0");

Definition at line 750 of file location_window.dart.

◆ zoomGesturesEnabled

bool get LocationWindow.zoomGesturesEnabled

Specifies whether zoom gestures (e.g., two-finger pinch) are enabled.

Dart code snippet:

    // Set zoom gestures enabled
    _locationWindow!.zoomGesturesEnabled = true;
    print("Set zoom gestures enabled to true");

Definition at line 889 of file location_window.dart.

The documentation for this class was generated from the following file:

location_window.dart

Public Member Functions

Static Public Member Functions

Public Attributes

Detailed Description

Member Function Documentation

◆ addBuildingListener()

◆ addCameraListener()

◆ addCircleMapObject()

◆ addClusterMapObjectController()

◆ addDottedPolylineMapObject()

◆ addGeoJson()

◆ addIconMapObject()

◆ addInputListener()

◆ addModelMapObject()

◆ addPickListener()

◆ addPointBatch()

◆ addPolygonMapObject()

◆ addPolylineMapObject()

◆ addSublocationChangeListener()

◆ applyLayerFilter()

◆ deselectAllMapFeatures()

◆ deselectMapFeature()

◆ flyTo()

◆ getAttribution()

◆ getDebugFlag()

◆ getEnclosingCamera()

◆ getEnclosingCameraWithFocus()

◆ getOperatingMode()

◆ getSublocationId()

◆ isValid()

◆ moveTo()

◆ pickMapFeatureAt()

◆ pickMapObjectAt()

◆ removeAllMapObjects()

◆ removeBuildingListener()

◆ removeCameraListener()

◆ removeCircleMapObject()

◆ removeClusterMapObjectController()

◆ removeDottedPolylineMapObject()

◆ removeIconMapObject()

◆ removeInputListener()

◆ removeModelMapObject()

◆ removePickListener()

◆ removePointBatch()

◆ removePolygonMapObject()

◆ removePolylineMapObject()

◆ removeSublocationChangeListener()

◆ screenPositionToGlobal()

◆ selectMapFeature()

◆ setDebugFlag()

◆ setOperatingMode()

◆ setSublocationId()

Member Data Documentation

◆ attributionAlignment

◆ camera

◆ focusRect

◆ focusRegion

◆ mapTheme

◆ maxZoomFactor

◆ minZoomFactor

◆ pickRadius

◆ rotateGestureEnabled

◆ scrollGesturesEnabled

◆ selectedMapFeatures

◆ stickToBorder

◆ tileProvider

◆ tiltGesturesEnabled

◆ visibleRegion

◆ zoomFactor

◆ zoomGesturesEnabled