Camera Bounds

Constrain the camera so users can't pan outside a geographic area or zoom beyond specified levels. Useful for apps focused on a specific region.

Constrain geographic bounds

Pass cameraTargetBounds to MapLibreMap:

MapLibreMap(
  cameraTargetBounds: CameraTargetBounds(
    LatLngBounds(
      southwest: const LatLng(41.0, -5.5),  // SW corner
      northeast: const LatLng(51.5, 9.5),   // NE corner
    ),
  ),
  initialCameraPosition: const CameraPosition(
    target: LatLng(46.0, 2.0),
    zoom: 5.0,
  ),
)

Users cannot pan outside the specified bounds. The map snaps back if they try.

Remove bounds constraint

MapLibreMap(
  cameraTargetBounds: CameraTargetBounds.unbounded, // default
)

Constrain zoom levels

MapLibreMap(
  minMaxZoomPreference: const MinMaxZoomPreference(8.0, 18.0),
  // minZoom: 8 : can't zoom out past city level
  // maxZoom: 18: can't zoom in past building level
)

Fit camera to a bounding box

To programmatically set the camera to show a region:

await controller.animateCamera(
  CameraUpdate.newLatLngBounds(
    LatLngBounds(
      southwest: const LatLng(41.0, -5.5),
      northeast: const LatLng(51.5, 9.5),
    ),
    left: 50, top: 50, right: 50, bottom: 50, // padding in px
  ),
);

Platform notes

iOS implementation

iOS lacks a native setLatLngBoundsForCameraTarget API equivalent to Android's. The current iOS implementation intercepts camera movement via the delegate's shouldChangeFrom:to: method and rejects out-of-bounds positions.

Known caveats on iOS: - Only blocks user gestures (pan, pinch). Programmatic animateCamera() calls are not blocked. - No per-axis clamping: diagonal pans near the boundary may feel slightly sticky. - Android has the more complete implementation.