Position update callback interface for real-time location tracking.
This abstract class defines a callback interface that receives position updates from the Maps SDK. Position listeners are created internally by the PositionService when you register position update callbacks using PositionService.addPositionListener or PositionService.addImprovedPositionListener.
This is a callback interface managed by the SDK. You cannot instantiate it directly. Instead, register position callbacks with PositionService, which returns a GemPositionListener instance that can be used to remove the listener later.
The interface provides two types of position notifications:
- Basic position updates (
notifyOnNewPosition): Raw GPS coordinates, speed, accuracy, and other basic location data from the device sensors. - Improved position updates (
notifyOnNewImprovedPosition): Map-matched positions that include additional context such as current road information, speed limits, road modifiers, and address details.
See also:
- PositionService.addPositionListener for registering basic position callbacks
- PositionService.addImprovedPositionListener for registering enhanced position callbacks
- GemPosition for basic position data structure
- GemImprovedPosition for enhanced position data structure
Constructors
Properties
Methods
-
clearListeners(
) → void -
Nulls all registered callback fields so the captured closures (and the
objects they reference, such as widgets or controllers) become eligible
for garbage collection.
inherited
-
dispose(
) → FutureOr< void> -
Tears down this listener.
inherited
-
handleEvent(
Map arguments) → void -
Method called when an event is dispatched from the native side.
inherited
-
nativeClear(
) → void -
Releases bridge/native-side resources tied to this listener — for
example, an unregister call against a global service or a Dart-side
event-handler detach.
inherited
-
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a nonexistent method or property is accessed.
inherited
-
toString(
) → String -
A string representation of this object.
inherited
Operators
-
operator ==(
Object other) → bool -
The equality operator.
inherited