maplibre-camera

MapLibre camera feedback loops occur when state changes trigger animations that update state again, creating instability. The useMapCamera composable prevents this with internal flags that distinguish user actions from programmatic moves, ensuring animations complete without re-triggering updates.

Use the useMapCamera composable to call flyTo, easeTo, or jumpTo methods with animation parameters like center, zoom, bearing, and pitch. The composable manages state refs and lifecycle cleanup, delivering promise-based animations that resolve when complete.

Yes. Route all camera operations through useMapCamera instead of direct map access. The composable enforces a single control point, exposing state refs (center, zoom, pitch, bearing, isAnimating, isLoaded) and methods (flyTo, easeTo, jumpTo, fitBounds) with built-in lifecycle management.

Call fitBounds or flyTo through the useMapCamera composable with your target coordinates and animation options. The composable handles state synchronization and prevents feedback loops, supporting scenarios from initial positioning to region fitting and quick transitions.

The useMapCamera composable includes globe visibility filter utilities to determine which markers project as visible in globe mode. Use these filters in marker rendering logic to avoid displaying points that fall outside the globe's visible hemisphere.

Yes. The useMapCamera composable exposes a cinematic intro helper pattern for choreographing custom animations beyond flyTo, easeTo, and jumpTo, enabling branded or dramatic opening sequences before standard camera control.