Sources

VideoSource

The VideoSource component enables you to add a looping video overlay to your map.

This can be useful for visualizing time-based data or enhancing the map with live, pre-recorded, or animated video content, such as drone footage, weather maps, or interactive backgrounds.

Usage

The VideoSource requires a video URL (or multiple URLs for fallback) and a set of coordinates defining the video’s bounds on the map. The video will play automatically within the specified bounds, adapting to the map’s position and zoom levels.

Please navigate to RasterLayer for an example.

API

Props

The VideoSource component’s props.

While an id is typically required for MapLibre sources, the VideoSource component automatically generates a unique id if none is provided.

PropDescriptionType
idThe id for the source. Must not be used by any existing source.Optional string
urlsURLs to video content in order of preferred format.Required array
coordinatesCorners of video specified in longitude, latitude pairs.Required array
Previous
VectorSource