Terrain component for enabling 3D terrain visualization in MapLibre maps.

This component enables 3D terrain rendering using a RasterDEMSource. It requires a RasterDEMSource to be configured on the map first.

Examples

Basic terrain setup with Mapbox terrain tiles:

<.raster_dem_source
  id="mapbox-dem"
  map_id="my-map"
  url="mapbox://mapbox.terrain-rgb"
  tile_size={512}
  max_zoom={14}
/>

<.terrain
  map_id="my-map"
  source_id="mapbox-dem"
  exaggeration={1.5}
/>

Terrain with custom DEM source:

<.raster_dem_source
  id="custom-dem"
  map_id="my-map"
  tiles={["https://example.com/dem/{z}/{x}/{y}.png"]}
  encoding="terrarium"
/>

<.terrain
  map_id="my-map"
  source_id="custom-dem"
  exaggeration={2.0}
/>

Events

The terrain component can emit the following events to LiveView:

def handle_event("terrain:enabled", %{"exaggeration" => exag}, socket) do
  IO.inspect(exag, label: "Terrain enabled with exaggeration")
  {:noreply, socket}
end

def handle_event("terrain:disabled", _params, socket) do
  IO.puts("Terrain disabled")
  {:noreply, socket}
end

Notes

• Requires a RasterDEMSource to be configured first
• Exaggeration values typically range from 0.5 to 3.0
• Higher exaggeration makes terrain more dramatic
• Terrain rendering requires WebGL support
• Best viewed with pitch and bearing camera angles