ViewportController class

A controller for imperatively changing the map's viewport with animations.

Use ViewportController when you need to animate the camera to a new position in response to user actions or other events. For static camera positioning, use MapWidget.viewport instead.

The controller follows the same pattern as TextEditingController or ScrollController: create it, pass it to MapWidget.viewportController, call moveTo to animate, and dispose when done.

class _MyWidgetState extends State<MyWidget> {
  final _viewportController = ViewportController();

  void _flyToNewYork() {
    _viewportController.moveTo(
      CameraViewportState(
        center: Point(coordinates: Position(-74.0, 40.7)),
        zoom: 12,
      ),
      transition: FlyViewportTransition(duration: Duration(seconds: 2)),
      completion: (finished) => print('Animation finished: $finished'),
    );
  }

  @override
  Widget build(BuildContext context) {
    return MapWidget(
      viewport: CameraViewportState(center: Point(coordinates: Position(0, 0))),
      viewportController: _viewportController,
    );
  }

  @override
  void dispose() {
    _viewportController.dispose();
    super.dispose();
  }
}