centerOnArea method

void centerOnArea(
  1. RectangleGeographicArea area, {
  2. int zoomLevel = -1,
  3. Point<int>? screenPosition,
  4. GemAnimation? animation,
})

Centers the map view on a specified geographic area rectangle.

Positions the map to display the entire RectangleGeographicArea defined by top-left and bottom-right coordinates. The zoom level automatically adjusts to fit the area unless explicitly specified. The area centers at the target screen position or cursor location.

Use centerOnAreaRect for finer control over which screen region displays the area, particularly useful for adding padding or positioning the area within a specific viewport region.

Parameters

  • area: The geographic area to center on, defined by top-left and bottom-right WGS84 coordinates
  • zoomLevel: Zoom level for the centered view. A greater zoom level means closer to the ground. Use -1 for automatic selection to fit the entire area. Defaults to -1
  • screenPosition: Target screen position in physical pixels where the area center should project, relative to the map view's top-left corner. If null, uses the current cursor position. Defaults to null
  • animation: Animation settings for the centering operation. If null, centering occurs instantly. Defaults to null

See also:

Implementation

void centerOnArea(
  final RectangleGeographicArea area, {
  final int zoomLevel = -1,
  final Point<int>? screenPosition,
  final GemAnimation? animation,
}) {
  objectMethod(
    _pointerId,
    'MapView',
    'centerOnArea',
    args: <String, Object?>{
      'area': area,
      'zoomLevel': zoomLevel,
      if (screenPosition != null) 'xy': XyType<int>.fromPoint(screenPosition),
      if (animation != null) 'animation': animation,
    },
  );
}