FollowPositionPreferences class Maps & 3D Scenes
Follow position preferences for camera control during position tracking
This class should not be instantiated directly. Instead, use the MapViewPreferences.followPositionPreferences getter to obtain an instance.
Controls how the camera behaves while following a tracked position (real or simulated).
Common tasks include:
- Moving the follow-camera focus inside the viewport using setCameraFocus
- Switching between flat and 3D perspectives with optional animation via setPerspective
- Adjusting pitch/tilt with setViewAngle and zoom (including auto-zoom behavior) with setZoomLevel
- Choosing the rotation source (sensor heading, compass or a fixed angle) via setMapRotationMode
- Showing or hiding the accuracy indicator with setAccuracyCircleVisibility and customizing its appearance via MapSceneObject
- Fine‑tuning touch behavior: allowing or preventing manual exit via touchHandlerExitAllow, making manual adjustments persistent via touchHandlerModifyPersistent, and setting angle/distance limits
It exposes read access to current follow-mode settings including cameraFocus, perspective, viewAngle, zoomLevel, mapRotationMode, and accuracyCircleVisibility.
See also:
- MapViewPreferences.followPositionPreferences - Access point for this class
- GemMapController.startFollowingPosition - Start following the device position
- GemMapController.stopFollowingPosition - Stop following the device position
- MapSceneObject - Customize accuracy circle appearance
- MapViewPerspective - Available perspective modes
- FollowPositionMapRotationMode - Available rotation modes
Properties
- accuracyCircleVisibility → bool
-
Whether the position accuracy circle is currently visible
no setter
-
cameraFocus
→ Point<
double> -
Camera focus position in viewport coordinates
no setter
- hashCode → int
-
The hash code for this object.
no setterinherited
- isTrackObjectFollowingMapRotation → bool
-
Whether the position tracker icon rotates with the map view
no setter
- mapId → int
-
no setter
- mapPointerId → int
-
no setter
- mapRotationMode → (FollowPositionMapRotationMode, double)
-
Current map rotation mode and fixed angle during follow position
no setter
- perspective → MapViewPerspective
-
Current map view perspective during follow position mode
no setter
- pointerId → int
-
The pointer ID of the native object
no setterinherited
- runtimeType → Type
-
A representation of the runtime type of the object.
no setterinherited
- timeBeforeTurnPresentation ↔ int
-
Time interval before starting turn presentation during navigation
getter/setter pair
- touchHandlerExitAllow ↔ bool
-
Whether user gestures can exit follow position mode
getter/setter pair
- touchHandlerModifyDistanceLimits ↔ (double, double)
-
Distance adjustment limits for camera zoom via user gestures during follow mode
getter/setter pair
- touchHandlerModifyHorizontalAngleLimits ↔ (double, double)
-
Horizontal angle adjustment limits for user gestures during follow mode
getter/setter pair
- touchHandlerModifyPersistent ↔ bool
-
Whether manual follow position adjustments persist across sessions
getter/setter pair
- touchHandlerModifyVerticalAngleLimits ↔ (double, double)
-
Vertical angle (pitch) adjustment limits for user gestures during follow mode
getter/setter pair
- viewAngle → double
-
Camera pitch angle during follow position mode
no setter
- zoomLevel → int
-
Current zoom level during follow position mode
no setter
Methods
-
dispose(
) → void -
Disposes the native object.
inherited
-
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a nonexistent method or property is accessed.
inherited
-
registerAutoReleaseObject(
int pointerId) → void -
Registers an object for auto release.
inherited
-
setAccuracyCircleVisibility(
bool isVisible) → GemError - Show or hide the position accuracy circle
-
setCameraFocus(
Point< double> pos) → GemError - Set the camera focus position within the viewport during follow mode
-
setMapRotationMode(
FollowPositionMapRotationMode mode, {double mapAngle = 0, bool objectFollowMap = true}) → void - Configure how the map rotates during follow position mode
-
setPerspective(
MapViewPerspective perspective, {GemAnimation? animation}) → void - Switch between 2D and 3D map perspectives during follow position mode
-
setViewAngle(
double viewAngle, {bool animated = false}) → void - Set the camera pitch angle during follow position mode
-
setZoomLevel(
int zoomLevel, {int duration = 0}) → int - Set the zoom level during follow position mode
-
toString(
) → String -
A string representation of this object.
inherited
Operators
-
operator ==(
Object other) → bool -
The equality operator.
inherited