Geolocate control component for MapLibre maps in Phoenix LiveView.

This component adds a geolocate button that allows users to find their current location and optionally track their movement in real-time.

Examples

Basic geolocate control:

<.geolocate_control
  id="geolocate-1"
  map_id="my-map"
  position="top-right"
/>

With tracking enabled:

<.geolocate_control
  id="geolocate-1"
  map_id="my-map"
  position="top-right"
  track_user_location={true}
  show_accuracy_circle={true}
  show_user_heading={true}
/>

With custom fit bounds options:

<.geolocate_control
  id="geolocate-1"
  map_id="my-map"
  position="top-right"
  fit_bounds_options={%{maxZoom: 15, padding: 50}}
/>

Events

The geolocate control emits the following events to LiveView:

def handle_event("geolocate:location_found", %{"coords" => coords}, socket) do
  # coords = %{"latitude" => lat, "longitude" => lng, "accuracy" => acc}
  IO.inspect(coords, label: "User location found")
  {:noreply, socket}
end

def handle_event("geolocate:location_error", %{"code" => code, "message" => msg}, socket) do
  IO.inspect({code, msg}, label: "Geolocation error")
  {:noreply, socket}
end

def handle_event("geolocate:tracking_started", _params, socket) do
  IO.puts("Location tracking started")
  {:noreply, socket}
end

def handle_event("geolocate:tracking_stopped", _params, socket) do
  IO.puts("Location tracking stopped")
  {:noreply, socket}
end

def handle_event("geolocate:user_location_updated", %{"coords" => coords}, socket) do
  IO.inspect(coords, label: "User location updated")
  {:noreply, socket}
end