chore: document MapPosition/PositionCallback.hasGesture in-code (#1973

)

lib/src/map/options/options.dart

@@ -41,6 +41,8 @@ typedef PointerHoverCallback = void Function(
 );
 
 /// Callback that gets called when the viewport of the map changes.
+///
+/// {@macro map_position.has_gesture}
 typedef PositionCallback = void Function(MapCamera camera, bool hasGesture);
 
 /// All options for the [FlutterMap] widget.

lib/src/misc/position.dart

@@ -9,6 +9,15 @@ class MapPosition {
   final LatLng? center;
   final LatLngBounds? bounds;
   final double? zoom;
+
+  /// {@template map_position.has_gesture}
+  /// [hasGesture] determines if the change was caused by a user gesture (interaction with the map) or not.
+  ///
+  /// For example, if the user panned out the map, then [hasGesture] would be true because the change was
+  /// caused by a user gesture. On the other hand, if the map's position was changed using the map's
+  /// controller, then [hasGesture] would be false because the change was not caused by a user gesture,
+  /// but programmatically.
+  /// {@endtemplate}
   final bool hasGesture;
 
   const MapPosition({
@@ -29,4 +38,7 @@ class MapPosition {
       other.zoom == zoom;
 }
 
+/// Callback that gets called when the map's position changes.
+///
+/// {@macro map_position.has_gesture}
 typedef PositionCallback = void Function(MapPosition position, bool hasGesture);