From 1e9126a3743c50afcf5bea11a51b5836bb385289 Mon Sep 17 00:00:00 2001
From: Bryon Lewis <Bryon.Lewis@kitware.com>
Date: Wed, 25 Mar 2026 12:02:03 -0400
Subject: [PATCH 01/21] backend recording-locations endpoint

---
 bats_ai/core/api.py                           |   4 +
 bats_ai/core/management/commands/loadGRTS.py  |  14 +-
 .../0035_add_grtscells_centroid_4326.py       |  43 +++
 bats_ai/core/models/grts_cells.py             |   2 +
 bats_ai/core/views/__init__.py                |   2 +
 bats_ai/core/views/grts_cells.py              |   5 +-
 bats_ai/core/views/recording_location.py      | 260 ++++++++++++++++++
 7 files changed, 325 insertions(+), 5 deletions(-)
 create mode 100644 bats_ai/core/migrations/0035_add_grtscells_centroid_4326.py
 create mode 100644 bats_ai/core/views/recording_location.py

diff --git a/bats_ai/core/api.py b/bats_ai/core/api.py
index 51008c2c..0d6a8d49 100644
--- a/bats_ai/core/api.py
+++ b/bats_ai/core/api.py
@@ -28,6 +28,10 @@ def global_auth(request):
 api = NinjaAPI(auth=global_auth)
 
 api.add_router("/recording/", views.recording_router)
+api.add_router(
+    "/recording-locations/",
+    views.recording_locations_router,
+)
 api.add_router("/species/", views.species_router)
 api.add_router("/grts/", views.grts_cells_router)
 api.add_router("/guano/", views.guano_metadata_router)
diff --git a/bats_ai/core/management/commands/loadGRTS.py b/bats_ai/core/management/commands/loadGRTS.py
index e93946dc..3f13605a 100644
--- a/bats_ai/core/management/commands/loadGRTS.py
+++ b/bats_ai/core/management/commands/loadGRTS.py
@@ -53,7 +53,10 @@ class Command(BaseCommand):
 
     def add_arguments(self, parser):
         parser.add_argument(
-            "--batch-size", type=int, default=5000, help="Batch size for database insertion"
+            "--batch-size",
+            type=int,
+            default=5000,
+            help="Batch size for database insertion",
         )
 
     def _download_file(self, url: str, zip_path: Path) -> None:
@@ -78,7 +81,8 @@ def handle(self, *args, **options):
                     self._download_file(url, zip_path)
                 except requests.RequestException as e:
                     logger.warning(
-                        "Failed to download from primary URL: %s. Attempting backup URL...", e
+                        "Failed to download from primary URL: %s. Attempting backup URL...",
+                        e,
                     )
                     if backup_url is None:
                         logger.warning("No backup URL provided, skipping this shapefile.")
@@ -117,7 +121,9 @@ def handle(self, *args, **options):
                 count_new = 0
 
                 for idx, row in tqdm(
-                    gdf.iterrows(), total=len(gdf), desc=f"Importing {sample_frame_id}"
+                    gdf.iterrows(),
+                    total=len(gdf),
+                    desc=f"Importing {sample_frame_id}",
                 ):
                     # Hard fail if GRTS_ID is missing
                     if "GRTS_ID" not in row or row["GRTS_ID"] is None:
@@ -131,6 +137,7 @@ def handle(self, *args, **options):
                         continue
 
                     geom_4326 = row.geometry.wkt
+                    centroid_4326 = row.geometry.centroid.wkt
                     if gdf.crs and gdf.crs.to_epsg() != 4326:
                         grts_geom = row.geometry.to_wkt()
                     else:
@@ -142,6 +149,7 @@ def handle(self, *args, **options):
                         sample_frame_id=sample_frame_id,
                         grts_geom=grts_geom,
                         geom_4326=geom_4326,
+                        centroid_4326=centroid_4326,
                     )
                     records_to_create.append(cell)
                     count_new += 1
diff --git a/bats_ai/core/migrations/0035_add_grtscells_centroid_4326.py b/bats_ai/core/migrations/0035_add_grtscells_centroid_4326.py
new file mode 100644
index 00000000..31633850
--- /dev/null
+++ b/bats_ai/core/migrations/0035_add_grtscells_centroid_4326.py
@@ -0,0 +1,43 @@
+from __future__ import annotations
+
+from django.db import migrations, models
+
+
+def backfill_centroids(apps, schema_editor) -> None:
+    GRTSCells = apps.get_model("core", "GRTSCells")
+
+    batch_size = 1000
+    to_update = []
+
+    qs = (
+        GRTSCells.objects.filter(centroid_4326__isnull=True)
+        .exclude(geom_4326__isnull=True)
+        .only("id", "grts_cell_id", "sample_frame_id", "geom_4326")
+    )
+
+    for cell in qs.iterator(chunk_size=batch_size):
+        # `centroid` returns a Point geometry in the same SRID.
+        cell.centroid_4326 = cell.geom_4326.centroid
+        to_update.append(cell)
+
+        if len(to_update) >= batch_size:
+            GRTSCells.objects.bulk_update(to_update, ["centroid_4326"], batch_size=batch_size)
+            to_update.clear()
+
+    if to_update:
+        GRTSCells.objects.bulk_update(to_update, ["centroid_4326"], batch_size=batch_size)
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("core", "0034_alter_spectrogramimage_type"),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name="grtscells",
+            name="centroid_4326",
+            field=models.PointField(srid=4326, null=True, blank=True),
+        ),
+        migrations.RunPython(backfill_centroids, migrations.RunPython.noop),
+    ]
diff --git a/bats_ai/core/models/grts_cells.py b/bats_ai/core/models/grts_cells.py
index c0de5144..270f0a76 100644
--- a/bats_ai/core/models/grts_cells.py
+++ b/bats_ai/core/models/grts_cells.py
@@ -24,6 +24,8 @@ class GRTSCells(models.Model):
     grts_geom = models.GeometryField(blank=True, null=True)
     # continue defining all fields similarly
     geom_4326 = models.GeometryField()
+    # Precomputed centroid of `geom_4326` for faster lookup of cell centers.
+    centroid_4326 = models.PointField(srid=4326, blank=True, null=True)
 
     @property
     def sample_frame_mapping(self):
diff --git a/bats_ai/core/views/__init__.py b/bats_ai/core/views/__init__.py
index 70331d60..39c9fd22 100644
--- a/bats_ai/core/views/__init__.py
+++ b/bats_ai/core/views/__init__.py
@@ -7,6 +7,7 @@
 from .processing_tasks import router as processing_task_router
 from .recording import router as recording_router
 from .recording_annotation import router as recording_annotation_router
+from .recording_location import router as recording_locations_router
 from .recording_tag import router as recording_tag_router
 from .species import router as species_router
 from .vetting_details import router as vetting_router
@@ -18,6 +19,7 @@
     "guano_metadata_router",
     "processing_task_router",
     "recording_annotation_router",
+    "recording_locations_router",
     "recording_router",
     "recording_tag_router",
     "species_router",
diff --git a/bats_ai/core/views/grts_cells.py b/bats_ai/core/views/grts_cells.py
index 02337ad2..c335ea23 100644
--- a/bats_ai/core/views/grts_cells.py
+++ b/bats_ai/core/views/grts_cells.py
@@ -50,8 +50,6 @@ def custom_sort_key(cell):
         geom_4326 = cell.geom_4326
 
         # Get the centroid of the entire cell polygon
-        center = geom_4326.centroid
-
         if quadrant:
             # If quadrant is specified, divide the cell polygon into quadrants
             min_x, min_y, max_x, max_y = geom_4326.extent
@@ -75,6 +73,9 @@ def custom_sort_key(cell):
 
             # Get the centroid of the intersected polygon
             center = quadrant_polygon.centroid
+        else:
+            # Prefer the stored centroid (precomputed on import/migration).
+            center = cell.centroid_4326 if cell.centroid_4326 is not None else geom_4326.centroid
 
         # Get the latitude and longitude of the centroid
         center_latitude = center.y
diff --git a/bats_ai/core/views/recording_location.py b/bats_ai/core/views/recording_location.py
new file mode 100644
index 00000000..e6794260
--- /dev/null
+++ b/bats_ai/core/views/recording_location.py
@@ -0,0 +1,260 @@
+from __future__ import annotations
+
+import json
+import logging
+from typing import TYPE_CHECKING, Any, Literal
+
+from django.db.models import Q, QuerySet
+from ninja import Query, Router, Schema
+from ninja.errors import HttpError
+
+from bats_ai.core.models import Configuration, GRTSCells, Recording, RecordingAnnotation
+
+if TYPE_CHECKING:
+    from django.http import HttpRequest
+
+logger = logging.getLogger(__name__)
+
+router = Router()
+
+_GRTS_CUSTOM_ORDER: list[int] = GRTSCells.sort_order()
+_GRTS_ORDER_MAP: dict[int, int] = {frame_id: idx for idx, frame_id in enumerate(_GRTS_CUSTOM_ORDER)}
+
+
+class RecordingLocationsQuerySchema(Schema):
+    # When true, exclude recordings the current user has already submitted.
+    exclude_submitted: bool | None = None
+    # Comma-separated tag texts; recording must have all listed tags.
+    tags: str | None = None
+    # Bounding box filter (lon/lat) as `[min_lon, min_lat, max_lon, max_lat]`.
+    bbox: str | None = None
+
+
+class RecordingLocationsFeaturePropertiesSchema(Schema):
+    recording_id: int
+    filename: str
+
+
+class RecordingLocationsFeatureGeometrySchema(Schema):
+    type: Literal["Point"] = "Point"
+    coordinates: list[float]
+
+
+class RecordingLocationsFeatureSchema(Schema):
+    type: Literal["Feature"] = "Feature"
+    geometry: RecordingLocationsFeatureGeometrySchema
+    properties: RecordingLocationsFeaturePropertiesSchema
+
+
+class RecordingLocationsResponseSchema(Schema):
+    type: Literal["FeatureCollection"] = "FeatureCollection"
+    features: list[RecordingLocationsFeatureSchema]
+
+
+def _split_tags(tags: str | None) -> list[str]:
+    if not tags:
+        return []
+    return [t.strip() for t in tags.split(",") if t.strip()]
+
+
+def _apply_recording_filters_and_sort(
+    *,
+    qs: QuerySet[Recording],
+    request: HttpRequest,
+    exclude_submitted: bool | None,
+    tags: str | None,
+) -> QuerySet[Recording]:
+    if exclude_submitted:
+        submitted_by_user = RecordingAnnotation.objects.filter(
+            owner=request.user, submitted=True
+        ).values_list("recording_id", flat=True)
+        qs = qs.exclude(pk__in=submitted_by_user)
+
+    tag_list = _split_tags(tags)
+    if tag_list:
+        for tag in tag_list:
+            qs = qs.filter(tags__text=tag)
+        qs = qs.distinct()
+
+    # Keep deterministic ordering even though we don't expose sorting params.
+    return qs.order_by("-created")
+
+
+def _coords_in_bbox(
+    coords: list[float],
+    *,
+    min_lon: float,
+    min_lat: float,
+    max_lon: float,
+    max_lat: float,
+) -> bool:
+    lon, lat = coords
+    return min_lon <= lon <= max_lon and min_lat <= lat <= max_lat
+
+
+def _parse_bbox(bbox: str | None) -> tuple[float, float, float, float] | None:
+    if not bbox:
+        return None
+
+    raw = bbox.strip()
+    try:
+        # Prefer JSON array format: bbox=[43,73,42,45]
+        if raw.startswith("[") and raw.endswith("]"):
+            values = json.loads(raw)
+        else:
+            # Allow bbox=43,73,42,45 as a convenience.
+            values = [v.strip() for v in raw.split(",")]
+    except Exception as e:  # pragma: no cover
+        raise HttpError(400, f"Invalid bbox format: {e}") from e
+
+    if not isinstance(values, list) or len(values) != 4:
+        raise HttpError(400, "bbox must contain exactly 4 numbers")
+
+    try:
+        min_lon, min_lat, max_lon, max_lat = (float(v) for v in values)
+    except Exception as e:
+        raise HttpError(400, f"bbox values must be numbers: {e}") from e
+
+    if not (-180.0 <= min_lon <= 180.0 and -180.0 <= max_lon <= 180.0):
+        raise HttpError(400, "bbox longitude values must be within [-180, 180]")
+    if not (-90.0 <= min_lat <= 90.0 and -90.0 <= max_lat <= 90.0):
+        raise HttpError(400, "bbox latitude values must be within [-90, 90]")
+
+    # Normalize ordering.
+    if min_lon > max_lon:
+        min_lon, max_lon = max_lon, min_lon
+    if min_lat > max_lat:
+        min_lat, max_lat = max_lat, min_lat
+
+    return min_lon, min_lat, max_lon, max_lat
+
+
+def _get_recording_location_coords(recording: Recording) -> list[float] | None:
+    """Return `[lon, lat]` for `Recording.recording_location` if present."""
+    if not recording.recording_location:
+        return None
+
+    # GeoDjango geometry -> GeoJSON -> coordinates.
+    location_geojson = json.loads(recording.recording_location.json)
+    coords = location_geojson.get("coordinates")
+    if (
+        isinstance(coords, list)
+        and len(coords) == 2
+        and all(isinstance(v, (int, float)) for v in coords)
+    ):
+        return [float(coords[0]), float(coords[1])]
+    return None
+
+
+def _precompute_grts_cell_centroids(cell_ids: set[int]) -> dict[int, list[float]]:
+    """Precompute centroid coordinates for each `grts_cell_id`.
+
+    Choose the same "best" cell as `core/views/grts_cells.py` does, then compute
+    `[lon, lat]` from its centroid.
+    """
+    if not cell_ids:
+        return {}
+
+    centroids: dict[int, list[float]] = {}
+
+    cells = GRTSCells.objects.filter(grts_cell_id__in=cell_ids)
+    cells_by_id: dict[int, list[GRTSCells]] = {}
+    for cell in cells:
+        cells_by_id.setdefault(cell.grts_cell_id, []).append(cell)
+
+    for cell_id in cell_ids:
+        candidates = cells_by_id.get(cell_id, [])
+        if not candidates:
+            continue
+
+        # Pick the same "best" cell as core/views/grts_cells.py.
+        best = sorted(
+            candidates,
+            key=lambda c: _GRTS_ORDER_MAP.get(c.sample_frame_id, len(_GRTS_CUSTOM_ORDER)),
+        )[0]
+
+        # Prefer the stored centroid (computed during GRTS import / migrations).
+        if best.centroid_4326 is None:
+            continue
+
+        centroids[cell_id] = [float(best.centroid_4326.x), float(best.centroid_4326.y)]
+
+    return centroids
+
+
+@router.get("/", response=RecordingLocationsResponseSchema)
+def get_recording_locations(
+    request: HttpRequest,
+    q: Query[RecordingLocationsQuerySchema],
+):
+    config = Configuration.objects.first()
+    vetting_enabled = bool(config.mark_annotations_completed_enabled) if config else False
+
+    # Build "full" set: my + shared recordings.
+    my_qs = Recording.objects.filter(owner=request.user)
+    shared_qs = Recording.objects.filter(public=True).exclude(
+        Q(owner=request.user) | Q(spectrogram__isnull=True)
+    )
+
+    my_qs = _apply_recording_filters_and_sort(
+        qs=my_qs,
+        request=request,
+        exclude_submitted=q.exclude_submitted,
+        tags=q.tags,
+    )
+    shared_qs = _apply_recording_filters_and_sort(
+        qs=shared_qs,
+        request=request,
+        exclude_submitted=q.exclude_submitted,
+        tags=q.tags,
+    )
+
+    # Evaluate querysets: we need in-Python centroid/geojson conversion.
+    my_list = list(my_qs)
+    shared_list = list(shared_qs)
+    recordings = my_list + shared_list
+
+    required_cell_ids = {r.grts_cell_id for r in recordings if r.grts_cell_id is not None}
+    centroids_by_cell_id = _precompute_grts_cell_centroids(required_cell_ids)
+
+    bbox = _parse_bbox(q.bbox)
+
+    features: list[dict[str, Any]] = []
+    for rec in recordings:
+        coords: list[float] | None = None
+
+        if vetting_enabled:
+            if rec.grts_cell_id is not None:
+                coords = centroids_by_cell_id.get(rec.grts_cell_id)
+            # If we can't resolve a centroid, fall back to recording_location if present.
+            if coords is None:
+                coords = _get_recording_location_coords(rec)
+        else:
+            coords = _get_recording_location_coords(rec)
+            if coords is None and rec.grts_cell_id is not None:
+                coords = centroids_by_cell_id.get(rec.grts_cell_id)
+
+        if coords is None:
+            continue
+
+        if bbox is not None and not _coords_in_bbox(
+            coords,
+            min_lon=bbox[0],
+            min_lat=bbox[1],
+            max_lon=bbox[2],
+            max_lat=bbox[3],
+        ):
+            continue
+
+        features.append(
+            {
+                "type": "Feature",
+                "geometry": {"type": "Point", "coordinates": coords},
+                "properties": {
+                    "recording_id": rec.id,
+                    "filename": str(rec.audio_file),
+                },
+            }
+        )
+
+    return {"type": "FeatureCollection", "features": features}

From 8d6156c4d13db6f73b25779db898719bc310e4dd Mon Sep 17 00:00:00 2001
From: Bryon Lewis <Bryon.Lewis@kitware.com>
Date: Wed, 25 Mar 2026 12:14:40 -0400
Subject: [PATCH 02/21] fix model reference for migration

---
 bats_ai/core/migrations/0035_add_grtscells_centroid_4326.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/bats_ai/core/migrations/0035_add_grtscells_centroid_4326.py b/bats_ai/core/migrations/0035_add_grtscells_centroid_4326.py
index 31633850..80f5fc32 100644
--- a/bats_ai/core/migrations/0035_add_grtscells_centroid_4326.py
+++ b/bats_ai/core/migrations/0035_add_grtscells_centroid_4326.py
@@ -1,6 +1,7 @@
 from __future__ import annotations
 
-from django.db import migrations, models
+from django.contrib.gis.db import models
+from django.db import migrations
 
 
 def backfill_centroids(apps, schema_editor) -> None:

From fa658be80f6c78b5424cdc1ae193706487ef1df3 Mon Sep 17 00:00:00 2001
From: Bryon Lewis <Bryon.Lewis@kitware.com>
Date: Wed, 25 Mar 2026 12:50:31 -0400
Subject: [PATCH 03/21] initial map view

---
 client/package-lock.json                      | 239 ++++++++++++-
 client/package.json                           |   1 +
 client/src/api/api.ts                         |  29 ++
 .../src/components/RecordingLocationsMap.vue  | 271 +++++++++++++++
 client/src/components/RecordingTable.vue      |  63 +---
 client/src/main.ts                            |   1 +
 client/src/views/Recordings.vue               | 317 ++++++++++++------
 7 files changed, 761 insertions(+), 160 deletions(-)
 create mode 100644 client/src/components/RecordingLocationsMap.vue

diff --git a/client/package-lock.json b/client/package-lock.json
index 2de6a2f0..325b208e 100644
--- a/client/package-lock.json
+++ b/client/package-lock.json
@@ -19,6 +19,7 @@
         "django-s3-file-field": "1.1.0",
         "geojs": "1.19.0",
         "lodash": "4.17.23",
+        "maplibre-gl": "^5.21.1",
         "vue": "3.5.30",
         "vue-router": "5.0.4",
         "vuetify": "3.12.3"
@@ -1873,6 +1874,111 @@
         "node": ">=v12.0.0"
       }
     },
+    "node_modules/@mapbox/jsonlint-lines-primitives": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/@mapbox/jsonlint-lines-primitives/-/jsonlint-lines-primitives-2.0.2.tgz",
+      "integrity": "sha512-rY0o9A5ECsTQRVhv7tL/OyDpGAoUB4tTvLiW1DSzQGq4bvTPhNw1VpSNjDJc5GFZ2XuyOtSWSVN05qOtcD71qQ==",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/@mapbox/point-geometry": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/@mapbox/point-geometry/-/point-geometry-1.1.0.tgz",
+      "integrity": "sha512-YGcBz1cg4ATXDCM/71L9xveh4dynfGmcLDqufR+nQQy3fKwsAZsWd/x4621/6uJaeB9mwOHE6hPeDgXz9uViUQ==",
+      "license": "ISC"
+    },
+    "node_modules/@mapbox/tiny-sdf": {
+      "version": "2.0.7",
+      "resolved": "https://registry.npmjs.org/@mapbox/tiny-sdf/-/tiny-sdf-2.0.7.tgz",
+      "integrity": "sha512-25gQLQMcpivjOSA40g3gO6qgiFPDpWRoMfd+G/GoppPIeP6JDaMMkMrEJnMZhKyyS6iKwVt5YKu02vCUyJM3Ug==",
+      "license": "BSD-2-Clause"
+    },
+    "node_modules/@mapbox/unitbezier": {
+      "version": "0.0.1",
+      "resolved": "https://registry.npmjs.org/@mapbox/unitbezier/-/unitbezier-0.0.1.tgz",
+      "integrity": "sha512-nMkuDXFv60aBr9soUG5q+GvZYL+2KZHVvsqFCzqnkGEf46U2fvmytHaEVc1/YZbiLn8X+eR3QzX1+dwDO1lxlw==",
+      "license": "BSD-2-Clause"
+    },
+    "node_modules/@mapbox/vector-tile": {
+      "version": "2.0.4",
+      "resolved": "https://registry.npmjs.org/@mapbox/vector-tile/-/vector-tile-2.0.4.tgz",
+      "integrity": "sha512-AkOLcbgGTdXScosBWwmmD7cDlvOjkg/DetGva26pIRiZPdeJYjYKarIlb4uxVzi6bwHO6EWH82eZ5Nuv4T5DUg==",
+      "license": "BSD-3-Clause",
+      "dependencies": {
+        "@mapbox/point-geometry": "~1.1.0",
+        "@types/geojson": "^7946.0.16",
+        "pbf": "^4.0.1"
+      }
+    },
+    "node_modules/@mapbox/whoots-js": {
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/@mapbox/whoots-js/-/whoots-js-3.1.0.tgz",
+      "integrity": "sha512-Es6WcD0nO5l+2BOQS4uLfNPYQaNDfbot3X1XUoloz+x0mPDS3eeORZJl06HXjwBG1fOGwCRnzK88LMdxKRrd6Q==",
+      "license": "ISC",
+      "engines": {
+        "node": ">=6.0.0"
+      }
+    },
+    "node_modules/@maplibre/geojson-vt": {
+      "version": "6.0.4",
+      "resolved": "https://registry.npmjs.org/@maplibre/geojson-vt/-/geojson-vt-6.0.4.tgz",
+      "integrity": "sha512-HYv3POhMRCdhP3UPPATM/hfcy6/WuVIf5FKboH8u/ZuFMTnAIcSVlq5nfOqroLokd925w2QtE7YwquFOIacwVQ==",
+      "license": "ISC",
+      "dependencies": {
+        "kdbush": "^4.0.2"
+      }
+    },
+    "node_modules/@maplibre/maplibre-gl-style-spec": {
+      "version": "24.7.0",
+      "resolved": "https://registry.npmjs.org/@maplibre/maplibre-gl-style-spec/-/maplibre-gl-style-spec-24.7.0.tgz",
+      "integrity": "sha512-Ed7rcKYU5iELfablg9Mj+TVCsXsPBgdMyXPRAxb2v7oWg9YJnpQdZ5msDs1LESu/mtXy3Z48Vdppv2t/x5kAhw==",
+      "license": "ISC",
+      "dependencies": {
+        "@mapbox/jsonlint-lines-primitives": "~2.0.2",
+        "@mapbox/unitbezier": "^0.0.1",
+        "json-stringify-pretty-compact": "^4.0.0",
+        "minimist": "^1.2.8",
+        "quickselect": "^3.0.0",
+        "rw": "^1.3.3",
+        "tinyqueue": "^3.0.0"
+      },
+      "bin": {
+        "gl-style-format": "dist/gl-style-format.mjs",
+        "gl-style-migrate": "dist/gl-style-migrate.mjs",
+        "gl-style-validate": "dist/gl-style-validate.mjs"
+      }
+    },
+    "node_modules/@maplibre/mlt": {
+      "version": "1.1.8",
+      "resolved": "https://registry.npmjs.org/@maplibre/mlt/-/mlt-1.1.8.tgz",
+      "integrity": "sha512-8vtfYGidr1rNkv5IwIoU2lfe3Oy+Wa8HluzQYcQi9cveU9K3pweAal/poQj4GJ0K/EW4bTQp2wVAs09g2yDRZg==",
+      "license": "(MIT OR Apache-2.0)",
+      "dependencies": {
+        "@mapbox/point-geometry": "^1.1.0"
+      }
+    },
+    "node_modules/@maplibre/vt-pbf": {
+      "version": "4.3.0",
+      "resolved": "https://registry.npmjs.org/@maplibre/vt-pbf/-/vt-pbf-4.3.0.tgz",
+      "integrity": "sha512-jIvp8F5hQCcreqOOpEt42TJMUlsrEcpf/kI1T2v85YrQRV6PPXUcEXUg5karKtH6oh47XJZ4kHu56pUkOuqA7w==",
+      "license": "MIT",
+      "dependencies": {
+        "@mapbox/point-geometry": "^1.1.0",
+        "@mapbox/vector-tile": "^2.0.4",
+        "@maplibre/geojson-vt": "^5.0.4",
+        "@types/geojson": "^7946.0.16",
+        "@types/supercluster": "^7.1.3",
+        "pbf": "^4.0.1",
+        "supercluster": "^8.0.1"
+      }
+    },
+    "node_modules/@maplibre/vt-pbf/node_modules/@maplibre/geojson-vt": {
+      "version": "5.0.4",
+      "resolved": "https://registry.npmjs.org/@maplibre/geojson-vt/-/geojson-vt-5.0.4.tgz",
+      "integrity": "sha512-KGg9sma45S+stfH9vPCJk1J0lSDLWZgCT9Y8u8qWZJyjFlP8MNP1WGTxIMYJZjDvVT3PDn05kN1C95Sut1HpgQ==",
+      "license": "ISC"
+    },
     "node_modules/@mdi/font": {
       "version": "7.4.47",
       "resolved": "https://registry.npmjs.org/@mdi/font/-/font-7.4.47.tgz",
@@ -2133,9 +2239,6 @@
       "cpu": [
         "arm"
       ],
-      "libc": [
-        "glibc"
-      ],
       "license": "MIT",
       "optional": true,
       "os": [
@@ -2156,9 +2259,6 @@
       "cpu": [
         "arm"
       ],
-      "libc": [
-        "musl"
-      ],
       "license": "MIT",
       "optional": true,
       "os": [
@@ -2179,9 +2279,6 @@
       "cpu": [
         "arm64"
       ],
-      "libc": [
-        "glibc"
-      ],
       "license": "MIT",
       "optional": true,
       "os": [
@@ -2202,9 +2299,6 @@
       "cpu": [
         "arm64"
       ],
-      "libc": [
-        "musl"
-      ],
       "license": "MIT",
       "optional": true,
       "os": [
@@ -2225,9 +2319,6 @@
       "cpu": [
         "x64"
       ],
-      "libc": [
-        "glibc"
-      ],
       "license": "MIT",
       "optional": true,
       "os": [
@@ -2248,9 +2339,6 @@
       "cpu": [
         "x64"
       ],
-      "libc": [
-        "musl"
-      ],
       "license": "MIT",
       "optional": true,
       "os": [
@@ -3644,6 +3732,15 @@
       "integrity": "sha512-TC0dmN0K8YcWEAEfiPi5gJP14eJe30TTGjkvek3iM/1NdHHsdCA/Td6GvNndMOo/iSnIsZ4HuuhrYPDAmbxzww==",
       "license": "MIT"
     },
+    "node_modules/@types/supercluster": {
+      "version": "7.1.3",
+      "resolved": "https://registry.npmjs.org/@types/supercluster/-/supercluster-7.1.3.tgz",
+      "integrity": "sha512-Z0pOY34GDFl3Q6hUFYf3HkTwKEE02e7QgtJppBt+beEAxnyOpJua+voGFvxINBHa06GwLFFym7gRPY2SiKIfIA==",
+      "license": "MIT",
+      "dependencies": {
+        "@types/geojson": "*"
+      }
+    },
     "node_modules/@types/webxr": {
       "version": "0.5.24",
       "resolved": "https://registry.npmjs.org/@types/webxr/-/webxr-0.5.24.tgz",
@@ -6306,6 +6403,12 @@
       "dev": true,
       "license": "MIT"
     },
+    "node_modules/json-stringify-pretty-compact": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/json-stringify-pretty-compact/-/json-stringify-pretty-compact-4.0.0.tgz",
+      "integrity": "sha512-3CNZ2DnrpByG9Nqj6Xo8vqbjT4F6N+tb4Gb28ESAZjYZ5yqvmc56J+/kuIwkaAMOyblTQhUW7PxMkUb8Q36N3Q==",
+      "license": "MIT"
+    },
     "node_modules/json5": {
       "version": "2.2.3",
       "resolved": "https://registry.npmjs.org/json5/-/json5-2.2.3.tgz",
@@ -6679,6 +6782,46 @@
         "url": "https://github.com/sponsors/sxzz"
       }
     },
+    "node_modules/maplibre-gl": {
+      "version": "5.21.1",
+      "resolved": "https://registry.npmjs.org/maplibre-gl/-/maplibre-gl-5.21.1.tgz",
+      "integrity": "sha512-zto1RTnFkOpOO1bm93ElCXF1huey2N4LvXaGLMFcYAu9txh0OhGIdX1q3LZLkrMKgMxMeYduaQo+DVNzg098fg==",
+      "license": "BSD-3-Clause",
+      "dependencies": {
+        "@mapbox/jsonlint-lines-primitives": "^2.0.2",
+        "@mapbox/point-geometry": "^1.1.0",
+        "@mapbox/tiny-sdf": "^2.0.7",
+        "@mapbox/unitbezier": "^0.0.1",
+        "@mapbox/vector-tile": "^2.0.4",
+        "@mapbox/whoots-js": "^3.1.0",
+        "@maplibre/geojson-vt": "^6.0.4",
+        "@maplibre/maplibre-gl-style-spec": "^24.7.0",
+        "@maplibre/mlt": "^1.1.8",
+        "@maplibre/vt-pbf": "^4.3.0",
+        "@types/geojson": "^7946.0.16",
+        "earcut": "^3.0.2",
+        "gl-matrix": "^3.4.4",
+        "kdbush": "^4.0.2",
+        "murmurhash-js": "^1.0.0",
+        "pbf": "^4.0.1",
+        "potpack": "^2.1.0",
+        "quickselect": "^3.0.0",
+        "tinyqueue": "^3.0.0"
+      },
+      "engines": {
+        "node": ">=16.14.0",
+        "npm": ">=8.1.0"
+      },
+      "funding": {
+        "url": "https://github.com/maplibre/maplibre-gl-js?sponsor=1"
+      }
+    },
+    "node_modules/maplibre-gl/node_modules/gl-matrix": {
+      "version": "3.4.4",
+      "resolved": "https://registry.npmjs.org/gl-matrix/-/gl-matrix-3.4.4.tgz",
+      "integrity": "sha512-latSnyDNt/8zYUB6VIJ6PCh2jBjJX6gnDsoCZ7LyW7GkqrD51EWwa9qCoGixj8YqBtETQK/xY7OmpTF8xz1DdQ==",
+      "license": "MIT"
+    },
     "node_modules/math-intrinsics": {
       "version": "1.1.0",
       "resolved": "https://registry.npmjs.org/math-intrinsics/-/math-intrinsics-1.1.0.tgz",
@@ -6853,6 +6996,12 @@
       "integrity": "sha512-VNTrAak/KhO2i8dqqnqnAHOa3cYBwXEZe9h+D5h/1ZqFSTEFHdM65lR7RoIqq3tBBYavsOXV84NoHXZ0AkPyqQ==",
       "license": "MIT"
     },
+    "node_modules/murmurhash-js": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/murmurhash-js/-/murmurhash-js-1.0.0.tgz",
+      "integrity": "sha512-TvmkNhkv8yct0SVBSy+o8wYzXjE4Zz3PCesbfs8HiCXXdcTuocApFv11UWlNFWKYsP2okqrhb7JNlSm9InBhIw==",
+      "license": "MIT"
+    },
     "node_modules/nanoid": {
       "version": "3.3.11",
       "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-3.3.11.tgz",
@@ -7117,6 +7266,18 @@
       "integrity": "sha512-WUjGcAqP1gQacoQe+OBJsFA7Ld4DyXuUIjZ5cc75cLHvJ7dtNsTugphxIADwspS+AraAUePCKrSVtPLFj/F88w==",
       "license": "MIT"
     },
+    "node_modules/pbf": {
+      "version": "4.0.1",
+      "resolved": "https://registry.npmjs.org/pbf/-/pbf-4.0.1.tgz",
+      "integrity": "sha512-SuLdBvS42z33m8ejRbInMapQe8n0D3vN/Xd5fmWM3tufNgRQFBpaW2YVJxQZV4iPNqb0vEFvssMEo5w9c6BTIA==",
+      "license": "BSD-3-Clause",
+      "dependencies": {
+        "resolve-protobuf-schema": "^2.1.0"
+      },
+      "bin": {
+        "pbf": "bin/pbf"
+      }
+    },
     "node_modules/perfect-debounce": {
       "version": "2.1.0",
       "resolved": "https://registry.npmjs.org/perfect-debounce/-/perfect-debounce-2.1.0.tgz",
@@ -7202,6 +7363,12 @@
       "optional": true,
       "peer": true
     },
+    "node_modules/potpack": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/potpack/-/potpack-2.1.0.tgz",
+      "integrity": "sha512-pcaShQc1Shq0y+E7GqJqvZj8DTthWV1KeHGdi0Z6IAin2Oi3JnLCOfwnCo84qc+HAp52wT9nK9H7FAJp5a44GQ==",
+      "license": "ISC"
+    },
     "node_modules/prebuild-install": {
       "version": "7.1.3",
       "resolved": "https://registry.npmjs.org/prebuild-install/-/prebuild-install-7.1.3.tgz",
@@ -7262,6 +7429,12 @@
         "url": "https://github.com/sponsors/ahocevar"
       }
     },
+    "node_modules/protocol-buffers-schema": {
+      "version": "3.6.0",
+      "resolved": "https://registry.npmjs.org/protocol-buffers-schema/-/protocol-buffers-schema-3.6.0.tgz",
+      "integrity": "sha512-TdDRD+/QNdrCGCE7v8340QyuXd4kIWIgapsE2+n/SaGiSSbomYl4TjHlvIoCWRpE7wFt02EpB35VVA2ImcBVqw==",
+      "license": "MIT"
+    },
     "node_modules/proxy-from-env": {
       "version": "1.1.0",
       "resolved": "https://registry.npmjs.org/proxy-from-env/-/proxy-from-env-1.1.0.tgz",
@@ -7325,6 +7498,12 @@
       ],
       "license": "MIT"
     },
+    "node_modules/quickselect": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/quickselect/-/quickselect-3.0.0.tgz",
+      "integrity": "sha512-XdjUArbK4Bm5fLLvlm5KpTFOiOThgfWWI4axAZDWg4E/0mKdZyI9tNEfds27qCi1ze/vwTR16kvmmGhRra3c2g==",
+      "license": "ISC"
+    },
     "node_modules/rc": {
       "version": "1.2.8",
       "resolved": "https://registry.npmjs.org/rc/-/rc-1.2.8.tgz",
@@ -7473,6 +7652,15 @@
         "url": "https://github.com/sponsors/ljharb"
       }
     },
+    "node_modules/resolve-protobuf-schema": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/resolve-protobuf-schema/-/resolve-protobuf-schema-2.1.0.tgz",
+      "integrity": "sha512-kI5ffTiZWmJaS/huM8wZfEMer1eRd7oJQhDuxeCLe3t7N7mX3z94CN0xPxBQxFYQTSNz9T0i+v6inKqSdK8xrQ==",
+      "license": "MIT",
+      "dependencies": {
+        "protocol-buffers-schema": "^3.3.1"
+      }
+    },
     "node_modules/reusify": {
       "version": "1.1.0",
       "resolved": "https://registry.npmjs.org/reusify/-/reusify-1.1.0.tgz",
@@ -7848,6 +8036,15 @@
         "safe-buffer": "~5.2.0"
       }
     },
+    "node_modules/supercluster": {
+      "version": "8.0.1",
+      "resolved": "https://registry.npmjs.org/supercluster/-/supercluster-8.0.1.tgz",
+      "integrity": "sha512-IiOea5kJ9iqzD2t7QJq/cREyLHTtSmUT6gQsweojg9WH2sYJqZK9SswTu6jrscO6D1G5v5vYZ9ru/eq85lXeZQ==",
+      "license": "ISC",
+      "dependencies": {
+        "kdbush": "^4.0.2"
+      }
+    },
     "node_modules/supports-preserve-symlinks-flag": {
       "version": "1.0.0",
       "resolved": "https://registry.npmjs.org/supports-preserve-symlinks-flag/-/supports-preserve-symlinks-flag-1.0.0.tgz",
@@ -7905,6 +8102,12 @@
         "url": "https://github.com/sponsors/SuperchupuDev"
       }
     },
+    "node_modules/tinyqueue": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/tinyqueue/-/tinyqueue-3.0.0.tgz",
+      "integrity": "sha512-gRa9gwYU3ECmQYv3lslts5hxuIa90veaEcxDYuu3QGOIAEM2mOZkVHp48ANJuu1CURtRdHKUBY5Lm1tHV+sD4g==",
+      "license": "ISC"
+    },
     "node_modules/to-regex-range": {
       "version": "5.0.1",
       "resolved": "https://registry.npmjs.org/to-regex-range/-/to-regex-range-5.0.1.tgz",
diff --git a/client/package.json b/client/package.json
index 5a306b27..80a80ac1 100644
--- a/client/package.json
+++ b/client/package.json
@@ -24,6 +24,7 @@
     "django-s3-file-field": "1.1.0",
     "geojs": "1.19.0",
     "lodash": "4.17.23",
+    "maplibre-gl": "^5.21.1",
     "vue": "3.5.30",
     "vue-router": "5.0.4",
     "vuetify": "3.12.3"
diff --git a/client/src/api/api.ts b/client/src/api/api.ts
index e646bbc7..658f60bb 100644
--- a/client/src/api/api.ts
+++ b/client/src/api/api.ts
@@ -1,6 +1,7 @@
 import axios from "axios";
 import { AxiosError } from "axios";
 import { SpectroInfo } from "@components/geoJS/geoJSUtils";
+import type { FeatureCollection, Point } from "geojson";
 
 export interface Recording {
   id: number;
@@ -31,6 +32,13 @@ export interface Recording {
   tags_text?: string[];
 }
 
+export type RecordingLocationsFeatureProperties = {
+  recording_id: number;
+  filename: string;
+};
+
+export type RecordingLocationsGeoJson = FeatureCollection<Point, RecordingLocationsFeatureProperties>;
+
 export interface Species {
   species_code: string;
   family: string;
@@ -455,6 +463,26 @@ async function getCellBbox(cellId: number) {
   return await axiosInstance.get<GRTSCellBbox>(`/grts/${cellId}/bbox`);
 }
 
+export interface RecordingLocationsParams {
+  exclude_submitted?: boolean;
+  /** Comma-separated or array of tag texts; recording must have all listed tags. */
+  tags?: string | string[];
+  /** Bounding box filter (lon/lat) as `[min_lon, min_lat, max_lon, max_lat]`. */
+  bbox?: [number, number, number, number];
+}
+
+async function getRecordingLocations(params?: RecordingLocationsParams) {
+  const query = new URLSearchParams();
+  if (params?.exclude_submitted !== undefined) query.set("exclude_submitted", String(params.exclude_submitted));
+  if (params?.tags !== undefined) {
+    const tagStr = Array.isArray(params.tags) ? params.tags.join(",") : params.tags;
+    if (tagStr) query.set("tags", tagStr);
+  }
+  if (params?.bbox) query.set("bbox", JSON.stringify(params.bbox));
+  const qs = query.toString();
+  return axiosInstance.get<RecordingLocationsGeoJson>(`/recording-locations/${qs ? `?${qs}` : ""}`);
+}
+
 async function getFileAnnotations(recordingId: number) {
   return axiosInstance.get<FileAnnotation[]>(`recording/${recordingId}/recording-annotations`);
 }
@@ -706,6 +734,7 @@ export {
   getCellLocation,
   getCellBbox,
   getCellfromLocation,
+  getRecordingLocations,
   getGuanoMetadata,
   getFileAnnotations,
   putFileAnnotation,
diff --git a/client/src/components/RecordingLocationsMap.vue b/client/src/components/RecordingLocationsMap.vue
new file mode 100644
index 00000000..2d3adbca
--- /dev/null
+++ b/client/src/components/RecordingLocationsMap.vue
@@ -0,0 +1,271 @@
+<script lang="ts">
+import maplibregl, { type GeoJSONSource, type Map } from 'maplibre-gl';
+import { defineComponent, onBeforeUnmount, onMounted, ref, watch, type PropType } from 'vue';
+import { getRecordingLocations, type RecordingLocationsGeoJson } from '@api/api';
+
+export default defineComponent({
+  name: 'RecordingLocationsMap',
+  props: {
+    height: {
+      type: [Number, String] as PropType<number | string>,
+      default: 600,
+    },
+    tags: {
+      type: Array as PropType<string[]>,
+      default: () => [],
+    },
+    excludeSubmitted: {
+      type: Boolean,
+      default: false,
+    },
+    resizeTick: {
+      type: Number,
+      default: 0,
+    },
+  },
+  setup(props) {
+    const mapContainer = ref<HTMLDivElement | null>(null);
+    const mapRef = ref<Map | null>(null);
+    const loading = ref(false);
+    const error = ref<string | null>(null);
+
+    async function loadGeoJson(): Promise<RecordingLocationsGeoJson> {
+      const res = await getRecordingLocations({
+        exclude_submitted: props.excludeSubmitted ? true : undefined,
+        tags: props.tags.length ? props.tags : undefined,
+      });
+      return res.data;
+    }
+
+    async function refreshSource() {
+      if (!mapRef.value) return;
+      const src = mapRef.value.getSource('recording-locations') as GeoJSONSource | undefined;
+      if (!src) return;
+      loading.value = true;
+      error.value = null;
+      try {
+        const data = await loadGeoJson();
+        src.setData(data as unknown as GeoJSON.GeoJSON);
+      } catch (e) {
+        error.value = e instanceof Error ? e.message : String(e);
+      } finally {
+        loading.value = false;
+      }
+    }
+
+    onMounted(async () => {
+      if (!mapContainer.value) return;
+
+      // Center roughly on the continental US.
+      const map = new maplibregl.Map({
+        container: mapContainer.value,
+        style: {
+          version: 8,
+          sources: {
+            osm: {
+              type: 'raster',
+              tiles: ['https://tile.openstreetmap.org/{z}/{x}/{y}.png'],
+              tileSize: 256,
+              attribution: '&copy; OpenStreetMap contributors',
+            },
+          },
+          layers: [
+            {
+              id: 'osm',
+              type: 'raster',
+              source: 'osm',
+            },
+          ],
+        },
+        center: [-98.5795, 39.8283],
+        zoom: 3,
+        fadeDuration: 0,
+      });
+      mapRef.value = map;
+
+      map.addControl(new maplibregl.NavigationControl(), 'top-right');
+
+      map.on('load', async () => {
+        loading.value = true;
+        error.value = null;
+        try {
+          const data = await loadGeoJson();
+
+          map.addSource('recording-locations', {
+            type: 'geojson',
+            data: data as unknown as GeoJSON.GeoJSON,
+            cluster: true,
+            clusterMaxZoom: 14,
+            clusterRadius: 50,
+          });
+
+          map.addLayer({
+            id: 'clusters',
+            type: 'circle',
+            source: 'recording-locations',
+            filter: ['has', 'point_count'],
+            paint: {
+              'circle-color': [
+                'step',
+                ['get', 'point_count'],
+                '#51bbd6',
+                100,
+                '#f1f075',
+                750,
+                '#f28cb1',
+              ],
+              'circle-radius': [
+                'step',
+                ['get', 'point_count'],
+                20,
+                100,
+                30,
+                750,
+                40,
+              ],
+              'circle-stroke-width': 1,
+              'circle-stroke-color': '#ffffff',
+            },
+          });
+
+          map.addLayer({
+            id: 'cluster-count',
+            type: 'symbol',
+            source: 'recording-locations',
+            filter: ['has', 'point_count'],
+            layout: {
+              'text-field': '{point_count_abbreviated}',
+              'text-size': 12,
+            },
+            paint: {
+              'text-color': '#0b1f2a',
+            },
+          });
+
+          map.addLayer({
+            id: 'unclustered-point',
+            type: 'circle',
+            source: 'recording-locations',
+            filter: ['!', ['has', 'point_count']],
+            paint: {
+              'circle-color': '#11b4da',
+              'circle-radius': 5,
+              'circle-stroke-width': 1,
+              'circle-stroke-color': '#fff',
+            },
+          });
+
+          map.on('click', 'clusters', async (e) => {
+            const features = map.queryRenderedFeatures(e.point, { layers: ['clusters'] });
+            const f = features?.[0];
+            if (!f) return;
+            const clusterId = (f.properties as Record<string, unknown>)?.cluster_id as number | undefined;
+            if (clusterId === undefined) return;
+            const source = map.getSource('recording-locations') as GeoJSONSource;
+            const zoom = await source.getClusterExpansionZoom(clusterId);
+            const coords = (f.geometry as GeoJSON.Point).coordinates as [number, number];
+            map.easeTo({ center: coords, zoom });
+          });
+
+          map.on('click', 'unclustered-point', (e) => {
+            const f = e.features?.[0];
+            if (!f) return;
+            const coords = (f.geometry as GeoJSON.Point).coordinates.slice() as [number, number];
+            const props = (f.properties ?? {}) as Record<string, unknown>;
+            const recordingId = props.recording_id ?? '';
+            const filename = props.filename ?? '';
+
+            new maplibregl.Popup()
+              .setLngLat(coords)
+              .setHTML(
+                `<div style="font-size: 12px;">
+                  <div><b>Recording ID:</b> ${recordingId}</div>
+                  <div style="word-break: break-word;"><b>File:</b> ${filename}</div>
+                </div>`
+              )
+              .addTo(map);
+          });
+
+          map.on('mouseenter', 'clusters', () => (map.getCanvas().style.cursor = 'pointer'));
+          map.on('mouseleave', 'clusters', () => (map.getCanvas().style.cursor = ''));
+          map.on('mouseenter', 'unclustered-point', () => (map.getCanvas().style.cursor = 'pointer'));
+          map.on('mouseleave', 'unclustered-point', () => (map.getCanvas().style.cursor = ''));
+        } catch (e) {
+          error.value = e instanceof Error ? e.message : String(e);
+        } finally {
+          loading.value = false;
+        }
+      });
+    });
+
+    watch(
+      () => [props.tags.join(','), props.excludeSubmitted] as const,
+      async () => {
+        await refreshSource();
+      }
+    );
+
+    watch(
+      () => props.resizeTick,
+      () => {
+        mapRef.value?.resize();
+      }
+    );
+
+    onBeforeUnmount(() => {
+      mapRef.value?.remove();
+      mapRef.value = null;
+    });
+
+    return { mapContainer, loading, error };
+  },
+});
+</script>
+
+<template>
+  <div class="recording-locations-map-root">
+    <div
+      ref="mapContainer"
+      class="recording-locations-map"
+      :style="{ height: typeof height === 'number' ? `${height}px` : height }"
+    />
+    <div
+      v-if="loading"
+      class="status-overlay"
+    >
+      Loading locations…
+    </div>
+    <div
+      v-else-if="error"
+      class="status-overlay error"
+    >
+      {{ error }}
+    </div>
+  </div>
+</template>
+
+<style scoped>
+.recording-locations-map-root {
+  position: relative;
+  width: 100%;
+}
+.recording-locations-map {
+  width: 100%;
+  border-radius: 8px;
+  overflow: hidden;
+}
+.status-overlay {
+  position: absolute;
+  left: 12px;
+  bottom: 12px;
+  padding: 8px 10px;
+  border-radius: 8px;
+  background: rgba(0, 0, 0, 0.65);
+  color: white;
+  font-size: 12px;
+}
+.status-overlay.error {
+  background: rgba(120, 0, 0, 0.75);
+}
+</style>
+
diff --git a/client/src/components/RecordingTable.vue b/client/src/components/RecordingTable.vue
index 56fa8e3d..1b232da7 100644
--- a/client/src/components/RecordingTable.vue
+++ b/client/src/components/RecordingTable.vue
@@ -9,7 +9,6 @@ import {
   type PropType,
 } from 'vue';
 import { getRecordings, type Recording, type FileAnnotation, type RecordingListParams } from '../api/api';
-import MapLocation from '@components/MapLocation.vue';
 import RecordingInfoDisplay from '@components/RecordingInfoDisplay.vue';
 import RecordingAnnotationSummary from '@components/RecordingAnnotationSummary.vue';
 import useState from '@use/useState';
@@ -27,7 +26,6 @@ export interface RecordingTableHeader {
 export default defineComponent({
   name: 'RecordingTable',
   components: {
-    MapLocation,
     RecordingInfoDisplay,
     RecordingAnnotationSummary,
   },
@@ -36,6 +34,10 @@ export default defineComponent({
       type: String as PropType<'my' | 'shared'>,
       required: true,
     },
+    tags: {
+      type: Array as PropType<string[] | undefined>,
+      default: undefined,
+    },
     editRecording: {
       type: Function as PropType<(item: Recording) => void>,
       default: undefined,
@@ -45,8 +47,8 @@ export default defineComponent({
       default: undefined,
     },
   },
-  emits: [],
-  setup(props, { expose }) {
+  emits: ['update:tags'],
+  setup(props, { emit, expose }) {
     const {
       configuration,
       showSubmittedRecordings,
@@ -66,13 +68,17 @@ export default defineComponent({
     let intervalRef: number | null = null;
 
     const filterTagsModel = computed({
-      get: () => (props.variant === 'my' ? filterTags.value : sharedFilterTags.value),
+      get: () => {
+        if (props.tags !== undefined) return props.tags;
+        return props.variant === 'my' ? filterTags.value : sharedFilterTags.value;
+      },
       set: (v: string[]) => {
-        if (props.variant === 'my') {
-          filterTags.value = v;
-        } else {
-          sharedFilterTags.value = v;
+        if (props.tags !== undefined) {
+          emit('update:tags', v);
+          return;
         }
+        if (props.variant === 'my') filterTags.value = v;
+        else sharedFilterTags.value = v;
       },
     });
 
@@ -330,15 +336,6 @@ export default defineComponent({
 
     const tableClass = computed(() => (props.variant === 'my' ? 'my-recordings' : 'shared-recordings'));
 
-    const listStyles = computed(() => {
-      const markEnabled = configuration.value.mark_annotations_completed_enabled;
-      let sectionHeight = markEnabled ? '35vh' : '40vh';
-      if (props.variant === 'shared' && !configuration.value.is_admin && !configuration.value.non_admin_upload_enabled) {
-        sectionHeight = '75vh';
-      }
-      return { height: sectionHeight, 'max-height': sectionHeight };
-    });
-
     const showTotalCount = computed(() => (
       totalCount.value > 0
       && configuration.value.mark_annotations_completed_enabled
@@ -379,7 +376,6 @@ export default defineComponent({
       onUpdateOptions,
       onUpdateSortBy,
       tableClass,
-      listStyles,
       showTotalCount,
       rawHeaders,
       isColumnVisible,
@@ -402,7 +398,6 @@ export default defineComponent({
     density="compact"
     class="elevation-1"
     :class="tableClass"
-    :style="listStyles"
     @update:options="onUpdateOptions"
     @update:sort-by="onUpdateSortBy"
   >
@@ -518,33 +513,7 @@ export default defineComponent({
     </template>
 
     <template #item.grts_cell_id="{ item }">
-      <span class="d-flex align-center gap-1">
-        <div>{{ item.grts_cell_id ?? '—' }}</div>
-        <v-menu
-          v-if="item.recording_location || (configuration.mark_annotations_completed_enabled && item.grts_cell_id)"
-          open-on-hover
-          :close-on-content-click="false"
-        >
-          <template #activator="{ props }">
-            <v-icon 
-              v-bind="props" 
-              color="primary" 
-              class="ml-2"
-              size="x-large"
-            >
-              mdi-map
-            </v-icon>
-          </template>
-          <v-card>
-            <map-location
-              :editor="false"
-              :size="{ width: 400, height: 400 }"
-              :location="getItemLocation(item)"
-              :grts-cell-id="configuration.mark_annotations_completed_enabled ? item.grts_cell_id || undefined : undefined"
-            />
-          </v-card>
-        </v-menu>
-      </span>
+      {{ item.grts_cell_id ?? '—' }}
     </template>
 
     <template #item.comments="{ item }">
diff --git a/client/src/main.ts b/client/src/main.ts
index deaa831b..ed7aede8 100644
--- a/client/src/main.ts
+++ b/client/src/main.ts
@@ -1,4 +1,5 @@
 import '@mdi/font/css/materialdesignicons.css';
+import 'maplibre-gl/dist/maplibre-gl.css';
 import 'vuetify/styles';
 import * as Sentry from '@sentry/vue';
 import { createApp, } from 'vue';
diff --git a/client/src/views/Recordings.vue b/client/src/views/Recordings.vue
index 3007cc48..4efc31ec 100644
--- a/client/src/views/Recordings.vue
+++ b/client/src/views/Recordings.vue
@@ -1,19 +1,30 @@
 <script lang="ts">
-import { defineComponent, ref, Ref, onMounted } from 'vue';
+import { computed, defineComponent, ref, Ref, onMounted, watch } from 'vue';
 import { deleteRecording, Recording, getRecordingTags } from '../api/api';
 import UploadRecording, { EditingRecording } from '@components/UploadRecording.vue';
 import useState from '@use/useState';
 import BatchUploadRecording from '@components/BatchUploadRecording.vue';
 import RecordingTable from '@components/RecordingTable.vue';
+import RecordingLocationsMap from '@components/RecordingLocationsMap.vue';
 
 export default defineComponent({
   components: {
     UploadRecording,
     BatchUploadRecording,
     RecordingTable,
+    RecordingLocationsMap,
   },
   setup() {
-    const { configuration, showSubmittedRecordings, recordingTagList } = useState();
+    const {
+      configuration,
+      showSubmittedRecordings,
+      recordingTagList,
+      filterTags,
+      sharedFilterTags,
+      saveFilterTags,
+    } = useState();
+    const showMap = ref(false);
+    const mapResizeTick = ref(0);
     const editingRecording: Ref<EditingRecording | null> = ref(null);
     const uploadDialog = ref(false);
     const batchUploadDialog = ref(false);
@@ -76,9 +87,29 @@ export default defineComponent({
       fetchRecordingTags();
     });
 
+    const showMyTable = computed(() => configuration.value.is_admin || configuration.value.non_admin_upload_enabled);
+    const visibleTablesCount = computed(() => (showMyTable.value ? 1 : 0) + 1);
+    const mapHeight = computed(() => (visibleTablesCount.value === 1 ? '33vh' : '25vh'));
+
+    function setUnifiedTags(v: string[]) {
+      filterTags.value = v;
+      sharedFilterTags.value = v;
+      saveFilterTags();
+    }
+
+    watch(showMap, (open) => {
+      if (open) mapResizeTick.value += 1;
+    });
+
     return {
       configuration,
       showSubmittedRecordings,
+      showMap,
+      showMyTable,
+      mapHeight,
+      mapResizeTick,
+      filterTags,
+      setUnifiedTags,
       uploadDialog,
       batchUploadDialog,
       deleteDialogOpen,
@@ -95,112 +126,208 @@ export default defineComponent({
 </script>
 
 <template>
-  <v-card>
-    <v-card-title>
-      <v-row>
-        <div v-if="configuration.is_admin || configuration.non_admin_upload_enabled">
-          My Recordings
-        </div>
-        <v-spacer />
-        <div class="d-flex justify-center align-center">
-          <v-checkbox
-            v-model="showSubmittedRecordings"
-            class="mr-4"
-            label="Show recordings with submitted annotations"
-            hide-details
-          />
-          <v-menu v-if="configuration.is_admin || configuration.non_admin_upload_enabled">
-            <template #activator="{ props }">
+  <div class="recordings-scroll">
+    <v-card>
+      <v-card-title>
+        <v-row>
+          <div v-if="showMyTable">
+            My Recordings
+          </div>
+          <v-spacer />
+          <div class="d-flex justify-center align-center">
+            <v-checkbox
+              v-model="showSubmittedRecordings"
+              class="mr-4"
+              label="Show recordings with submitted annotations"
+              hide-details
+            />
+            <v-switch
+              v-model="showMap"
+              class="mr-4"
+              inset
+              density="compact"
+              label="Map"
+              hide-details
+            />
+            <v-menu v-if="showMyTable">
+              <template #activator="{ props }">
+                <v-btn
+                  color="primary"
+                  v-bind="props"
+                >
+                  Upload <v-icon>mdi-chevron-down</v-icon>
+                </v-btn>
+              </template>
+              <v-list>
+                <v-list-item @click="uploadDialog = true">
+                  <v-list-item-title>Upload Recording</v-list-item-title>
+                </v-list-item>
+                <v-list-item @click="batchUploadDialog = true">
+                  <v-list-item-title>Batch Upload</v-list-item-title>
+                </v-list-item>
+              </v-list>
+            </v-menu>
+          </div>
+        </v-row>
+      </v-card-title>
+      <v-card-text>
+        <v-expand-transition>
+          <v-card
+            v-if="showMap"
+            class="mb-3"
+          >
+            <v-card-text>
+              <RecordingLocationsMap
+                :class="{ 'map-with-my-files': showMap && showMyTable, 'map-with-shared-files': showMap && !showMyTable, 'map-alone': !showMap && !showMyTable }"
+                :height="mapHeight"
+                :tags="filterTags"
+                :exclude-submitted="configuration.mark_annotations_completed_enabled && !showSubmittedRecordings"
+                :resize-tick="mapResizeTick"
+              />
+            </v-card-text>
+          </v-card>
+        </v-expand-transition>
+
+        <v-dialog
+          v-model="deleteDialogOpen"
+          width="auto"
+        >
+          <v-card>
+            <v-card-title class="pa-4">
+              Delete {{ recordingToDelete?.name || 'this recording' }}?
+            </v-card-title>
+            <v-card-actions class="pa-4">
+              <v-btn
+                variant="flat"
+                @click="deleteDialogOpen = false"
+              >
+                Cancel
+              </v-btn>
               <v-btn
-                color="primary"
-                v-bind="props"
+                variant="flat"
+                color="error"
+                @click="deleteOneRecording()"
               >
-                Upload <v-icon>mdi-chevron-down</v-icon>
+                Delete
               </v-btn>
-            </template>
-            <v-list>
-              <v-list-item @click="uploadDialog = true">
-                <v-list-item-title>Upload Recording</v-list-item-title>
-              </v-list-item>
-              <v-list-item @click="batchUploadDialog = true">
-                <v-list-item-title>Batch Upload</v-list-item-title>
-              </v-list-item>
-            </v-list>
-          </v-menu>
-        </div>
-      </v-row>
-    </v-card-title>
-    <v-card-text>
+            </v-card-actions>
+          </v-card>
+        </v-dialog>
+        <recording-table
+          v-if="showMyTable"
+          ref="myRecordingsTableRef"
+          :class="{ 'my-files-with-map': showMap, 'my-files': !showMap }"
+          variant="my"
+          :tags="filterTags"
+          :edit-recording="editRecording"
+          :open-delete-recording-dialog="openDeleteRecordingDialog"
+          @update:tags="setUnifiedTags"
+        />
+      </v-card-text>
       <v-dialog
-        v-model="deleteDialogOpen"
-        width="auto"
+        v-model="uploadDialog"
+        width="700"
       >
-        <v-card>
-          <v-card-title class="pa-4">
-            Delete {{ recordingToDelete?.name || 'this recording' }}?
-          </v-card-title>
-          <v-card-actions class="pa-4">
-            <v-btn
-              variant="flat"
-              @click="deleteDialogOpen = false"
-            >
-              Cancel
-            </v-btn>
-            <v-btn
-              variant="flat"
-              color="error"
-              @click="deleteOneRecording()"
-            >
-              Delete
-            </v-btn>
-          </v-card-actions>
-        </v-card>
+        <upload-recording
+          :editing="editingRecording"
+          @done="uploadDone()"
+          @cancel="uploadDialog = false; editingRecording = null"
+        />
       </v-dialog>
-      <recording-table
-        v-if="configuration.is_admin || configuration.non_admin_upload_enabled"
-        ref="myRecordingsTableRef"
-        variant="my"
-        :edit-recording="editRecording"
-        :open-delete-recording-dialog="openDeleteRecordingDialog"
-      />
-    </v-card-text>
-    <v-dialog
-      v-model="uploadDialog"
-      width="700"
-    >
-      <upload-recording
-        :editing="editingRecording"
-        @done="uploadDone()"
-        @cancel="uploadDialog = false; editingRecording = null"
-      />
-    </v-dialog>
-    <v-dialog
-      v-model="batchUploadDialog"
-      width="700"
+      <v-dialog
+        v-model="batchUploadDialog"
+        width="700"
+      >
+        <batch-upload-recording
+          @done="uploadDone()"
+          @cancel="batchUploadDialog = false; editingRecording = null"
+        />
+      </v-dialog>
+    </v-card>
+    <v-card
+      class="mt-3"
+      :class="{
+        'shared-with-my-files': showMap && showMyTable,
+        'shared-dual-no-map': !showMap && showMyTable,
+        'shared-alone-with-map': showMap && !showMyTable,
+        'shared-alone': !showMap && !showMyTable,
+      }"
     >
-      <batch-upload-recording
-        @done="uploadDone()"
-        @cancel="batchUploadDialog = false; editingRecording = null"
-      />
-    </v-dialog>
-  </v-card>
-  <v-card>
-    <v-card-title>
-      <v-row class="py-2">
-        <div>Shared</div>
-      </v-row>
-    </v-card-title>
-    <v-card-text>
-      <recording-table variant="shared" />
-    </v-card-text>
-  </v-card>
+      <v-card-title>
+        <v-row class="py-2">
+          <div>Shared</div>
+        </v-row>
+      </v-card-title>
+      <v-card-text>
+        <recording-table
+          variant="shared"
+          :tags="filterTags"
+          @update:tags="setUnifiedTags"
+        />
+      </v-card-text>
+    </v-card>
+  </div>
 </template>
 
 <style scoped>
+.recordings-scroll {
+  max-height: calc(100vh - 64px);
+  overflow-y: auto;
+  padding-bottom: 16px;
+}
+
+/* My recordings: classes are on <recording-table> (merged onto v-data-table root). */
+:deep(.my-recordings.my-files) {
+  height: calc(40vh - 64px);
+  max-height: calc(40vh - 64px);
+}
+
+:deep(.my-recordings.my-files-with-map) {
+  height: calc(30vh - 64px);
+  max-height: calc(30vh - 64px);
+}
+
+/* Shared: layout classes are on the v-card; size the inner table. */
+.shared-with-my-files :deep(.shared-recordings) {
+  height: calc(30vh - 64px);
+  max-height: calc(30vh - 64px);
+}
+
+.shared-dual-no-map :deep(.shared-recordings) {
+  height: calc(40vh - 64px);
+  max-height: calc(40vh - 64px);
+}
+
+.shared-alone-with-map :deep(.shared-recordings) {
+  height: calc(50vh - 64px);
+  max-height: calc(50vh - 64px);
+}
+
+.shared-alone :deep(.shared-recordings) {
+  height: calc(100vh - 64px);
+  max-height: calc(100vh - 64px);
+}
+
+.map-with-my-files {
+  height: calc(35vh - 64px);
+  max-height: calc(35vh - 64px);
+}
+
+.map-with-shared-files {
+  height: calc(35vh - 64px);
+  max-height: calc(35vh - 64px);
+}
+
+.map-alone {
+  height: calc(50vh - 64px);
+  max-height: calc(50vh - 64px);
+}
+
 :deep(.my-recordings),
 :deep(.shared-recordings) {
-  overflow-y: scroll;
+  overflow-y: auto;
 }
+
 :deep(.my-recordings tr.current-recording-row),
 :deep(.shared-recordings tr.current-recording-row) {
   border: 2px solid rgb(var(--v-theme-primary));

From 813125ca8b5ba54f563707e80c9f02ba515d8f42 Mon Sep 17 00:00:00 2001
From: Bryon Lewis <Bryon.Lewis@kitware.com>
Date: Wed, 25 Mar 2026 13:33:41 -0400
Subject: [PATCH 04/21] filtering map locations

---
 bats_ai/core/views/recording.py               | 10 +++-
 client/src/api/api.ts                         |  9 +++
 .../src/components/RecordingLocationsMap.vue  | 59 ++++++++++++++++++-
 client/src/components/RecordingTable.vue      | 47 ++++++++++++++-
 client/src/views/Recordings.vue               | 33 +++++++++++
 5 files changed, 155 insertions(+), 3 deletions(-)

diff --git a/bats_ai/core/views/recording.py b/bats_ai/core/views/recording.py
index ee8ce7cc..1c3e27f2 100644
--- a/bats_ai/core/views/recording.py
+++ b/bats_ai/core/views/recording.py
@@ -6,7 +6,7 @@
 from typing import TYPE_CHECKING, Any, Literal
 
 from django.contrib.auth.models import User
-from django.contrib.gis.geos import Point
+from django.contrib.gis.geos import Point, Polygon
 from django.contrib.postgres.aggregates import ArrayAgg
 from django.core.files.storage import default_storage
 from django.db.models import Count, Exists, OuterRef, Prefetch, Q, QuerySet
@@ -28,6 +28,7 @@
     Spectrogram,
 )
 from bats_ai.core.tasks.tasks import recording_compute_spectrogram
+from bats_ai.core.views.recording_location import _parse_bbox
 from bats_ai.core.views.species import SpeciesSchema
 
 if TYPE_CHECKING:
@@ -62,6 +63,8 @@ class RecordingListQuerySchema(Schema):
     annotation_completed: bool | None = None
     search: str | None = None
     tags: str | None = None  # Comma-separated tag texts; recording must have all listed tags
+    # [min_lon, min_lat, max_lon, max_lat] as JSON array or comma-separated (see _parse_bbox).
+    bbox: str | None = None
     sort_by: (
         Literal["id", "name", "created", "modified", "recorded_date", "owner_username"] | None
     ) = "created"
@@ -517,6 +520,11 @@ def get_recordings(
                 queryset = queryset.filter(tags__text=tag)
             queryset = queryset.distinct()
 
+    if q.bbox and q.bbox.strip():
+        min_lon, min_lat, max_lon, max_lat = _parse_bbox(q.bbox)
+        bbox_poly = Polygon.from_bbox((min_lon, min_lat, max_lon, max_lat))
+        queryset = queryset.filter(recording_location__intersects=bbox_poly)
+
     sort_field = q.sort_by or "created"
     order_prefix = "" if q.sort_direction == "asc" else "-"
     if sort_field == "owner_username":
diff --git a/client/src/api/api.ts b/client/src/api/api.ts
index 658f60bb..3fa193d2 100644
--- a/client/src/api/api.ts
+++ b/client/src/api/api.ts
@@ -295,6 +295,8 @@ export interface RecordingListParams {
   sort_direction?: 'asc' | 'desc';
   page?: number;
   limit?: number;
+  /** WGS84 [minLon, minLat, maxLon, maxLat]; recordings must intersect this box. */
+  bbox?: [number, number, number, number];
 }
 
 /** Paginated recording list response (v-data-table-server compatible). */
@@ -323,6 +325,13 @@ async function getRecordings(getPublic = false, params?: RecordingListParams) {
     if (params.sort_direction) query.set('sort_direction', params.sort_direction);
     if (params.page !== undefined) query.set('page', String(params.page));
     if (params.limit !== undefined) query.set('limit', String(params.limit));
+    if (
+      params.bbox !== undefined &&
+      params.bbox.length === 4 &&
+      params.bbox.every((n) => Number.isFinite(n))
+    ) {
+      query.set('bbox', JSON.stringify(params.bbox));
+    }
   }
   if (!params?.page) query.set('page', '1');
   if (!params?.limit) query.set('limit', '20');
diff --git a/client/src/components/RecordingLocationsMap.vue b/client/src/components/RecordingLocationsMap.vue
index 2d3adbca..a89f39a1 100644
--- a/client/src/components/RecordingLocationsMap.vue
+++ b/client/src/components/RecordingLocationsMap.vue
@@ -5,6 +5,7 @@ import { getRecordingLocations, type RecordingLocationsGeoJson } from '@api/api'
 
 export default defineComponent({
   name: 'RecordingLocationsMap',
+  emits: ['boundsChange'],
   props: {
     height: {
       type: [Number, String] as PropType<number | string>,
@@ -22,12 +23,49 @@ export default defineComponent({
       type: Number,
       default: 0,
     },
+    /** When true, emit current map bounds (debounced on pan/zoom; immediate when enabled). */
+    reportBounds: {
+      type: Boolean,
+      default: false,
+    },
+    boundsDebounceMs: {
+      type: Number,
+      default: 1500,
+    },
   },
-  setup(props) {
+  setup(props, { emit }) {
     const mapContainer = ref<HTMLDivElement | null>(null);
     const mapRef = ref<Map | null>(null);
     const loading = ref(false);
     const error = ref<string | null>(null);
+    let boundsDebounceTimer: ReturnType<typeof setTimeout> | null = null;
+
+    function clearBoundsDebounce() {
+      if (boundsDebounceTimer !== null) {
+        clearTimeout(boundsDebounceTimer);
+        boundsDebounceTimer = null;
+      }
+    }
+
+    function emitCurrentBounds() {
+      if (!props.reportBounds || !mapRef.value) return;
+      const b = mapRef.value.getBounds();
+      emit('boundsChange', [b.getWest(), b.getSouth(), b.getEast(), b.getNorth()] as [
+        number,
+        number,
+        number,
+        number,
+      ]);
+    }
+
+    function scheduleDebouncedBounds() {
+      if (!props.reportBounds) return;
+      clearBoundsDebounce();
+      boundsDebounceTimer = setTimeout(() => {
+        boundsDebounceTimer = null;
+        emitCurrentBounds();
+      }, props.boundsDebounceMs);
+    }
 
     async function loadGeoJson(): Promise<RecordingLocationsGeoJson> {
       const res = await getRecordingLocations({
@@ -190,6 +228,13 @@ export default defineComponent({
           map.on('mouseleave', 'clusters', () => (map.getCanvas().style.cursor = ''));
           map.on('mouseenter', 'unclustered-point', () => (map.getCanvas().style.cursor = 'pointer'));
           map.on('mouseleave', 'unclustered-point', () => (map.getCanvas().style.cursor = ''));
+
+          map.on('moveend', () => {
+            scheduleDebouncedBounds();
+          });
+          if (props.reportBounds) {
+            emitCurrentBounds();
+          }
         } catch (e) {
           error.value = e instanceof Error ? e.message : String(e);
         } finally {
@@ -212,7 +257,19 @@ export default defineComponent({
       }
     );
 
+    watch(
+      () => props.reportBounds,
+      (on) => {
+        if (on) {
+          emitCurrentBounds();
+        } else {
+          clearBoundsDebounce();
+        }
+      }
+    );
+
     onBeforeUnmount(() => {
+      clearBoundsDebounce();
       mapRef.value?.remove();
       mapRef.value = null;
     });
diff --git a/client/src/components/RecordingTable.vue b/client/src/components/RecordingTable.vue
index 1b232da7..ded977bc 100644
--- a/client/src/components/RecordingTable.vue
+++ b/client/src/components/RecordingTable.vue
@@ -9,6 +9,7 @@ import {
   type PropType,
 } from 'vue';
 import { getRecordings, type Recording, type FileAnnotation, type RecordingListParams } from '../api/api';
+import MapLocation from '@components/MapLocation.vue';
 import RecordingInfoDisplay from '@components/RecordingInfoDisplay.vue';
 import RecordingAnnotationSummary from '@components/RecordingAnnotationSummary.vue';
 import useState from '@use/useState';
@@ -26,6 +27,7 @@ export interface RecordingTableHeader {
 export default defineComponent({
   name: 'RecordingTable',
   components: {
+    MapLocation,
     RecordingInfoDisplay,
     RecordingAnnotationSummary,
   },
@@ -46,6 +48,11 @@ export default defineComponent({
       type: Function as PropType<(recording: Recording) => void>,
       default: undefined,
     },
+    /** When set, list requests include this WGS84 bbox [minLon, minLat, maxLon, maxLat]. */
+    bboxFilter: {
+      type: Array as unknown as PropType<[number, number, number, number] | null>,
+      default: null,
+    },
   },
   emits: ['update:tags'],
   setup(props, { emit, expose }) {
@@ -249,6 +256,10 @@ export default defineComponent({
       if (props.variant === 'shared') {
         params.public = true;
       }
+      const bf = props.bboxFilter;
+      if (bf && bf.length === 4 && bf.every((n) => Number.isFinite(n))) {
+        params.bbox = bf;
+      }
       return params;
     }
 
@@ -351,6 +362,14 @@ export default defineComponent({
       fetchRecordings(lastOptions.value);
     });
 
+    watch(
+      () => props.bboxFilter,
+      () => {
+        fetchRecordings(lastOptions.value);
+      },
+      { deep: true }
+    );
+
     onMounted(() => {
       fetchRecordings({ page: 1, itemsPerPage: 20 });
     });
@@ -513,7 +532,33 @@ export default defineComponent({
     </template>
 
     <template #item.grts_cell_id="{ item }">
-      {{ item.grts_cell_id ?? '—' }}
+      <span class="d-flex align-center gap-1">
+        <div>{{ item.grts_cell_id ?? '—' }}</div>
+        <v-menu
+          v-if="item.recording_location || (configuration.mark_annotations_completed_enabled && item.grts_cell_id)"
+          open-on-hover
+          :close-on-content-click="false"
+        >
+          <template #activator="{ props }">
+            <v-icon 
+              v-bind="props" 
+              color="primary" 
+              class="ml-2"
+              size="x-large"
+            >
+              mdi-map
+            </v-icon>
+          </template>
+          <v-card>
+            <map-location
+              :editor="false"
+              :size="{ width: 400, height: 400 }"
+              :location="getItemLocation(item)"
+              :grts-cell-id="configuration.mark_annotations_completed_enabled ? item.grts_cell_id || undefined : undefined"
+            />
+          </v-card>
+        </v-menu>
+      </span>
     </template>
 
     <template #item.comments="{ item }">
diff --git a/client/src/views/Recordings.vue b/client/src/views/Recordings.vue
index 4efc31ec..8af53884 100644
--- a/client/src/views/Recordings.vue
+++ b/client/src/views/Recordings.vue
@@ -24,6 +24,8 @@ export default defineComponent({
       saveFilterTags,
     } = useState();
     const showMap = ref(false);
+    const filterListsByMap = ref(false);
+    const mapBounds = ref<[number, number, number, number] | null>(null);
     const mapResizeTick = ref(0);
     const editingRecording: Ref<EditingRecording | null> = ref(null);
     const uploadDialog = ref(false);
@@ -99,12 +101,28 @@ export default defineComponent({
 
     watch(showMap, (open) => {
       if (open) mapResizeTick.value += 1;
+      else {
+        filterListsByMap.value = false;
+        mapBounds.value = null;
+      }
+    });
+
+    const listBboxFilter = computed((): [number, number, number, number] | null => {
+      if (!showMap.value || !filterListsByMap.value) return null;
+      return mapBounds.value;
     });
 
+    function onMapBounds(bounds: [number, number, number, number]) {
+      mapBounds.value = bounds;
+    }
+
     return {
       configuration,
       showSubmittedRecordings,
       showMap,
+      filterListsByMap,
+      listBboxFilter,
+      onMapBounds,
       showMyTable,
       mapHeight,
       mapResizeTick,
@@ -145,10 +163,21 @@ export default defineComponent({
               v-model="showMap"
               class="mr-4"
               inset
+              :color="showMap ? 'primary' : 'grey'"
               density="compact"
               label="Map"
               hide-details
             />
+            <v-switch
+              v-if="showMap"
+              v-model="filterListsByMap"
+              class="mr-4"
+              inset
+              :color="filterListsByMap ? 'primary' : 'grey'"
+              density="compact"
+              label="Filter lists to map"
+              hide-details
+            />
             <v-menu v-if="showMyTable">
               <template #activator="{ props }">
                 <v-btn
@@ -183,6 +212,8 @@ export default defineComponent({
                 :tags="filterTags"
                 :exclude-submitted="configuration.mark_annotations_completed_enabled && !showSubmittedRecordings"
                 :resize-tick="mapResizeTick"
+                :report-bounds="showMap && filterListsByMap"
+                @bounds-change="onMapBounds"
               />
             </v-card-text>
           </v-card>
@@ -219,6 +250,7 @@ export default defineComponent({
           :class="{ 'my-files-with-map': showMap, 'my-files': !showMap }"
           variant="my"
           :tags="filterTags"
+          :bbox-filter="listBboxFilter"
           :edit-recording="editRecording"
           :open-delete-recording-dialog="openDeleteRecordingDialog"
           @update:tags="setUnifiedTags"
@@ -262,6 +294,7 @@ export default defineComponent({
         <recording-table
           variant="shared"
           :tags="filterTags"
+          :bbox-filter="listBboxFilter"
           @update:tags="setUnifiedTags"
         />
       </v-card-text>

From 323dcf33b74bcb4f7024f6439a59d44824a47594 Mon Sep 17 00:00:00 2001
From: Bryon Lewis <Bryon.Lewis@kitware.com>
Date: Wed, 25 Mar 2026 15:44:45 -0400
Subject: [PATCH 05/21] map testing and adjustments

---
 .../management/commands/importRecordings.py   | 20 ++++++++++++++++++-
 bats_ai/core/views/recording.py               |  5 ++++-
 bats_ai/core/views/recording_location.py      |  2 --
 .../src/components/RecordingLocationsMap.vue  |  2 +-
 4 files changed, 24 insertions(+), 5 deletions(-)

diff --git a/bats_ai/core/management/commands/importRecordings.py b/bats_ai/core/management/commands/importRecordings.py
index 1116132c..7ec7f4f2 100644
--- a/bats_ai/core/management/commands/importRecordings.py
+++ b/bats_ai/core/management/commands/importRecordings.py
@@ -2,6 +2,7 @@
 
 import contextlib
 import logging
+import random
 from pathlib import Path
 
 from django.contrib.auth.models import User
@@ -10,12 +11,14 @@
 from django.core.management.base import BaseCommand
 from django.utils import timezone
 
-from bats_ai.core.models import Recording
+from bats_ai.core.models import Recording, RecordingTag
 from bats_ai.core.tasks.tasks import recording_compute_spectrogram
 from bats_ai.core.utils.guano_utils import extract_guano_metadata
 
 logger = logging.getLogger(__name__)
 
+_RANDOM_TAG_POOL = ("foo", "bar", "test", "sample", "data")
+
 
 class Command(BaseCommand):
     help = "Import WAV files from a directory, extract GUANO metadata, and create recordings"
@@ -43,12 +46,21 @@ def add_arguments(self, parser):
             type=int,
             help="Limit the number of WAV files to import (useful for testing)",
         )
+        parser.add_argument(
+            "--assign-random-tags",
+            action="store_true",
+            help=(
+                "Assign each imported recording one tag chosen at random from: "
+                + ", ".join(_RANDOM_TAG_POOL)
+            ),
+        )
 
     def handle(self, *args, **options):
         directory_path = Path(options["directory"])
         owner_username = options.get("owner")
         is_public = options.get("public", False)
         limit = options.get("limit")
+        assign_random_tags = options.get("assign_random_tags", False)
 
         # Validate directory
         if not directory_path.exists():
@@ -176,6 +188,12 @@ def handle(self, *args, **options):
 
                 self.stdout.write(self.style.SUCCESS(f"  Created recording ID: {recording.pk}"))
 
+                if assign_random_tags:
+                    tag_text = random.choice(_RANDOM_TAG_POOL)
+                    tag, _ = RecordingTag.objects.get_or_create(user=owner, text=tag_text)
+                    recording.tags.add(tag)
+                    self.stdout.write(self.style.SUCCESS(f"  Assigned random tag: {tag_text}"))
+
                 # Generate spectrogram synchronously
                 self.stdout.write("  Generating spectrogram...")
                 try:
diff --git a/bats_ai/core/views/recording.py b/bats_ai/core/views/recording.py
index 7a2eb167..d0be3f79 100644
--- a/bats_ai/core/views/recording.py
+++ b/bats_ai/core/views/recording.py
@@ -19,6 +19,7 @@
 
 from bats_ai.core.models import (
     Annotations,
+    GRTSCells,
     PulseMetadata,
     Recording,
     RecordingAnnotation,
@@ -512,7 +513,9 @@ def get_recordings(
     if q.bbox and q.bbox.strip():
         min_lon, min_lat, max_lon, max_lat = _parse_bbox(q.bbox)
         bbox_poly = Polygon.from_bbox((min_lon, min_lat, max_lon, max_lat))
-        queryset = queryset.filter(recording_location__intersects=bbox_poly)
+        # Need to check the GRTSCells centroids as well as the recording_location
+        grts_cell_ids = GRTSCells.objects.filter(centroid_4326__intersects=bbox_poly).values_list("grts_cell_id", flat=True)
+        queryset = queryset.filter(recording_location__intersects=bbox_poly) | queryset.filter(grts_cell_id__in=grts_cell_ids)
 
     sort_field = q.sort_by or "created"
     order_prefix = "" if q.sort_direction == "asc" else "-"
diff --git a/bats_ai/core/views/recording_location.py b/bats_ai/core/views/recording_location.py
index e6794260..d5e55ada 100644
--- a/bats_ai/core/views/recording_location.py
+++ b/bats_ai/core/views/recording_location.py
@@ -115,8 +115,6 @@ def _parse_bbox(bbox: str | None) -> tuple[float, float, float, float] | None:
     except Exception as e:
         raise HttpError(400, f"bbox values must be numbers: {e}") from e
 
-    if not (-180.0 <= min_lon <= 180.0 and -180.0 <= max_lon <= 180.0):
-        raise HttpError(400, "bbox longitude values must be within [-180, 180]")
     if not (-90.0 <= min_lat <= 90.0 and -90.0 <= max_lat <= 90.0):
         raise HttpError(400, "bbox latitude values must be within [-90, 90]")
 
diff --git a/client/src/components/RecordingLocationsMap.vue b/client/src/components/RecordingLocationsMap.vue
index a89f39a1..c8c6c3b5 100644
--- a/client/src/components/RecordingLocationsMap.vue
+++ b/client/src/components/RecordingLocationsMap.vue
@@ -5,7 +5,6 @@ import { getRecordingLocations, type RecordingLocationsGeoJson } from '@api/api'
 
 export default defineComponent({
   name: 'RecordingLocationsMap',
-  emits: ['boundsChange'],
   props: {
     height: {
       type: [Number, String] as PropType<number | string>,
@@ -33,6 +32,7 @@ export default defineComponent({
       default: 1500,
     },
   },
+  emits: ['boundsChange'],
   setup(props, { emit }) {
     const mapContainer = ref<HTMLDivElement | null>(null);
     const mapRef = ref<Map | null>(null);

From 2f957c99607b6d27b39e7030d3f9634504a892a7 Mon Sep 17 00:00:00 2001
From: Bryon Lewis <Bryon.Lewis@kitware.com>
Date: Wed, 25 Mar 2026 19:35:31 -0400
Subject: [PATCH 06/21] simplify bbox param

---
 bats_ai/core/views/recording_location.py | 13 ++++---------
 client/src/api/api.ts                    |  4 ++--
 2 files changed, 6 insertions(+), 11 deletions(-)

diff --git a/bats_ai/core/views/recording_location.py b/bats_ai/core/views/recording_location.py
index d5e55ada..3e149203 100644
--- a/bats_ai/core/views/recording_location.py
+++ b/bats_ai/core/views/recording_location.py
@@ -97,15 +97,8 @@ def _parse_bbox(bbox: str | None) -> tuple[float, float, float, float] | None:
         return None
 
     raw = bbox.strip()
-    try:
-        # Prefer JSON array format: bbox=[43,73,42,45]
-        if raw.startswith("[") and raw.endswith("]"):
-            values = json.loads(raw)
-        else:
-            # Allow bbox=43,73,42,45 as a convenience.
-            values = [v.strip() for v in raw.split(",")]
-    except Exception as e:  # pragma: no cover
-        raise HttpError(400, f"Invalid bbox format: {e}") from e
+    # Allow bbox=lon1,lat1,lon2,lat2 
+    values = [v.strip() for v in raw.split(",")]
 
     if not isinstance(values, list) or len(values) != 4:
         raise HttpError(400, "bbox must contain exactly 4 numbers")
@@ -222,6 +215,8 @@ def get_recording_locations(
         coords: list[float] | None = None
 
         if vetting_enabled:
+            # when vetting is enabled, we only show the centroid of the grts cell
+            # and not the direct recording location
             if rec.grts_cell_id is not None:
                 coords = centroids_by_cell_id.get(rec.grts_cell_id)
             # If we can't resolve a centroid, fall back to recording_location if present.
diff --git a/client/src/api/api.ts b/client/src/api/api.ts
index 3fa193d2..3c9a007e 100644
--- a/client/src/api/api.ts
+++ b/client/src/api/api.ts
@@ -330,7 +330,7 @@ async function getRecordings(getPublic = false, params?: RecordingListParams) {
       params.bbox.length === 4 &&
       params.bbox.every((n) => Number.isFinite(n))
     ) {
-      query.set('bbox', JSON.stringify(params.bbox));
+      query.set('bbox', params.bbox.join(','));
     }
   }
   if (!params?.page) query.set('page', '1');
@@ -487,7 +487,7 @@ async function getRecordingLocations(params?: RecordingLocationsParams) {
     const tagStr = Array.isArray(params.tags) ? params.tags.join(",") : params.tags;
     if (tagStr) query.set("tags", tagStr);
   }
-  if (params?.bbox) query.set("bbox", JSON.stringify(params.bbox));
+  if (params?.bbox) query.set("bbox", params.bbox.join(','));
   const qs = query.toString();
   return axiosInstance.get<RecordingLocationsGeoJson>(`/recording-locations/${qs ? `?${qs}` : ""}`);
 }

From 3583bdd476601009f10d5efea1f55c35107504e7 Mon Sep 17 00:00:00 2001
From: Bryon Lewis <Bryon.Lewis@kitware.com>
Date: Thu, 26 Mar 2026 08:54:34 -0400
Subject: [PATCH 07/21] add a way to copy recordings with random grts cell id
 locations

---
 .../management/commands/copy_recordings.py    | 38 +++++++++++++++++--
 1 file changed, 34 insertions(+), 4 deletions(-)

diff --git a/bats_ai/core/management/commands/copy_recordings.py b/bats_ai/core/management/commands/copy_recordings.py
index 5d04babb..b7a1dc7d 100644
--- a/bats_ai/core/management/commands/copy_recordings.py
+++ b/bats_ai/core/management/commands/copy_recordings.py
@@ -21,6 +21,7 @@
 
 from bats_ai.core.models import (
     CompressedSpectrogram,
+    GRTSCells,
     Recording,
     RecordingAnnotation,
     RecordingTag,
@@ -31,7 +32,7 @@
 
 logger = logging.getLogger(__name__)
 
-DEFAULT_TAGS = ["test", "foo", "bar"]
+DEFAULT_TAGS = ["test", "data", "sample","foo", "bar"]
 
 
 def _link_spectrogram_and_annotations(source_recording, new_recording):
@@ -141,6 +142,14 @@ def add_arguments(self, parser):
             help="Username of the owner for the new recordings\
             (default: use source recording owner)",
         )
+        parser.add_argument(
+            "--random-grts-cell-id",
+            action="store_true",
+            help=(
+                "Assign a random valid GRTS Cell ID to each copied recording. "
+                "When enabled, recording_location and grts_cell are cleared."
+            ),
+        )
 
     def handle(self, *args, **options):
         count = options["count"]
@@ -149,6 +158,7 @@ def handle(self, *args, **options):
         if not tag_texts:
             tag_texts = DEFAULT_TAGS
         owner_username = options.get("owner")
+        randomize_grts_cell_id = options.get("random_grts_cell_id", False)
 
         if count < 1:
             raise CommandError("--count must be at least 1.")
@@ -157,6 +167,18 @@ def handle(self, *args, **options):
         if not recordings:
             raise CommandError("No existing recordings found. Create or import some first.")
 
+        valid_grts_cell_ids: list[int] = []
+        if randomize_grts_cell_id:
+            valid_grts_cell_ids = list(
+                GRTSCells.objects.exclude(grts_cell_id__isnull=True)
+                .values_list("grts_cell_id", flat=True)
+                .distinct()
+            )
+            if not valid_grts_cell_ids:
+                raise CommandError(
+                    "No valid GRTS Cell IDs were found in GRTSCells."
+                )
+
         owner = None
         if owner_username:
             try:
@@ -190,6 +212,14 @@ def handle(self, *args, **options):
                         ext = "." + source.audio_file.name.rsplit(".", 1)[-1]
                     save_name = new_name + ext if ext else new_name
 
+                    grts_cell_id = source.grts_cell_id
+                    grts_cell = source.grts_cell
+                    recording_location = source.recording_location
+                    if randomize_grts_cell_id:
+                        grts_cell_id = random.choice(valid_grts_cell_ids)  # noqa: S311
+                        grts_cell = None
+                        recording_location = None
+
                     new_recording = Recording(
                         name=new_name,
                         owner=owner,
@@ -198,9 +228,9 @@ def handle(self, *args, **options):
                         recorded_time=source.recorded_time,
                         equipment=source.equipment,
                         comments=source.comments,
-                        recording_location=source.recording_location,
-                        grts_cell_id=source.grts_cell_id,
-                        grts_cell=source.grts_cell,
+                        recording_location=recording_location,
+                        grts_cell_id=grts_cell_id,
+                        grts_cell=grts_cell,
                         public=source.public,
                         software=source.software,
                         detector=source.detector,

From 068c45e9860c9df1218cb53b9444824c26d0cc26 Mon Sep 17 00:00:00 2001
From: Bryon Lewis <Bryon.Lewis@kitware.com>
Date: Thu, 26 Mar 2026 08:55:06 -0400
Subject: [PATCH 08/21] storing the map filter location

---
 .../src/components/RecordingLocationsMap.vue  |  19 ++
 client/src/components/RecordingTable.vue      |   7 +-
 client/src/use/useState.ts                    |  31 +++
 client/src/views/Recordings.vue               | 237 ++++++++++--------
 4 files changed, 189 insertions(+), 105 deletions(-)

diff --git a/client/src/components/RecordingLocationsMap.vue b/client/src/components/RecordingLocationsMap.vue
index c8c6c3b5..82dde4d8 100644
--- a/client/src/components/RecordingLocationsMap.vue
+++ b/client/src/components/RecordingLocationsMap.vue
@@ -31,6 +31,11 @@ export default defineComponent({
       type: Number,
       default: 1500,
     },
+    /** Optional bounds to restore the map viewport (west,south,east,north). */
+    initialBounds: {
+      type: Array as unknown as PropType<[number, number, number, number] | null>,
+      default: null,
+    },
   },
   emits: ['boundsChange'],
   setup(props, { emit }) {
@@ -229,6 +234,20 @@ export default defineComponent({
           map.on('mouseenter', 'unclustered-point', () => (map.getCanvas().style.cursor = 'pointer'));
           map.on('mouseleave', 'unclustered-point', () => (map.getCanvas().style.cursor = ''));
 
+          // If we have saved bounds, align the viewport before emitting the current bounds.
+          if (props.initialBounds) {
+            const [west, south, east, north] = props.initialBounds;
+            if ([west, south, east, north].every((n) => Number.isFinite(n))) {
+              map.fitBounds(
+                [
+                  [west, south],
+                  [east, north],
+                ],
+                { padding: 20, duration: 0 },
+              );
+            }
+          }
+
           map.on('moveend', () => {
             scheduleDebouncedBounds();
           });
diff --git a/client/src/components/RecordingTable.vue b/client/src/components/RecordingTable.vue
index ded977bc..8a03a6ff 100644
--- a/client/src/components/RecordingTable.vue
+++ b/client/src/components/RecordingTable.vue
@@ -244,7 +244,7 @@ export default defineComponent({
         ? sortByFirst.key
         : 'created';
       const sort_direction = sortByFirst?.order === 'asc' ? 'asc' : 'desc';
-      const tags = props.variant === 'my' ? filterTags.value : sharedFilterTags.value;
+      const tags = filterTagsModel.value;
       const params: RecordingListParams = {
         page: options.page,
         limit: options.itemsPerPage,
@@ -330,9 +330,8 @@ export default defineComponent({
     }
 
     function addTagToFilter(tag: string) {
-      const arr = props.variant === 'my' ? filterTags : sharedFilterTags;
-      if (!arr.value.includes(tag)) {
-        arr.value = [...arr.value, tag];
+      if (!filterTagsModel.value.includes(tag)) {
+        filterTagsModel.value = [...filterTagsModel.value, tag];
       }
     }
 
diff --git a/client/src/use/useState.ts b/client/src/use/useState.ts
index 1b03814e..2d6a75e3 100644
--- a/client/src/use/useState.ts
+++ b/client/src/use/useState.ts
@@ -115,6 +115,7 @@ const transparencyThreshold = ref(0); // 0-100 percentage
 
 const FILTER_TAG_STORAGE_KEY = 'bataiFilterTags';
 const SHARED_FILTER_TAG_STORAGE_KEY = 'bataiSharedFilterTags';
+const MAP_FILTER_BOUNDS_STORAGE_KEY = 'bataiMapFilterBounds';
 
 const filterTags: Ref<string[]> = ref([]);
 const sharedFilterTags: Ref<string[]> = ref([]);
@@ -225,6 +226,34 @@ export default function useState() {
 
   }
 
+  function saveMapFilterBounds(bounds: [number, number, number, number]) {
+    if (
+      !bounds
+      || bounds.length !== 4
+      || bounds.some((n) => !Number.isFinite(n))
+    ) {
+      return;
+    }
+    localStorage.setItem(MAP_FILTER_BOUNDS_STORAGE_KEY, JSON.stringify(bounds));
+  }
+
+  function loadMapFilterBounds(): [number, number, number, number] | null {
+    try {
+      const raw = localStorage.getItem(MAP_FILTER_BOUNDS_STORAGE_KEY);
+      if (!raw) return null;
+
+      const parsed: unknown = JSON.parse(raw);
+      if (!Array.isArray(parsed) || parsed.length !== 4) return null;
+
+      const nums = parsed.map((v) => (typeof v === 'number' ? v : Number(v)));
+      if (nums.some((n) => !Number.isFinite(n))) return null;
+
+      return nums as [number, number, number, number];
+    } catch {
+      return null;
+    }
+  }
+
   return {
     annotationState,
     creationType,
@@ -290,6 +319,8 @@ export default function useState() {
     sharedFilterTags,
     saveFilterTags,
     loadFilterTags,
+    saveMapFilterBounds,
+    loadMapFilterBounds,
     spectrogramFilename,
   };
 }
diff --git a/client/src/views/Recordings.vue b/client/src/views/Recordings.vue
index 8af53884..8e7e023f 100644
--- a/client/src/views/Recordings.vue
+++ b/client/src/views/Recordings.vue
@@ -22,8 +22,10 @@ export default defineComponent({
       filterTags,
       sharedFilterTags,
       saveFilterTags,
+      loadMapFilterBounds,
+      saveMapFilterBounds,
     } = useState();
-    const showMap = ref(false);
+    const showMap = ref(true);
     const filterListsByMap = ref(false);
     const mapBounds = ref<[number, number, number, number] | null>(null);
     const mapResizeTick = ref(0);
@@ -39,6 +41,13 @@ export default defineComponent({
       recordingTagList.value = tags.data;
     }
 
+    // Restore the saved map bounds and enable "Filter lists to map" on load.
+    const savedMapBounds = loadMapFilterBounds();
+    if (savedMapBounds) {
+      filterListsByMap.value = true;
+      mapBounds.value = savedMapBounds;
+    }
+
     const uploadDone = () => {
       uploadDialog.value = false;
       batchUploadDialog.value = false;
@@ -90,9 +99,6 @@ export default defineComponent({
     });
 
     const showMyTable = computed(() => configuration.value.is_admin || configuration.value.non_admin_upload_enabled);
-    const visibleTablesCount = computed(() => (showMyTable.value ? 1 : 0) + 1);
-    const mapHeight = computed(() => (visibleTablesCount.value === 1 ? '33vh' : '25vh'));
-
     function setUnifiedTags(v: string[]) {
       filterTags.value = v;
       sharedFilterTags.value = v;
@@ -114,6 +120,10 @@ export default defineComponent({
 
     function onMapBounds(bounds: [number, number, number, number]) {
       mapBounds.value = bounds;
+      // Only persist when filtering is enabled (bounds-change is only emitted then).
+      if (filterListsByMap.value) {
+        saveMapFilterBounds(bounds);
+      }
     }
 
     return {
@@ -124,8 +134,8 @@ export default defineComponent({
       listBboxFilter,
       onMapBounds,
       showMyTable,
-      mapHeight,
       mapResizeTick,
+      mapBounds,
       filterTags,
       setUnifiedTags,
       uploadDialog,
@@ -145,7 +155,7 @@ export default defineComponent({
 
 <template>
   <div class="recordings-scroll">
-    <v-card>
+    <v-card class="mb-3">
       <v-card-title>
         <v-row>
           <div v-if="showMyTable">
@@ -199,26 +209,13 @@ export default defineComponent({
           </div>
         </v-row>
       </v-card-title>
-      <v-card-text>
-        <v-expand-transition>
-          <v-card
-            v-if="showMap"
-            class="mb-3"
-          >
-            <v-card-text>
-              <RecordingLocationsMap
-                :class="{ 'map-with-my-files': showMap && showMyTable, 'map-with-shared-files': showMap && !showMyTable, 'map-alone': !showMap && !showMyTable }"
-                :height="mapHeight"
-                :tags="filterTags"
-                :exclude-submitted="configuration.mark_annotations_completed_enabled && !showSubmittedRecordings"
-                :resize-tick="mapResizeTick"
-                :report-bounds="showMap && filterListsByMap"
-                @bounds-change="onMapBounds"
-              />
-            </v-card-text>
-          </v-card>
-        </v-expand-transition>
+    </v-card>
 
+    <div
+      class="recordings-layout"
+      :class="{ 'with-map': showMap }"
+    >
+      <div class="recordings-lists">
         <v-dialog
           v-model="deleteDialogOpen"
           width="auto"
@@ -244,61 +241,88 @@ export default defineComponent({
             </v-card-actions>
           </v-card>
         </v-dialog>
-        <recording-table
+
+        <v-card
           v-if="showMyTable"
-          ref="myRecordingsTableRef"
-          :class="{ 'my-files-with-map': showMap, 'my-files': !showMap }"
-          variant="my"
-          :tags="filterTags"
-          :bbox-filter="listBboxFilter"
-          :edit-recording="editRecording"
-          :open-delete-recording-dialog="openDeleteRecordingDialog"
-          @update:tags="setUnifiedTags"
-        />
-      </v-card-text>
-      <v-dialog
-        v-model="uploadDialog"
-        width="700"
-      >
-        <upload-recording
-          :editing="editingRecording"
-          @done="uploadDone()"
-          @cancel="uploadDialog = false; editingRecording = null"
-        />
-      </v-dialog>
-      <v-dialog
-        v-model="batchUploadDialog"
-        width="700"
-      >
-        <batch-upload-recording
-          @done="uploadDone()"
-          @cancel="batchUploadDialog = false; editingRecording = null"
-        />
-      </v-dialog>
-    </v-card>
-    <v-card
-      class="mt-3"
-      :class="{
-        'shared-with-my-files': showMap && showMyTable,
-        'shared-dual-no-map': !showMap && showMyTable,
-        'shared-alone-with-map': showMap && !showMyTable,
-        'shared-alone': !showMap && !showMyTable,
-      }"
+        >
+          <v-card-text>
+            <recording-table
+              ref="myRecordingsTableRef"
+              :class="{ 'my-files-with-map': showMap, 'my-files': !showMap }"
+              variant="my"
+              :tags="filterTags"
+              :bbox-filter="listBboxFilter"
+              :edit-recording="editRecording"
+              :open-delete-recording-dialog="openDeleteRecordingDialog"
+              @update:tags="setUnifiedTags"
+            />
+          </v-card-text>
+        </v-card>
+
+        <v-card
+          :class="{
+            'shared-with-my-files': showMap && showMyTable,
+            'shared-dual-no-map': !showMap && showMyTable,
+            'shared-alone-with-map': showMap && !showMyTable,
+            'shared-alone': !showMap && !showMyTable,
+          }"
+        >
+          <v-card-title>
+            <v-row class="py-2">
+              <div>Shared</div>
+            </v-row>
+          </v-card-title>
+          <v-card-text>
+            <recording-table
+              variant="shared"
+              :tags="filterTags"
+              :bbox-filter="listBboxFilter"
+              @update:tags="setUnifiedTags"
+            />
+          </v-card-text>
+        </v-card>
+      </div>
+
+      <v-expand-x-transition>
+        <v-card
+          v-if="showMap"
+          class="recordings-map-panel"
+        >
+          <v-card-text class="pa-3 h-100">
+            <RecordingLocationsMap
+              class="map-right"
+              height="100%"
+              :tags="filterTags"
+              :exclude-submitted="configuration.mark_annotations_completed_enabled && !showSubmittedRecordings"
+              :resize-tick="mapResizeTick"
+              :report-bounds="showMap && filterListsByMap"
+              @bounds-change="onMapBounds"
+              :initial-bounds="mapBounds"
+            />
+          </v-card-text>
+        </v-card>
+      </v-expand-x-transition>
+    </div>
+
+    <v-dialog
+      v-model="uploadDialog"
+      width="700"
     >
-      <v-card-title>
-        <v-row class="py-2">
-          <div>Shared</div>
-        </v-row>
-      </v-card-title>
-      <v-card-text>
-        <recording-table
-          variant="shared"
-          :tags="filterTags"
-          :bbox-filter="listBboxFilter"
-          @update:tags="setUnifiedTags"
-        />
-      </v-card-text>
-    </v-card>
+      <upload-recording
+        :editing="editingRecording"
+        @done="uploadDone()"
+        @cancel="uploadDialog = false; editingRecording = null"
+      />
+    </v-dialog>
+    <v-dialog
+      v-model="batchUploadDialog"
+      width="700"
+    >
+      <batch-upload-recording
+        @done="uploadDone()"
+        @cancel="batchUploadDialog = false; editingRecording = null"
+      />
+    </v-dialog>
   </div>
 </template>
 
@@ -309,6 +333,27 @@ export default defineComponent({
   padding-bottom: 16px;
 }
 
+.recordings-layout {
+  display: block;
+}
+
+.recordings-layout.with-map {
+  display: flex;
+  align-items: stretch;
+  gap: 12px;
+}
+
+.recordings-lists {
+  flex: 1 1 auto;
+  min-width: 0;
+}
+
+.recordings-map-panel {
+  flex: 0 0 min(42vw, 680px);
+  min-width: 360px;
+  max-height: calc(100vh - 150px);
+}
+
 /* My recordings: classes are on <recording-table> (merged onto v-data-table root). */
 :deep(.my-recordings.my-files) {
   height: calc(40vh - 64px);
@@ -316,44 +361,34 @@ export default defineComponent({
 }
 
 :deep(.my-recordings.my-files-with-map) {
-  height: calc(30vh - 64px);
-  max-height: calc(30vh - 64px);
+  height: calc(45vh - 75px);
+  max-height: calc(45vh - 75px);
 }
 
 /* Shared: layout classes are on the v-card; size the inner table. */
 .shared-with-my-files :deep(.shared-recordings) {
-  height: calc(30vh - 64px);
-  max-height: calc(30vh - 64px);
+  height: calc(45vh - 75px);
+  max-height: calc(45vh - 75px);
 }
 
 .shared-dual-no-map :deep(.shared-recordings) {
-  height: calc(40vh - 64px);
-  max-height: calc(40vh - 64px);
+  height: calc(90vh - 75px);
+  max-height: calc(90vh - 75px);
 }
 
 .shared-alone-with-map :deep(.shared-recordings) {
-  height: calc(50vh - 64px);
-  max-height: calc(50vh - 64px);
+  height: calc(85vh - 75px);
+  max-height: calc(85vh - 75px);
 }
 
 .shared-alone :deep(.shared-recordings) {
-  height: calc(100vh - 64px);
-  max-height: calc(100vh - 64px);
-}
-
-.map-with-my-files {
-  height: calc(35vh - 64px);
-  max-height: calc(35vh - 64px);
-}
-
-.map-with-shared-files {
-  height: calc(35vh - 64px);
-  max-height: calc(35vh - 64px);
+  height: calc(90vh - 75px);
+  max-height: calc(90vh - 75px);
 }
 
-.map-alone {
-  height: calc(50vh - 64px);
-  max-height: calc(50vh - 64px);
+.map-right {
+  height: 100%;
+  max-height: 100%;
 }
 
 :deep(.my-recordings),

From 2e6e21cab19f4ef7b50e23474b3c5c1d910b1379 Mon Sep 17 00:00:00 2001
From: Bryon Lewis <Bryon.Lewis@kitware.com>
Date: Thu, 26 Mar 2026 08:55:50 -0400
Subject: [PATCH 09/21] formatting

---
 bats_ai/core/management/commands/copy_recordings.py  | 6 ++----
 bats_ai/core/management/commands/importRecordings.py | 2 +-
 bats_ai/core/views/recording.py                      | 8 ++++++--
 3 files changed, 9 insertions(+), 7 deletions(-)

diff --git a/bats_ai/core/management/commands/copy_recordings.py b/bats_ai/core/management/commands/copy_recordings.py
index b7a1dc7d..9b1f2752 100644
--- a/bats_ai/core/management/commands/copy_recordings.py
+++ b/bats_ai/core/management/commands/copy_recordings.py
@@ -32,7 +32,7 @@
 
 logger = logging.getLogger(__name__)
 
-DEFAULT_TAGS = ["test", "data", "sample","foo", "bar"]
+DEFAULT_TAGS = ["test", "data", "sample", "foo", "bar"]
 
 
 def _link_spectrogram_and_annotations(source_recording, new_recording):
@@ -175,9 +175,7 @@ def handle(self, *args, **options):
                 .distinct()
             )
             if not valid_grts_cell_ids:
-                raise CommandError(
-                    "No valid GRTS Cell IDs were found in GRTSCells."
-                )
+                raise CommandError("No valid GRTS Cell IDs were found in GRTSCells.")
 
         owner = None
         if owner_username:
diff --git a/bats_ai/core/management/commands/importRecordings.py b/bats_ai/core/management/commands/importRecordings.py
index 7ec7f4f2..7790aa60 100644
--- a/bats_ai/core/management/commands/importRecordings.py
+++ b/bats_ai/core/management/commands/importRecordings.py
@@ -2,8 +2,8 @@
 
 import contextlib
 import logging
-import random
 from pathlib import Path
+import random
 
 from django.contrib.auth.models import User
 from django.contrib.gis.geos import Point
diff --git a/bats_ai/core/views/recording.py b/bats_ai/core/views/recording.py
index d0be3f79..4527423f 100644
--- a/bats_ai/core/views/recording.py
+++ b/bats_ai/core/views/recording.py
@@ -514,8 +514,12 @@ def get_recordings(
         min_lon, min_lat, max_lon, max_lat = _parse_bbox(q.bbox)
         bbox_poly = Polygon.from_bbox((min_lon, min_lat, max_lon, max_lat))
         # Need to check the GRTSCells centroids as well as the recording_location
-        grts_cell_ids = GRTSCells.objects.filter(centroid_4326__intersects=bbox_poly).values_list("grts_cell_id", flat=True)
-        queryset = queryset.filter(recording_location__intersects=bbox_poly) | queryset.filter(grts_cell_id__in=grts_cell_ids)
+        grts_cell_ids = GRTSCells.objects.filter(centroid_4326__intersects=bbox_poly).values_list(
+            "grts_cell_id", flat=True
+        )
+        queryset = queryset.filter(recording_location__intersects=bbox_poly) | queryset.filter(
+            grts_cell_id__in=grts_cell_ids
+        )
 
     sort_field = q.sort_by or "created"
     order_prefix = "" if q.sort_direction == "asc" else "-"

From 4beeafdf985fb7b02ee8ab89023d963cd2c35d3d Mon Sep 17 00:00:00 2001
From: Bryon Lewis <Bryon.Lewis@kitware.com>
Date: Thu, 26 Mar 2026 09:11:18 -0400
Subject: [PATCH 10/21] linting, clearing filter bounds

---
 bats_ai/core/management/commands/importRecordings.py | 2 +-
 bats_ai/core/views/recording_location.py             | 2 +-
 client/src/use/useState.ts                           | 5 +++++
 client/src/views/Recordings.vue                      | 9 +++++++++
 4 files changed, 16 insertions(+), 2 deletions(-)

diff --git a/bats_ai/core/management/commands/importRecordings.py b/bats_ai/core/management/commands/importRecordings.py
index 7790aa60..f8c46e49 100644
--- a/bats_ai/core/management/commands/importRecordings.py
+++ b/bats_ai/core/management/commands/importRecordings.py
@@ -189,7 +189,7 @@ def handle(self, *args, **options):
                 self.stdout.write(self.style.SUCCESS(f"  Created recording ID: {recording.pk}"))
 
                 if assign_random_tags:
-                    tag_text = random.choice(_RANDOM_TAG_POOL)
+                    tag_text = random.choice(_RANDOM_TAG_POOL)  # noqa: S311
                     tag, _ = RecordingTag.objects.get_or_create(user=owner, text=tag_text)
                     recording.tags.add(tag)
                     self.stdout.write(self.style.SUCCESS(f"  Assigned random tag: {tag_text}"))
diff --git a/bats_ai/core/views/recording_location.py b/bats_ai/core/views/recording_location.py
index 3e149203..e6ade114 100644
--- a/bats_ai/core/views/recording_location.py
+++ b/bats_ai/core/views/recording_location.py
@@ -97,7 +97,7 @@ def _parse_bbox(bbox: str | None) -> tuple[float, float, float, float] | None:
         return None
 
     raw = bbox.strip()
-    # Allow bbox=lon1,lat1,lon2,lat2 
+    # Allow bbox=lon1,lat1,lon2,lat2
     values = [v.strip() for v in raw.split(",")]
 
     if not isinstance(values, list) or len(values) != 4:
diff --git a/client/src/use/useState.ts b/client/src/use/useState.ts
index 2d6a75e3..4922f053 100644
--- a/client/src/use/useState.ts
+++ b/client/src/use/useState.ts
@@ -237,6 +237,10 @@ export default function useState() {
     localStorage.setItem(MAP_FILTER_BOUNDS_STORAGE_KEY, JSON.stringify(bounds));
   }
 
+function clearMapFilterBounds() {
+  localStorage.removeItem(MAP_FILTER_BOUNDS_STORAGE_KEY);
+}
+
   function loadMapFilterBounds(): [number, number, number, number] | null {
     try {
       const raw = localStorage.getItem(MAP_FILTER_BOUNDS_STORAGE_KEY);
@@ -320,6 +324,7 @@ export default function useState() {
     saveFilterTags,
     loadFilterTags,
     saveMapFilterBounds,
+    clearMapFilterBounds,
     loadMapFilterBounds,
     spectrogramFilename,
   };
diff --git a/client/src/views/Recordings.vue b/client/src/views/Recordings.vue
index 8e7e023f..ad234658 100644
--- a/client/src/views/Recordings.vue
+++ b/client/src/views/Recordings.vue
@@ -24,6 +24,7 @@ export default defineComponent({
       saveFilterTags,
       loadMapFilterBounds,
       saveMapFilterBounds,
+      clearMapFilterBounds,
     } = useState();
     const showMap = ref(true);
     const filterListsByMap = ref(false);
@@ -110,6 +111,14 @@ export default defineComponent({
       else {
         filterListsByMap.value = false;
         mapBounds.value = null;
+        clearMapFilterBounds();
+      }
+    });
+
+    watch(filterListsByMap, (enabled) => {
+      if (!enabled) {
+        mapBounds.value = null;
+        clearMapFilterBounds();
       }
     });
 

From a54a22d81f1511bcaa3619287afc56e2e919061c Mon Sep 17 00:00:00 2001
From: Bryon Lewis <Bryon.Lewis@kitware.com>
Date: Thu, 26 Mar 2026 09:16:44 -0400
Subject: [PATCH 11/21] add bbox visualization to map location

---
 client/src/components/MapLocation.vue | 64 ++++++++++++++++++++++++++-
 client/src/views/Spectrogram.vue      | 21 ++++++++-
 2 files changed, 82 insertions(+), 3 deletions(-)

diff --git a/client/src/components/MapLocation.vue b/client/src/components/MapLocation.vue
index 24714a54..6e512096 100644
--- a/client/src/components/MapLocation.vue
+++ b/client/src/components/MapLocation.vue
@@ -21,6 +21,10 @@ export default defineComponent({
       type: Object as PropType<{ x?: number; y?: number } | undefined>,
       default: () => undefined,
     },
+    bbox: {
+      type: Array as unknown as PropType<[number, number, number, number] | null>,
+      default: null,
+    },
     grtsCellId: {
       type: Number,
       default: undefined,
@@ -63,8 +67,35 @@ export default defineComponent({
           position: { bottom: 10, left: 10},
         });
 
+        const drawBbox = (bounds: [number, number, number, number]) => {
+          const [west, south, east, north] = bounds;
+          const data = [
+            { x: west, y: south },
+            { x: east, y: south },
+            { x: east, y: north },
+            { x: west, y: north },
+            { x: west, y: south },
+          ];
+          bboxFeature.value.data([data]).style({
+            stroke: true,
+            strokeWidth: 2,
+            strokeColor: "black",
+            fill: true,
+            fillColor: "orange",
+            fillOpacity: 0.15,
+          }).draw();
+          bboxLayer.value.draw();
+          map.value.center({ x: (west + east) / 2, y: (south + north) / 2 });
+          map.value.zoom(6);
+        };
 
-        if (props.grtsCellId !== undefined) {
+        if (
+          props.bbox
+          && props.bbox.length === 4
+          && props.bbox.every((n) => Number.isFinite(n))
+        ) {
+          drawBbox(props.bbox);
+        } else if (props.grtsCellId !== undefined) {
           const annotation = await getCellBbox(props.grtsCellId);
           const coordinates = annotation.data.geometry.coordinates;
           const data = coordinates.map((point: number[]) => ({ x: point[0], y: point[1] }));
@@ -123,7 +154,36 @@ export default defineComponent({
       }
     });
     watch(() =>  props.updateMap, () => {
-      if (props.location?.x && props.location?.y) {
+      if (
+        props.bbox
+        && props.bbox.length === 4
+        && props.bbox.every((n) => Number.isFinite(n))
+        && bboxFeature.value
+        && map.value
+      ) {
+        const [west, south, east, north] = props.bbox;
+        const data = [
+          { x: west, y: south },
+          { x: east, y: south },
+          { x: east, y: north },
+          { x: west, y: north },
+          { x: west, y: south },
+        ];
+        bboxFeature.value
+          .data([data])
+          .style({
+            stroke: true,
+            strokeWidth: 2,
+            strokeColor: "black",
+            fill: true,
+            fillColor: "orange",
+            fillOpacity: 0.15,
+          })
+          .draw();
+        bboxLayer.value?.draw();
+        map.value.center({ x: (west + east) / 2, y: (south + north) / 2 });
+        map.value.zoom(6);
+      } else if (props.location?.x && props.location?.y) {
             markerLocation.value = { x: props.location?.x, y: props.location.y };
             markerFeature.value
               .data([markerLocation.value])
diff --git a/client/src/views/Spectrogram.vue b/client/src/views/Spectrogram.vue
index ef495668..a6ba4c66 100644
--- a/client/src/views/Spectrogram.vue
+++ b/client/src/views/Spectrogram.vue
@@ -32,6 +32,7 @@ import RecordingInfoDialog from "@components/RecordingInfoDialog.vue";
 import ReferenceMaterialsDialog from "@/components/ReferenceMaterialsDialog.vue";
 import SpectrogramImageContentMenu from "@/components/SpectrogramImageContentMenu.vue";
 import PulseMetadataButton from "@/components/PulseMetadataButton.vue";
+import MapLocation from "@components/MapLocation.vue";
 import useState from "@use/useState";
 import usePulseMetadata from "@use/usePulseMetadata";
 export default defineComponent({
@@ -48,6 +49,7 @@ export default defineComponent({
     SpectrogramImageContentMenu,
     TransparencyFilterControl,
     PulseMetadataButton,
+    MapLocation,
   },
   props: {
     id: {
@@ -89,6 +91,7 @@ export default defineComponent({
       currentRecordingId,
       filterTags,
       sharedFilterTags,
+      loadMapFilterBounds,
       spectrogramFilename,
     } = useState();
     const {
@@ -147,6 +150,7 @@ export default defineComponent({
     };
 
     const combinedTags = computed(() => Array.from (new Set([...filterTags.value, ...sharedFilterTags.value])));
+    const mapFilterBounds = ref<[number, number, number, number] | null>(loadMapFilterBounds());
 
     const loading = ref(false);
     const spectrogramData: Ref<Spectrogram | null> = ref(null);
@@ -411,6 +415,7 @@ export default defineComponent({
       toggleFixedAxes,
       contoursLoading,
       combinedTags,
+      mapFilterBounds,
       // Other user selection
       otherUserAnnotations,
       sequenceAnnotations,
@@ -780,7 +785,7 @@ export default defineComponent({
         <v-card-title>
           <v-row dense>
             <v-col cols="2">
-              <v-tooltip v-if="combinedTags.length">
+              <v-tooltip v-if="combinedTags.length || mapFilterBounds">
                 <template #activator="{ props: subProps }">
                   <v-icon v-bind="subProps">
                     mdi-filter
@@ -793,6 +798,20 @@ export default defineComponent({
                 >
                   {{ tag }}
                 </v-chip>
+                <div
+                  v-if="mapFilterBounds"
+                  class="mt-2"
+                  style="min-width: 280px"
+                >
+                  <div class="text-caption mb-1">
+                    Map bounds filter
+                  </div>
+                  <map-location
+                    :editor="false"
+                    :bbox="mapFilterBounds"
+                    :size="{ width: 280, height: 180 }"
+                  />
+                </div>
               </v-tooltip>
               <v-spacer v-else />
             </v-col>

From 08122c265e73205efd7e33319b8a34e5d540ca83 Mon Sep 17 00:00:00 2001
From: Bryon Lewis <Bryon.Lewis@kitware.com>
Date: Thu, 26 Mar 2026 09:26:27 -0400
Subject: [PATCH 12/21] unsubmitted neighbors bbox filtering

---
 bats_ai/core/views/recording.py  | 15 ++++++++++++++-
 client/src/api/api.ts            |  9 +++++++++
 client/src/views/Spectrogram.vue |  1 +
 3 files changed, 24 insertions(+), 1 deletion(-)

diff --git a/bats_ai/core/views/recording.py b/bats_ai/core/views/recording.py
index 4527423f..6b8fce09 100644
--- a/bats_ai/core/views/recording.py
+++ b/bats_ai/core/views/recording.py
@@ -83,6 +83,8 @@ class UnsubmittedNeighborsQuerySchema(Schema):
     ) = "created"
     sort_direction: Literal["asc", "desc"] | None = "desc"
     tags: str | None = None  # Comma-separated tag texts; recording must have all listed tags
+    # [min_lon, min_lat, max_lon, max_lat] as JSON array or comma-separated (see _parse_bbox).
+    bbox: str | None = None
 
 
 class UnsubmittedNeighborsResponse(Schema):
@@ -581,6 +583,7 @@ def _unsubmitted_recording_ids_ordered(
     sort_by: str = "created",
     sort_direction: str = "desc",
     tags: str | None = None,
+    bbox: str | None = None,
 ) -> list[int]:
     submitted_by_user = RecordingAnnotation.objects.filter(
         owner=request.user, submitted=True
@@ -594,6 +597,16 @@ def apply_filters_and_sort(qs: QuerySet[Recording]) -> QuerySet[Recording]:
                 qs = qs.filter(tags__text=tag)
             if tag_list:
                 qs = qs.distinct()
+        if bbox and bbox.strip():
+            min_lon, min_lat, max_lon, max_lat = _parse_bbox(bbox)
+            bbox_poly = Polygon.from_bbox((min_lon, min_lat, max_lon, max_lat))
+            # Need to check the GRTSCells centroids as well as the recording_location
+            grts_cell_ids = GRTSCells.objects.filter(
+                centroid_4326__intersects=bbox_poly
+            ).values_list("grts_cell_id", flat=True)
+            qs = qs.filter(recording_location__intersects=bbox_poly) | qs.filter(
+                grts_cell_id__in=grts_cell_ids
+            )
         order_prefix = "" if sort_direction == "asc" else "-"
         if sort_by == "owner_username":
             qs = qs.order_by(f"{order_prefix}owner__username")
@@ -626,7 +639,7 @@ def get_unsubmitted_neighbors(
     sort_by = q.sort_by or "created"
     sort_direction = q.sort_direction or "desc"
     raw_ids = _unsubmitted_recording_ids_ordered(
-        request, sort_by=sort_by, sort_direction=sort_direction, tags=q.tags
+        request, sort_by=sort_by, sort_direction=sort_direction, tags=q.tags, bbox=q.bbox
     )
     # One entry per recording, order preserved (my + shared can duplicate ids)
     ids = list(dict.fromkeys(int(x) for x in raw_ids))
diff --git a/client/src/api/api.ts b/client/src/api/api.ts
index 3c9a007e..49809eb7 100644
--- a/client/src/api/api.ts
+++ b/client/src/api/api.ts
@@ -346,6 +346,8 @@ export interface UnsubmittedNeighborsParams {
   sort_direction?: 'asc' | 'desc';
   /** Comma-separated or array of tag texts; recording must have all listed tags. */
   tags?: string | string[];
+  /** Bounding box filter (lon/lat) as `[min_lon, min_lat, max_lon, max_lat]`. */
+  bbox?: [number, number, number, number];
 }
 
 export interface UnsubmittedNeighborsResponse {
@@ -364,6 +366,13 @@ async function getUnsubmittedNeighbors(
     const tagStr = Array.isArray(params.tags) ? params.tags.join(',') : params.tags;
     if (tagStr) query.set('tags', tagStr);
   }
+  if (
+    params?.bbox !== undefined &&
+    params.bbox.length === 4 &&
+    params.bbox.every((n) => Number.isFinite(n))
+  ) {
+    query.set('bbox', params.bbox.join(','));
+  }
   const response = await axiosInstance.get<UnsubmittedNeighborsResponse>(
     `/recording/unsubmitted-neighbors/?${query.toString()}`
   );
diff --git a/client/src/views/Spectrogram.vue b/client/src/views/Spectrogram.vue
index a6ba4c66..ab30ba20 100644
--- a/client/src/views/Spectrogram.vue
+++ b/client/src/views/Spectrogram.vue
@@ -244,6 +244,7 @@ export default defineComponent({
             sort_by: 'created',
             sort_direction: 'desc',
             tags: tags,
+            bbox: mapFilterBounds.value ?? undefined,
           });
           nextUnsubmittedId.value = neighborsRes.data.next_id;
           previousUnsubmittedId.value = neighborsRes.data.previous_id;

From 9eec208ed2e44c87831a70e4cfaf6270afacebbf Mon Sep 17 00:00:00 2001
From: Bryon Lewis <Bryon.Lewis@kitware.com>
Date: Thu, 26 Mar 2026 12:53:24 -0400
Subject: [PATCH 13/21] cleaning up queries

---
 bats_ai/core/views/recording.py          |   8 +-
 bats_ai/core/views/recording_location.py | 149 +++++++++++++----------
 client/src/api/api.ts                    |   4 +-
 client/src/views/Spectrogram.vue         |   3 +
 4 files changed, 92 insertions(+), 72 deletions(-)

diff --git a/bats_ai/core/views/recording.py b/bats_ai/core/views/recording.py
index 6b8fce09..11d00803 100644
--- a/bats_ai/core/views/recording.py
+++ b/bats_ai/core/views/recording.py
@@ -519,8 +519,8 @@ def get_recordings(
         grts_cell_ids = GRTSCells.objects.filter(centroid_4326__intersects=bbox_poly).values_list(
             "grts_cell_id", flat=True
         )
-        queryset = queryset.filter(recording_location__intersects=bbox_poly) | queryset.filter(
-            grts_cell_id__in=grts_cell_ids
+        queryset = queryset.filter(
+            Q(recording_location__intersects=bbox_poly) | Q(grts_cell_id__in=grts_cell_ids)
         )
 
     sort_field = q.sort_by or "created"
@@ -604,8 +604,8 @@ def apply_filters_and_sort(qs: QuerySet[Recording]) -> QuerySet[Recording]:
             grts_cell_ids = GRTSCells.objects.filter(
                 centroid_4326__intersects=bbox_poly
             ).values_list("grts_cell_id", flat=True)
-            qs = qs.filter(recording_location__intersects=bbox_poly) | qs.filter(
-                grts_cell_id__in=grts_cell_ids
+            qs = qs.filter(
+                Q(recording_location__intersects=bbox_poly) | Q(grts_cell_id__in=grts_cell_ids)
             )
         order_prefix = "" if sort_direction == "asc" else "-"
         if sort_by == "owner_username":
diff --git a/bats_ai/core/views/recording_location.py b/bats_ai/core/views/recording_location.py
index e6ade114..a23b1403 100644
--- a/bats_ai/core/views/recording_location.py
+++ b/bats_ai/core/views/recording_location.py
@@ -4,11 +4,17 @@
 import logging
 from typing import TYPE_CHECKING, Any, Literal
 
-from django.db.models import Q, QuerySet
+from django.contrib.gis.geos import Polygon
+from django.db.models import Case, IntegerField, Q, QuerySet, Value, When
 from ninja import Query, Router, Schema
 from ninja.errors import HttpError
 
-from bats_ai.core.models import Configuration, GRTSCells, Recording, RecordingAnnotation
+from bats_ai.core.models import (
+    Configuration,
+    GRTSCells,
+    Recording,
+    RecordingAnnotation,
+)
 
 if TYPE_CHECKING:
     from django.http import HttpRequest
@@ -17,8 +23,8 @@
 
 router = Router()
 
-_GRTS_CUSTOM_ORDER: list[int] = GRTSCells.sort_order()
-_GRTS_ORDER_MAP: dict[int, int] = {frame_id: idx for idx, frame_id in enumerate(_GRTS_CUSTOM_ORDER)}
+# Continental US sample frame ID, defaulting to CONUS GRTS.
+_CONUS_SAMPLE_FRAME_ID = 14
 
 
 class RecordingLocationsQuerySchema(Schema):
@@ -60,14 +66,13 @@ def _split_tags(tags: str | None) -> list[str]:
 def _apply_recording_filters_and_sort(
     *,
     qs: QuerySet[Recording],
-    request: HttpRequest,
-    exclude_submitted: bool | None,
+    exclude_submitted: bool,
+    submitted_by_user: QuerySet[int] | None,
     tags: str | None,
+    bbox_poly: Polygon | None,
+    grts_cell_ids: QuerySet[int] | None,
 ) -> QuerySet[Recording]:
-    if exclude_submitted:
-        submitted_by_user = RecordingAnnotation.objects.filter(
-            owner=request.user, submitted=True
-        ).values_list("recording_id", flat=True)
+    if exclude_submitted and submitted_by_user is not None:
         qs = qs.exclude(pk__in=submitted_by_user)
 
     tag_list = _split_tags(tags)
@@ -76,22 +81,15 @@ def _apply_recording_filters_and_sort(
             qs = qs.filter(tags__text=tag)
         qs = qs.distinct()
 
+    if bbox_poly is not None and grts_cell_ids is not None:
+        qs = qs.filter(
+            Q(recording_location__intersects=bbox_poly) | Q(grts_cell_id__in=grts_cell_ids)
+        )
+
     # Keep deterministic ordering even though we don't expose sorting params.
     return qs.order_by("-created")
 
 
-def _coords_in_bbox(
-    coords: list[float],
-    *,
-    min_lon: float,
-    min_lat: float,
-    max_lon: float,
-    max_lat: float,
-) -> bool:
-    lon, lat = coords
-    return min_lon <= lon <= max_lon and min_lat <= lat <= max_lat
-
-
 def _parse_bbox(bbox: str | None) -> tuple[float, float, float, float] | None:
     if not bbox:
         return None
@@ -137,40 +135,41 @@ def _get_recording_location_coords(recording: Recording) -> list[float] | None:
     return None
 
 
-def _precompute_grts_cell_centroids(cell_ids: set[int]) -> dict[int, list[float]]:
+def _precompute_grts_cell_centroids(
+    cell_ids: set[int],
+) -> dict[int, list[float]]:
     """Precompute centroid coordinates for each `grts_cell_id`.
 
-    Choose the same "best" cell as `core/views/grts_cells.py` does, then compute
-    `[lon, lat]` from its centroid.
+    Choose the same "best" cell as `core/views/grts_cells.py` does,
+    then compute `[lon, lat]` from its centroid.
     """
     if not cell_ids:
         return {}
 
-    centroids: dict[int, list[float]] = {}
-
-    cells = GRTSCells.objects.filter(grts_cell_id__in=cell_ids)
-    cells_by_id: dict[int, list[GRTSCells]] = {}
-    for cell in cells:
-        cells_by_id.setdefault(cell.grts_cell_id, []).append(cell)
-
-    for cell_id in cell_ids:
-        candidates = cells_by_id.get(cell_id, [])
-        if not candidates:
-            continue
-
-        # Pick the same "best" cell as core/views/grts_cells.py.
-        best = sorted(
-            candidates,
-            key=lambda c: _GRTS_ORDER_MAP.get(c.sample_frame_id, len(_GRTS_CUSTOM_ORDER)),
-        )[0]
-
-        # Prefer the stored centroid (computed during GRTS import / migrations).
-        if best.centroid_4326 is None:
-            continue
+    # Default to Continental US (sample_frame_id=14). We currently only import
+    # CONUS GRTS, so this keeps centroid selection aligned with loaded data.
+    frame_rank = Case(
+        When(sample_frame_id=_CONUS_SAMPLE_FRAME_ID, then=Value(0)),
+        default=Value(1),
+        output_field=IntegerField(),
+    )
 
-        centroids[cell_id] = [float(best.centroid_4326.x), float(best.centroid_4326.y)]
+    rows = (
+        GRTSCells.objects.filter(
+            grts_cell_id__in=cell_ids,
+            centroid_4326__isnull=False,
+        )
+        .annotate(frame_rank=frame_rank)
+        .order_by("grts_cell_id", "frame_rank")
+        .distinct("grts_cell_id")
+        .values_list("grts_cell_id", "centroid_4326")
+    )
 
-    return centroids
+    return {
+        int(cell_id): [float(centroid.x), float(centroid.y)]
+        for cell_id, centroid in rows
+        if centroid is not None
+    }
 
 
 @router.get("/", response=RecordingLocationsResponseSchema)
@@ -187,29 +186,54 @@ def get_recording_locations(
         Q(owner=request.user) | Q(spectrogram__isnull=True)
     )
 
+    exclude_submitted = bool(q.exclude_submitted)
+    submitted_by_user = None
+    if exclude_submitted:
+        submitted_by_user = RecordingAnnotation.objects.filter(
+            owner=request.user, submitted=True
+        ).values_list("recording_id", flat=True)
+
+    bbox = _parse_bbox(q.bbox)
+    bbox_poly: Polygon | None = None
+    grts_cell_ids: QuerySet[int] | None = None
+    if bbox is not None:
+        bbox_poly = Polygon.from_bbox((bbox[0], bbox[1], bbox[2], bbox[3]))
+        grts_cell_ids = GRTSCells.objects.filter(centroid_4326__intersects=bbox_poly).values_list(
+            "grts_cell_id", flat=True
+        )
+
     my_qs = _apply_recording_filters_and_sort(
         qs=my_qs,
-        request=request,
-        exclude_submitted=q.exclude_submitted,
+        exclude_submitted=exclude_submitted,
+        submitted_by_user=submitted_by_user,
         tags=q.tags,
+        bbox_poly=bbox_poly,
+        grts_cell_ids=grts_cell_ids,
     )
     shared_qs = _apply_recording_filters_and_sort(
         qs=shared_qs,
-        request=request,
-        exclude_submitted=q.exclude_submitted,
+        exclude_submitted=exclude_submitted,
+        submitted_by_user=submitted_by_user,
         tags=q.tags,
+        bbox_poly=bbox_poly,
+        grts_cell_ids=grts_cell_ids,
     )
 
-    # Evaluate querysets: we need in-Python centroid/geojson conversion.
-    my_list = list(my_qs)
-    shared_list = list(shared_qs)
+    my_list = list(my_qs.only("id", "audio_file", "recording_location", "grts_cell_id", "created"))
+    shared_list = list(
+        shared_qs.only(
+            "id",
+            "audio_file",
+            "recording_location",
+            "grts_cell_id",
+            "created",
+        )
+    )
     recordings = my_list + shared_list
 
     required_cell_ids = {r.grts_cell_id for r in recordings if r.grts_cell_id is not None}
     centroids_by_cell_id = _precompute_grts_cell_centroids(required_cell_ids)
 
-    bbox = _parse_bbox(q.bbox)
-
     features: list[dict[str, Any]] = []
     for rec in recordings:
         coords: list[float] | None = None
@@ -219,7 +243,7 @@ def get_recording_locations(
             # and not the direct recording location
             if rec.grts_cell_id is not None:
                 coords = centroids_by_cell_id.get(rec.grts_cell_id)
-            # If we can't resolve a centroid, fall back to recording_location if present.
+            # If we can't resolve a centroid, fall back to recording_location.
             if coords is None:
                 coords = _get_recording_location_coords(rec)
         else:
@@ -230,15 +254,6 @@ def get_recording_locations(
         if coords is None:
             continue
 
-        if bbox is not None and not _coords_in_bbox(
-            coords,
-            min_lon=bbox[0],
-            min_lat=bbox[1],
-            max_lon=bbox[2],
-            max_lat=bbox[3],
-        ):
-            continue
-
         features.append(
             {
                 "type": "Feature",
diff --git a/client/src/api/api.ts b/client/src/api/api.ts
index 49809eb7..b635c97d 100644
--- a/client/src/api/api.ts
+++ b/client/src/api/api.ts
@@ -496,7 +496,9 @@ async function getRecordingLocations(params?: RecordingLocationsParams) {
     const tagStr = Array.isArray(params.tags) ? params.tags.join(",") : params.tags;
     if (tagStr) query.set("tags", tagStr);
   }
-  if (params?.bbox) query.set("bbox", params.bbox.join(','));
+  if (params?.bbox !== undefined && params.bbox.length === 4 && params.bbox.every((n) => Number.isFinite(n))) {
+    query.set("bbox", params.bbox.join(','));
+  }
   const qs = query.toString();
   return axiosInstance.get<RecordingLocationsGeoJson>(`/recording-locations/${qs ? `?${qs}` : ""}`);
 }
diff --git a/client/src/views/Spectrogram.vue b/client/src/views/Spectrogram.vue
index ab30ba20..161af13b 100644
--- a/client/src/views/Spectrogram.vue
+++ b/client/src/views/Spectrogram.vue
@@ -155,6 +155,9 @@ export default defineComponent({
     const loading = ref(false);
     const spectrogramData: Ref<Spectrogram | null> = ref(null);
     const loadData = async () => {
+      // Load the map filter bounds from the local storage
+      // This is used to filter the unsubmitted neighbors
+      mapFilterBounds.value = loadMapFilterBounds();
       const tempViewPulseMetadataLayer = viewPulseMetadataLayer.value;
       viewPulseMetadataLayer.value = false;
       contoursEnabled.value = false;

From 30a339218946006db10d645a66fcbbc04e0cabd5 Mon Sep 17 00:00:00 2001
From: Bryon Lewis <Bryon.Lewis@kitware.com>
Date: Fri, 27 Mar 2026 13:18:59 -0400
Subject: [PATCH 14/21] use more raw geos functions instead of JSON conversion

---
 bats_ai/core/views/recording_location.py | 20 ++++++--------------
 1 file changed, 6 insertions(+), 14 deletions(-)

diff --git a/bats_ai/core/views/recording_location.py b/bats_ai/core/views/recording_location.py
index a23b1403..fb164317 100644
--- a/bats_ai/core/views/recording_location.py
+++ b/bats_ai/core/views/recording_location.py
@@ -1,6 +1,5 @@
 from __future__ import annotations
 
-import json
 import logging
 from typing import TYPE_CHECKING, Any, Literal
 
@@ -120,19 +119,12 @@ def _parse_bbox(bbox: str | None) -> tuple[float, float, float, float] | None:
 
 def _get_recording_location_coords(recording: Recording) -> list[float] | None:
     """Return `[lon, lat]` for `Recording.recording_location` if present."""
-    if not recording.recording_location:
+    point = recording.recording_location
+    if not point:
         return None
 
-    # GeoDjango geometry -> GeoJSON -> coordinates.
-    location_geojson = json.loads(recording.recording_location.json)
-    coords = location_geojson.get("coordinates")
-    if (
-        isinstance(coords, list)
-        and len(coords) == 2
-        and all(isinstance(v, (int, float)) for v in coords)
-    ):
-        return [float(coords[0]), float(coords[1])]
-    return None
+    # Prefer direct GEOS access instead of serializing geometry to JSON.
+    return [float(point.x), float(point.y)]
 
 
 def _precompute_grts_cell_centroids(
@@ -239,8 +231,8 @@ def get_recording_locations(
         coords: list[float] | None = None
 
         if vetting_enabled:
-            # when vetting is enabled, we only show the centroid of the grts cell
-            # and not the direct recording location
+            # When vetting is enabled, we only show the centroid of the
+            # GRTS cell and not the direct recording location.
             if rec.grts_cell_id is not None:
                 coords = centroids_by_cell_id.get(rec.grts_cell_id)
             # If we can't resolve a centroid, fall back to recording_location.

From 25f825f6ab06757aacaacbbd5c8fdb6edeb5e0db Mon Sep 17 00:00:00 2001
From: Bryon Lewis <Bryon.Lewis@kitware.com>
Date: Wed, 1 Apr 2026 07:33:08 -0400
Subject: [PATCH 15/21] backend logic for recording location display

---
 bats_ai/core/api.py                           |   4 +
 .../management/commands/copy_recordings.py    |  36 +-
 .../management/commands/importRecordings.py   |  20 +-
 bats_ai/core/management/commands/loadGRTS.py  |  14 +-
 .../0035_add_grtscells_centroid_4326.py       |  44 ++
 bats_ai/core/models/grts_cells.py             |   2 +
 bats_ai/core/views/__init__.py                |   2 +
 bats_ai/core/views/recording.py               | 674 +++++++++++-------
 bats_ai/core/views/recording_location.py      | 260 +++++++
 9 files changed, 789 insertions(+), 267 deletions(-)
 create mode 100644 bats_ai/core/migrations/0035_add_grtscells_centroid_4326.py
 create mode 100644 bats_ai/core/views/recording_location.py

diff --git a/bats_ai/core/api.py b/bats_ai/core/api.py
index 51008c2c..0d6a8d49 100644
--- a/bats_ai/core/api.py
+++ b/bats_ai/core/api.py
@@ -28,6 +28,10 @@ def global_auth(request):
 api = NinjaAPI(auth=global_auth)
 
 api.add_router("/recording/", views.recording_router)
+api.add_router(
+    "/recording-locations/",
+    views.recording_locations_router,
+)
 api.add_router("/species/", views.species_router)
 api.add_router("/grts/", views.grts_cells_router)
 api.add_router("/guano/", views.guano_metadata_router)
diff --git a/bats_ai/core/management/commands/copy_recordings.py b/bats_ai/core/management/commands/copy_recordings.py
index 5d04babb..9b1f2752 100644
--- a/bats_ai/core/management/commands/copy_recordings.py
+++ b/bats_ai/core/management/commands/copy_recordings.py
@@ -21,6 +21,7 @@
 
 from bats_ai.core.models import (
     CompressedSpectrogram,
+    GRTSCells,
     Recording,
     RecordingAnnotation,
     RecordingTag,
@@ -31,7 +32,7 @@
 
 logger = logging.getLogger(__name__)
 
-DEFAULT_TAGS = ["test", "foo", "bar"]
+DEFAULT_TAGS = ["test", "data", "sample", "foo", "bar"]
 
 
 def _link_spectrogram_and_annotations(source_recording, new_recording):
@@ -141,6 +142,14 @@ def add_arguments(self, parser):
             help="Username of the owner for the new recordings\
             (default: use source recording owner)",
         )
+        parser.add_argument(
+            "--random-grts-cell-id",
+            action="store_true",
+            help=(
+                "Assign a random valid GRTS Cell ID to each copied recording. "
+                "When enabled, recording_location and grts_cell are cleared."
+            ),
+        )
 
     def handle(self, *args, **options):
         count = options["count"]
@@ -149,6 +158,7 @@ def handle(self, *args, **options):
         if not tag_texts:
             tag_texts = DEFAULT_TAGS
         owner_username = options.get("owner")
+        randomize_grts_cell_id = options.get("random_grts_cell_id", False)
 
         if count < 1:
             raise CommandError("--count must be at least 1.")
@@ -157,6 +167,16 @@ def handle(self, *args, **options):
         if not recordings:
             raise CommandError("No existing recordings found. Create or import some first.")
 
+        valid_grts_cell_ids: list[int] = []
+        if randomize_grts_cell_id:
+            valid_grts_cell_ids = list(
+                GRTSCells.objects.exclude(grts_cell_id__isnull=True)
+                .values_list("grts_cell_id", flat=True)
+                .distinct()
+            )
+            if not valid_grts_cell_ids:
+                raise CommandError("No valid GRTS Cell IDs were found in GRTSCells.")
+
         owner = None
         if owner_username:
             try:
@@ -190,6 +210,14 @@ def handle(self, *args, **options):
                         ext = "." + source.audio_file.name.rsplit(".", 1)[-1]
                     save_name = new_name + ext if ext else new_name
 
+                    grts_cell_id = source.grts_cell_id
+                    grts_cell = source.grts_cell
+                    recording_location = source.recording_location
+                    if randomize_grts_cell_id:
+                        grts_cell_id = random.choice(valid_grts_cell_ids)  # noqa: S311
+                        grts_cell = None
+                        recording_location = None
+
                     new_recording = Recording(
                         name=new_name,
                         owner=owner,
@@ -198,9 +226,9 @@ def handle(self, *args, **options):
                         recorded_time=source.recorded_time,
                         equipment=source.equipment,
                         comments=source.comments,
-                        recording_location=source.recording_location,
-                        grts_cell_id=source.grts_cell_id,
-                        grts_cell=source.grts_cell,
+                        recording_location=recording_location,
+                        grts_cell_id=grts_cell_id,
+                        grts_cell=grts_cell,
                         public=source.public,
                         software=source.software,
                         detector=source.detector,
diff --git a/bats_ai/core/management/commands/importRecordings.py b/bats_ai/core/management/commands/importRecordings.py
index 1116132c..f8c46e49 100644
--- a/bats_ai/core/management/commands/importRecordings.py
+++ b/bats_ai/core/management/commands/importRecordings.py
@@ -3,6 +3,7 @@
 import contextlib
 import logging
 from pathlib import Path
+import random
 
 from django.contrib.auth.models import User
 from django.contrib.gis.geos import Point
@@ -10,12 +11,14 @@
 from django.core.management.base import BaseCommand
 from django.utils import timezone
 
-from bats_ai.core.models import Recording
+from bats_ai.core.models import Recording, RecordingTag
 from bats_ai.core.tasks.tasks import recording_compute_spectrogram
 from bats_ai.core.utils.guano_utils import extract_guano_metadata
 
 logger = logging.getLogger(__name__)
 
+_RANDOM_TAG_POOL = ("foo", "bar", "test", "sample", "data")
+
 
 class Command(BaseCommand):
     help = "Import WAV files from a directory, extract GUANO metadata, and create recordings"
@@ -43,12 +46,21 @@ def add_arguments(self, parser):
             type=int,
             help="Limit the number of WAV files to import (useful for testing)",
         )
+        parser.add_argument(
+            "--assign-random-tags",
+            action="store_true",
+            help=(
+                "Assign each imported recording one tag chosen at random from: "
+                + ", ".join(_RANDOM_TAG_POOL)
+            ),
+        )
 
     def handle(self, *args, **options):
         directory_path = Path(options["directory"])
         owner_username = options.get("owner")
         is_public = options.get("public", False)
         limit = options.get("limit")
+        assign_random_tags = options.get("assign_random_tags", False)
 
         # Validate directory
         if not directory_path.exists():
@@ -176,6 +188,12 @@ def handle(self, *args, **options):
 
                 self.stdout.write(self.style.SUCCESS(f"  Created recording ID: {recording.pk}"))
 
+                if assign_random_tags:
+                    tag_text = random.choice(_RANDOM_TAG_POOL)  # noqa: S311
+                    tag, _ = RecordingTag.objects.get_or_create(user=owner, text=tag_text)
+                    recording.tags.add(tag)
+                    self.stdout.write(self.style.SUCCESS(f"  Assigned random tag: {tag_text}"))
+
                 # Generate spectrogram synchronously
                 self.stdout.write("  Generating spectrogram...")
                 try:
diff --git a/bats_ai/core/management/commands/loadGRTS.py b/bats_ai/core/management/commands/loadGRTS.py
index e93946dc..3f13605a 100644
--- a/bats_ai/core/management/commands/loadGRTS.py
+++ b/bats_ai/core/management/commands/loadGRTS.py
@@ -53,7 +53,10 @@ class Command(BaseCommand):
 
     def add_arguments(self, parser):
         parser.add_argument(
-            "--batch-size", type=int, default=5000, help="Batch size for database insertion"
+            "--batch-size",
+            type=int,
+            default=5000,
+            help="Batch size for database insertion",
         )
 
     def _download_file(self, url: str, zip_path: Path) -> None:
@@ -78,7 +81,8 @@ def handle(self, *args, **options):
                     self._download_file(url, zip_path)
                 except requests.RequestException as e:
                     logger.warning(
-                        "Failed to download from primary URL: %s. Attempting backup URL...", e
+                        "Failed to download from primary URL: %s. Attempting backup URL...",
+                        e,
                     )
                     if backup_url is None:
                         logger.warning("No backup URL provided, skipping this shapefile.")
@@ -117,7 +121,9 @@ def handle(self, *args, **options):
                 count_new = 0
 
                 for idx, row in tqdm(
-                    gdf.iterrows(), total=len(gdf), desc=f"Importing {sample_frame_id}"
+                    gdf.iterrows(),
+                    total=len(gdf),
+                    desc=f"Importing {sample_frame_id}",
                 ):
                     # Hard fail if GRTS_ID is missing
                     if "GRTS_ID" not in row or row["GRTS_ID"] is None:
@@ -131,6 +137,7 @@ def handle(self, *args, **options):
                         continue
 
                     geom_4326 = row.geometry.wkt
+                    centroid_4326 = row.geometry.centroid.wkt
                     if gdf.crs and gdf.crs.to_epsg() != 4326:
                         grts_geom = row.geometry.to_wkt()
                     else:
@@ -142,6 +149,7 @@ def handle(self, *args, **options):
                         sample_frame_id=sample_frame_id,
                         grts_geom=grts_geom,
                         geom_4326=geom_4326,
+                        centroid_4326=centroid_4326,
                     )
                     records_to_create.append(cell)
                     count_new += 1
diff --git a/bats_ai/core/migrations/0035_add_grtscells_centroid_4326.py b/bats_ai/core/migrations/0035_add_grtscells_centroid_4326.py
new file mode 100644
index 00000000..80f5fc32
--- /dev/null
+++ b/bats_ai/core/migrations/0035_add_grtscells_centroid_4326.py
@@ -0,0 +1,44 @@
+from __future__ import annotations
+
+from django.contrib.gis.db import models
+from django.db import migrations
+
+
+def backfill_centroids(apps, schema_editor) -> None:
+    GRTSCells = apps.get_model("core", "GRTSCells")
+
+    batch_size = 1000
+    to_update = []
+
+    qs = (
+        GRTSCells.objects.filter(centroid_4326__isnull=True)
+        .exclude(geom_4326__isnull=True)
+        .only("id", "grts_cell_id", "sample_frame_id", "geom_4326")
+    )
+
+    for cell in qs.iterator(chunk_size=batch_size):
+        # `centroid` returns a Point geometry in the same SRID.
+        cell.centroid_4326 = cell.geom_4326.centroid
+        to_update.append(cell)
+
+        if len(to_update) >= batch_size:
+            GRTSCells.objects.bulk_update(to_update, ["centroid_4326"], batch_size=batch_size)
+            to_update.clear()
+
+    if to_update:
+        GRTSCells.objects.bulk_update(to_update, ["centroid_4326"], batch_size=batch_size)
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("core", "0034_alter_spectrogramimage_type"),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name="grtscells",
+            name="centroid_4326",
+            field=models.PointField(srid=4326, null=True, blank=True),
+        ),
+        migrations.RunPython(backfill_centroids, migrations.RunPython.noop),
+    ]
diff --git a/bats_ai/core/models/grts_cells.py b/bats_ai/core/models/grts_cells.py
index c0de5144..270f0a76 100644
--- a/bats_ai/core/models/grts_cells.py
+++ b/bats_ai/core/models/grts_cells.py
@@ -24,6 +24,8 @@ class GRTSCells(models.Model):
     grts_geom = models.GeometryField(blank=True, null=True)
     # continue defining all fields similarly
     geom_4326 = models.GeometryField()
+    # Precomputed centroid of `geom_4326` for faster lookup of cell centers.
+    centroid_4326 = models.PointField(srid=4326, blank=True, null=True)
 
     @property
     def sample_frame_mapping(self):
diff --git a/bats_ai/core/views/__init__.py b/bats_ai/core/views/__init__.py
index 70331d60..39c9fd22 100644
--- a/bats_ai/core/views/__init__.py
+++ b/bats_ai/core/views/__init__.py
@@ -7,6 +7,7 @@
 from .processing_tasks import router as processing_task_router
 from .recording import router as recording_router
 from .recording_annotation import router as recording_annotation_router
+from .recording_location import router as recording_locations_router
 from .recording_tag import router as recording_tag_router
 from .species import router as species_router
 from .vetting_details import router as vetting_router
@@ -18,6 +19,7 @@
     "guano_metadata_router",
     "processing_task_router",
     "recording_annotation_router",
+    "recording_locations_router",
     "recording_router",
     "recording_tag_router",
     "species_router",
diff --git a/bats_ai/core/views/recording.py b/bats_ai/core/views/recording.py
index 60b1c192..62056286 100644
--- a/bats_ai/core/views/recording.py
+++ b/bats_ai/core/views/recording.py
@@ -6,11 +6,10 @@
 from typing import TYPE_CHECKING, Any, Literal
 
 from django.contrib.auth.models import User
-from django.contrib.gis.geos import Point
+from django.contrib.gis.geos import Point, Polygon
 from django.contrib.postgres.aggregates import ArrayAgg
 from django.core.files.storage import default_storage
 from django.db.models import Count, Exists, OuterRef, Prefetch, Q, QuerySet
-from django.shortcuts import get_object_or_404
 from ninja import File, Form, Query, Schema
 
 # Django-Ninja accesses additional params directly, so we need to ignore the type checker.
@@ -19,6 +18,8 @@
 
 from bats_ai.core.models import (
     Annotations,
+    CompressedSpectrogram,
+    GRTSCells,
     PulseMetadata,
     Recording,
     RecordingAnnotation,
@@ -28,6 +29,7 @@
     Spectrogram,
 )
 from bats_ai.core.tasks.tasks import recording_compute_spectrogram
+from bats_ai.core.views.recording_location import _parse_bbox
 from bats_ai.core.views.species import SpeciesSchema
 
 if TYPE_CHECKING:
@@ -62,6 +64,8 @@ class RecordingListQuerySchema(Schema):
     annotation_completed: bool | None = None
     search: str | None = None
     tags: str | None = None  # Comma-separated tag texts; recording must have all listed tags
+    # [min_lon, min_lat, max_lon, max_lat] as JSON array or comma-separated (see _parse_bbox).
+    bbox: str | None = None
     sort_by: (
         Literal["id", "name", "created", "modified", "recorded_date", "owner_username"] | None
     ) = "created"
@@ -346,7 +350,10 @@ def create_recording(
 
 @router.patch("/{pk}")
 def update_recording(request: HttpRequest, pk: int, recording_data: RecordingUploadSchema):
-    recording = get_object_or_404(Recording, pk=pk, owner=request.user)
+    try:
+        recording = Recording.objects.get(pk=pk, owner=request.user)
+    except Recording.DoesNotExist:
+        return {"error": "Recording not found"}
 
     if recording_data.name:
         recording.name = recording_data.name
@@ -455,15 +462,23 @@ def delete_recording(
     request,
     pk: int,
 ):
-    recording = get_object_or_404(Recording, pk=pk)
+    try:
+        recording = Recording.objects.get(pk=pk)
 
-    # Check if the user owns the recording
-    if recording.owner == request.user:
-        # Delete the annotation
-        recording.delete()
-        return {"message": "Recording deleted successfully"}
-    else:
-        return {"error": "Permission denied. You do not own this recording, and it is not public."}
+        # Check if the user owns the recording
+        if recording.owner == request.user:
+            # Delete the annotation
+            recording.delete()
+            return {"message": "Recording deleted successfully"}
+        else:
+            return {
+                "error": "Permission denied. You do not own this recording, and it is not public."
+            }
+
+    except Recording.DoesNotExist:
+        return {"error": "Recording not found"}
+    except Annotations.DoesNotExist:
+        return {"error": "Annotation not found"}
 
 
 @router.get("/", response=RecordingPaginatedResponse)
@@ -505,6 +520,16 @@ def get_recordings(
             for tag in tag_list:
                 queryset = queryset.filter(tags__text=tag)
             queryset = queryset.distinct()
+    if q.bbox and q.bbox.strip():
+        min_lon, min_lat, max_lon, max_lat = _parse_bbox(q.bbox)
+        bbox_poly = Polygon.from_bbox((min_lon, min_lat, max_lon, max_lat))
+        # Need to check the GRTSCells centroids as well as the recording_location
+        grts_cell_ids = GRTSCells.objects.filter(centroid_4326__intersects=bbox_poly).values_list(
+            "grts_cell_id", flat=True
+        )
+        queryset = queryset.filter(
+            Q(recording_location__intersects=bbox_poly) | Q(grts_cell_id__in=grts_cell_ids)
+        )
 
     sort_field = q.sort_by or "created"
     order_prefix = "" if q.sort_direction == "asc" else "-"
@@ -566,6 +591,7 @@ def _unsubmitted_recording_ids_ordered(
     sort_by: str = "created",
     sort_direction: str = "desc",
     tags: str | None = None,
+    bbox: str | None = None,
 ) -> list[int]:
     submitted_by_user = RecordingAnnotation.objects.filter(
         owner=request.user, submitted=True
@@ -579,6 +605,16 @@ def apply_filters_and_sort(qs: QuerySet[Recording]) -> QuerySet[Recording]:
                 qs = qs.filter(tags__text=tag)
             if tag_list:
                 qs = qs.distinct()
+        if bbox and bbox.strip():
+            min_lon, min_lat, max_lon, max_lat = _parse_bbox(bbox)
+            bbox_poly = Polygon.from_bbox((min_lon, min_lat, max_lon, max_lat))
+            # Need to check the GRTSCells centroids as well as the recording_location
+            grts_cell_ids = GRTSCells.objects.filter(
+                centroid_4326__intersects=bbox_poly
+            ).values_list("grts_cell_id", flat=True)
+            qs = qs.filter(
+                Q(recording_location__intersects=bbox_poly) | Q(grts_cell_id__in=grts_cell_ids)
+            )
         order_prefix = "" if sort_direction == "asc" else "-"
         if sort_by == "owner_username":
             qs = qs.order_by(f"{order_prefix}owner__username")
@@ -611,7 +647,7 @@ def get_unsubmitted_neighbors(
     sort_by = q.sort_by or "created"
     sort_direction = q.sort_direction or "desc"
     raw_ids = _unsubmitted_recording_ids_ordered(
-        request, sort_by=sort_by, sort_direction=sort_direction, tags=q.tags
+        request, sort_by=sort_by, sort_direction=sort_direction, tags=q.tags, bbox=q.bbox
     )
     # One entry per recording, order preserved (my + shared can duplicate ids)
     ids = list(dict.fromkeys(int(x) for x in raw_ids))
@@ -635,56 +671,68 @@ def get_unsubmitted_neighbors(
 
 @router.get("/{pk}/")
 def get_recording(request: HttpRequest, pk: int):
-    recording = get_object_or_404(
-        Recording.objects.annotate(
-            tags_text=ArrayAgg("tags__text", filter=Q(tags__text__isnull=False))
-        ).values(),
-        pk=pk,
-    )
-
-    user = User.objects.get(id=recording["owner_id"])
-    recording["owner_username"] = user.username
-    recording["audio_file_presigned_url"] = default_storage.url(recording["audio_file"])
-    recording["hasSpectrogram"] = len(recording["spectrograms"]) > 0
-    if recording["recording_location"]:
-        recording["recording_location"] = json.loads(recording["recording_location"].json)
-    annotation_owners = (
-        Annotations.objects.filter(recording_id=recording["id"])
-        .values_list("owner", flat=True)
-        .distinct()
-    )
-    recording_annotation_owners = (
-        RecordingAnnotation.objects.filter(recording_id=recording["id"])
-        .values_list("owner", flat=True)
-        .distinct()
-    )
+    # Filter recordings based on the owner's id or public=True
+    try:
+        recordings = (
+            Recording.objects.filter(pk=pk)
+            .annotate(tags_text=ArrayAgg("tags__text", filter=Q(tags__text__isnull=False)))
+            .values()
+        )
+        if len(recordings) > 0:
+            recording = recordings[0]
+
+            user = User.objects.get(id=recording["owner_id"])
+            recording["owner_username"] = user.username
+            recording["audio_file_presigned_url"] = default_storage.url(recording["audio_file"])
+            recording["hasSpectrogram"] = Recording.objects.get(id=recording["id"]).has_spectrogram
+            if recording["recording_location"]:
+                recording["recording_location"] = json.loads(recording["recording_location"].json)
+            annotation_owners = (
+                Annotations.objects.filter(recording_id=recording["id"])
+                .values_list("owner", flat=True)
+                .distinct()
+            )
+            recording_annotation_owners = (
+                RecordingAnnotation.objects.filter(recording_id=recording["id"])
+                .values_list("owner", flat=True)
+                .distinct()
+            )
 
-    # Combine the sets of owners and count unique entries
-    unique_users_with_annotations = len(
-        set(annotation_owners).union(set(recording_annotation_owners))
-    )
-    recording["userAnnotations"] = unique_users_with_annotations
-    user_has_annotations = (
-        Annotations.objects.filter(recording_id=recording["id"], owner=request.user).exists()
-        or RecordingAnnotation.objects.filter(
-            recording_id=recording["id"], owner=request.user
-        ).exists()
-    )
-    recording["userMadeAnnotations"] = user_has_annotations
-    # Only expose file-level annotations owned by the current user
-    file_annotations = RecordingAnnotation.objects.filter(
-        recording=pk, owner=request.user
-    ).order_by("confidence")
-    recording["fileAnnotations"] = [
-        RecordingAnnotationSchema.from_orm(fileAnnotation).dict()
-        for fileAnnotation in file_annotations
-    ]
-    return recording
+            # Combine the sets of owners and count unique entries
+            unique_users_with_annotations = len(
+                set(annotation_owners).union(set(recording_annotation_owners))
+            )
+            recording["userAnnotations"] = unique_users_with_annotations
+            user_has_annotations = (
+                Annotations.objects.filter(
+                    recording_id=recording["id"], owner=request.user
+                ).exists()
+                or RecordingAnnotation.objects.filter(
+                    recording_id=recording["id"], owner=request.user
+                ).exists()
+            )
+            recording["userMadeAnnotations"] = user_has_annotations
+            # Only expose file-level annotations owned by the current user
+            file_annotations = RecordingAnnotation.objects.filter(
+                recording=pk, owner=request.user
+            ).order_by("confidence")
+            recording["fileAnnotations"] = [
+                RecordingAnnotationSchema.from_orm(fileAnnotation).dict()
+                for fileAnnotation in file_annotations
+            ]
+            return recording
+        else:
+            return {"error": "Recording not found"}
+    except Recording.DoesNotExist:
+        return {"error": "Recording not found"}
 
 
 @router.get("/{recording_id}/recording-annotations")
 def get_recording_annotations(request: HttpRequest, recording_id: int):
-    recording = get_object_or_404(Recording, pk=recording_id)
+    try:
+        recording = Recording.objects.get(pk=recording_id)
+    except Recording.DoesNotExist:
+        return {"error": "Recording not found"}
     if recording.owner != request.user and not recording.public:
         return {"error": "Permission denied. You do not own this recording, and it is not public."}
     # Only return file-level annotations owned by the current user (same as pulse)
@@ -703,7 +751,10 @@ def get_recording_annotations(request: HttpRequest, recording_id: int):
 
 @router.get("/{pk}/spectrogram")
 def get_spectrogram(request: HttpRequest, pk: int):
-    recording = get_object_or_404(Recording, pk=pk)
+    try:
+        recording = Recording.objects.get(pk=pk)
+    except Recording.DoesNotExist:
+        return {"error": "Recording not found"}
 
     spectrogram = recording.spectrogram
 
@@ -772,8 +823,13 @@ def get_spectrogram(request: HttpRequest, pk: int):
 
 @router.get("/{pk}/spectrogram/compressed")
 def get_spectrogram_compressed(request: HttpRequest, pk: int):
-    recording = get_object_or_404(Recording, pk=pk)
-    compressed_spectrogram = get_object_or_404(recording.compressedspectrogram_set)
+    try:
+        recording = Recording.objects.get(pk=pk)
+        compressed_spectrogram = CompressedSpectrogram.objects.filter(recording=pk).first()
+    except compressed_spectrogram.DoesNotExist:
+        return {"error": "Compressed Spectrogram"}
+    except recording.DoesNotExist:
+        return {"error": "Recording does not exist"}
 
     spectro_data = {
         "urls": compressed_spectrogram.image_url_list,
@@ -839,90 +895,118 @@ def get_spectrogram_compressed(request: HttpRequest, pk: int):
 
 @router.get("/{pk}/annotations")
 def get_annotations(request: HttpRequest, pk: int):
-    recording = get_object_or_404(Recording, pk=pk)
+    try:
+        recording = Recording.objects.get(pk=pk)
 
-    # Check if the user owns the recording or if the recording is public
-    if recording.owner == request.user or recording.public:
-        # Query annotations associated with the recording that are owned by the current user
-        annotations_qs = Annotations.objects.filter(recording=recording, owner=request.user)
+        # Check if the user owns the recording or if the recording is public
+        if recording.owner == request.user or recording.public:
+            # Query annotations associated with the recording that are owned by the current user
+            annotations_qs = Annotations.objects.filter(recording=recording, owner=request.user)
 
-        # Serialize the annotations using AnnotationSchema
-        return [
-            AnnotationSchema.from_orm(annotation, owner_email=request.user.email).dict()
-            for annotation in annotations_qs
-        ]
+            # Serialize the annotations using AnnotationSchema
+            return [
+                AnnotationSchema.from_orm(annotation, owner_email=request.user.email).dict()
+                for annotation in annotations_qs
+            ]
 
-    else:
-        return {"error": "Permission denied. You do not own this recording, and it is not public."}
+        else:
+            return {
+                "error": "Permission denied. You do not own this recording, and it is not public."
+            }
+
+    except Recording.DoesNotExist:
+        return {"error": "Recording not found"}
 
 
 @router.get("/{pk}/pulse_contours")
 def get_pulse_contours(request: HttpRequest, pk: int):
-    recording = get_object_or_404(Recording, pk=pk)
-    if recording.owner == request.user or recording.public:
-        computed_pulse_annotation_qs = PulseMetadata.objects.filter(recording=recording).order_by(
-            "index"
-        )
-        return [PulseContourSchema.from_orm(pulse) for pulse in computed_pulse_annotation_qs.all()]
-    else:
-        return {"error": "Permission denied. You do not own this recording, and it is not public."}
+    try:
+        recording = Recording.objects.get(pk=pk)
+        if recording.owner == request.user or recording.public:
+            computed_pulse_annotation_qs = PulseMetadata.objects.filter(
+                recording=recording
+            ).order_by("index")
+            return [
+                PulseContourSchema.from_orm(pulse) for pulse in computed_pulse_annotation_qs.all()
+            ]
+        else:
+            return {
+                "error": "Permission denied. You do not own this recording, and it is not public."
+            }
+    except Recording.DoesNotExist:
+        return {"error": "Recording not found"}
 
 
 @router.get("/{pk}/pulse_data")
 def get_pulse_data(request: HttpRequest, pk: int):
-    recording = get_object_or_404(Recording, pk=pk)
-    if recording.owner == request.user or recording.public:
-        computed_pulse_annotation_qs = PulseMetadata.objects.filter(recording=recording).order_by(
-            "index"
-        )
-        return [PulseMetadataSchema.from_orm(pulse) for pulse in computed_pulse_annotation_qs.all()]
-    else:
-        return {"error": "Permission denied. You do not own this recording, and it is not public."}
+    try:
+        recording = Recording.objects.get(pk=pk)
+        if recording.owner == request.user or recording.public:
+            computed_pulse_annotation_qs = PulseMetadata.objects.filter(
+                recording=recording
+            ).order_by("index")
+            return [
+                PulseMetadataSchema.from_orm(pulse) for pulse in computed_pulse_annotation_qs.all()
+            ]
+        else:
+            return {
+                "error": "Permission denied. You do not own this recording, and it is not public."
+            }
+    except Recording.DoesNotExist:
+        return {"error": "Recording not found"}
 
 
 @router.get("/{pk}/annotations/other_users")
 def get_other_user_annotations(request: HttpRequest, pk: int):
-    recording = get_object_or_404(Recording, pk=pk)
-
-    # Check if the user owns the recording or if the recording is public
-    if recording.owner == request.user or request.user.is_superuser:
-        # Query annotations associated with the recording that are owned by other users
-        annotations_qs = Annotations.objects.filter(recording=recording).exclude(owner=request.user)
-        sequence_qs = SequenceAnnotations.objects.filter(recording=recording).exclude(
-            owner=request.user
-        )
+    try:
+        recording = Recording.objects.get(pk=pk)
 
-        # Create a dictionary to store annotations for each user
-        annotations_by_user = {}
+        # Check if the user owns the recording or if the recording is public
+        if recording.owner == request.user or request.user.is_superuser:
+            # Query annotations associated with the recording that are owned by other users
+            annotations_qs = Annotations.objects.filter(recording=recording).exclude(
+                owner=request.user
+            )
+            sequence_qs = SequenceAnnotations.objects.filter(recording=recording).exclude(
+                owner=request.user
+            )
 
-        # Serialize the annotations using AnnotationSchema
-        for annotation in annotations_qs:
-            user_email = annotation.owner.email
+            # Create a dictionary to store annotations for each user
+            annotations_by_user = {}
 
-            # If user_email is not already a key in the dictionary, initialize it with
-            # an empty list
-            annotations_by_user.setdefault(user_email, {"annotations": [], "sequence": []})
+            # Serialize the annotations using AnnotationSchema
+            for annotation in annotations_qs:
+                user_email = annotation.owner.email
 
-            # Append the annotation to the list for the corresponding user_email
-            annotations_by_user[user_email]["annotations"].append(
-                AnnotationSchema.from_orm(annotation, owner_email=user_email).dict()
-            )
+                # If user_email is not already a key in the dictionary, initialize it with
+                # an empty list
+                annotations_by_user.setdefault(user_email, {"annotations": [], "sequence": []})
 
-        for annotation in sequence_qs:
-            user_email = annotation.owner.email
+                # Append the annotation to the list for the corresponding user_email
+                annotations_by_user[user_email]["annotations"].append(
+                    AnnotationSchema.from_orm(annotation, owner_email=user_email).dict()
+                )
 
-            # If user_email is not already a key in the dictionary, initialize it with
-            # an empty list
-            annotations_by_user.setdefault(user_email, {"annotations": [], "sequence": []})
+            for annotation in sequence_qs:
+                user_email = annotation.owner.email
 
-            # Append the annotation to the list for the corresponding user_email
-            annotations_by_user[user_email]["sequence"].append(
-                SequenceAnnotationSchema.from_orm(annotation, owner_email=user_email).dict()
-            )
+                # If user_email is not already a key in the dictionary, initialize it with
+                # an empty list
+                annotations_by_user.setdefault(user_email, {"annotations": [], "sequence": []})
 
-        return annotations_by_user
-    else:
-        return {"error": "Permission denied. You do not own this recording, and it is not public."}
+                # Append the annotation to the list for the corresponding user_email
+                annotations_by_user[user_email]["sequence"].append(
+                    SequenceAnnotationSchema.from_orm(annotation, owner_email=user_email).dict()
+                )
+
+            return annotations_by_user
+        else:
+            return {
+                "error": "Permission denied. You do not own this recording, and it is not public."
+            }
+
+    except Recording.DoesNotExist:
+        return {"error": "Recording not found"}
 
 
 @router.get("/{pk}/annotations/user/{userId}")
@@ -931,18 +1015,24 @@ def get_user_annotations(
     pk: int,
     userId: int,  # noqa: N803
 ):
-    recording = get_object_or_404(Recording, pk=pk)
+    try:
+        recording = Recording.objects.get(pk=pk)
 
-    # Check if the user owns the recording or if the recording is public
-    if recording.owner == request.user or recording.public:
-        # Query annotations associated with the recording that are owned by the current user
-        annotations_qs = Annotations.objects.filter(recording=recording, owner=userId)
+        # Check if the user owns the recording or if the recording is public
+        if recording.owner == request.user or recording.public:
+            # Query annotations associated with the recording that are owned by the current user
+            annotations_qs = Annotations.objects.filter(recording=recording, owner=userId)
 
-        # Serialize the annotations using AnnotationSchema
-        return [AnnotationSchema.from_orm(annotation).dict() for annotation in annotations_qs]
+            # Serialize the annotations using AnnotationSchema
+            return [AnnotationSchema.from_orm(annotation).dict() for annotation in annotations_qs]
 
-    else:
-        return {"error": "Permission denied. You do not own this recording, and it is not public."}
+        else:
+            return {
+                "error": "Permission denied. You do not own this recording, and it is not public."
+            }
+
+    except Recording.DoesNotExist:
+        return {"error": "Recording not found"}
 
 
 @router.put("/{pk}/annotations")
@@ -952,28 +1042,38 @@ def put_annotation(
     annotation: AnnotationSchema,
     species_ids: list[int],
 ):
-    recording = get_object_or_404(Recording, pk=pk)
-    if recording.owner == request.user or recording.public:
-        # Create a new annotation
-        new_annotation = Annotations.objects.create(
-            recording=recording,
-            owner=request.user,
-            start_time=annotation.start_time,
-            end_time=annotation.end_time,
-            low_freq=annotation.low_freq,
-            high_freq=annotation.high_freq,
-            comments=annotation.comments,
-            type=annotation.type,
-        )
+    try:
+        recording = Recording.objects.get(pk=pk)
+        if recording.owner == request.user or recording.public:
+            # Create a new annotation
+            new_annotation = Annotations.objects.create(
+                recording=recording,
+                owner=request.user,
+                start_time=annotation.start_time,
+                end_time=annotation.end_time,
+                low_freq=annotation.low_freq,
+                high_freq=annotation.high_freq,
+                comments=annotation.comments,
+                type=annotation.type,
+            )
 
-        # Add species to the annotation based on the provided species_ids
-        for species_id in species_ids:
-            species_obj = get_object_or_404(Species, pk=species_id)
-            new_annotation.species.add(species_obj)
+            # Add species to the annotation based on the provided species_ids
+            for species_id in species_ids:
+                try:
+                    species_obj = Species.objects.get(pk=species_id)
+                    new_annotation.species.add(species_obj)
+                except Species.DoesNotExist:
+                    # Handle the case where the species with the given ID doesn't exist
+                    return {"error": f"Species with ID {species_id} not found"}
+
+            return {"message": "Annotation added successfully", "id": new_annotation.pk}
+        else:
+            return {
+                "error": "Permission denied. You do not own this recording, and it is not public."
+            }
 
-        return {"message": "Annotation added successfully", "id": new_annotation.pk}
-    else:
-        return {"error": "Permission denied. You do not own this recording, and it is not public."}
+    except Recording.DoesNotExist:
+        return {"error": "Recording not found"}
 
 
 @router.patch("/{recording_pk}/annotations/{annotation_pk}")
@@ -984,42 +1084,56 @@ def patch_annotation(
     annotation: UpdateAnnotationsSchema,
     species_ids: list[int] | None,
 ):
-    recording = get_object_or_404(Recording, pk=recording_pk)
-
-    # Check if the user owns the recording or if the recording is public
-    if recording.owner == request.user or recording.public:
-        annotation_instance = get_object_or_404(
-            Annotations, pk=annotation_pk, recording=recording, owner=request.user
-        )
+    try:
+        recording = Recording.objects.get(pk=recording_pk)
 
-        # Update annotation details
-        if annotation.start_time is not None:
-            annotation_instance.start_time = annotation.start_time
-        if annotation.end_time:
-            annotation_instance.end_time = annotation.end_time
-        if annotation.low_freq:
-            annotation_instance.low_freq = annotation.low_freq
-        if annotation.high_freq:
-            annotation_instance.high_freq = annotation.high_freq
-        if annotation.type:
-            annotation_instance.type = annotation.type
+        # Check if the user owns the recording or if the recording is public
+        if recording.owner == request.user or recording.public:
+            annotation_instance = Annotations.objects.get(
+                pk=annotation_pk, recording=recording, owner=request.user
+            )
+            if annotation_instance is None:
+                return {"error": "Annotation not found"}
+
+            # Update annotation details
+            if annotation.start_time is not None:
+                annotation_instance.start_time = annotation.start_time
+            if annotation.end_time:
+                annotation_instance.end_time = annotation.end_time
+            if annotation.low_freq:
+                annotation_instance.low_freq = annotation.low_freq
+            if annotation.high_freq:
+                annotation_instance.high_freq = annotation.high_freq
+            if annotation.type:
+                annotation_instance.type = annotation.type
+            else:
+                annotation_instance.type = None
+            if annotation.comments:
+                annotation_instance.comments = annotation.comments
+            annotation_instance.save()
+
+            # Clear existing species associations
+            if species_ids is not None:
+                annotation_instance.species.clear()
+                # Add species to the annotation based on the provided species_ids
+                for species_id in species_ids:
+                    try:
+                        species_obj = Species.objects.get(pk=species_id)
+                        annotation_instance.species.add(species_obj)
+                    except Species.DoesNotExist:
+                        # Handle the case where the species with the given ID doesn't exist
+                        return {"error": f"Species with ID {species_id} not found"}
+
+            return {"message": "Annotation updated successfully", "id": annotation_instance.pk}
         else:
-            annotation_instance.type = None
-        if annotation.comments:
-            annotation_instance.comments = annotation.comments
-        annotation_instance.save()
-
-        # Clear existing species associations
-        if species_ids is not None:
-            annotation_instance.species.clear()
-            # Add species to the annotation based on the provided species_ids
-            for species_id in species_ids:
-                species_obj = get_object_or_404(Species, pk=species_id)
-                annotation_instance.species.add(species_obj)
+            return {
+                "error": "Permission denied. You do not own this recording, and it is not public."
+            }
 
-        return {"message": "Annotation updated successfully", "id": annotation_instance.pk}
-    else:
-        return {"error": "Permission denied. You do not own this recording, and it is not public."}
+    except Recording.DoesNotExist:
+        return {"error": "Recording not found"}
+    except Annotations.DoesNotExist:
+        return {"error": "Annotation not found"}
 
 
 @router.patch("/{recording_pk}/sequence-annotations/{sequence_annotation_pk}")
@@ -1030,56 +1144,76 @@ def patch_sequence_annotation(
     annotation: UpdateSequenceAnnotationSchema,
     species_ids: list[int] | None,
 ):
-    recording = get_object_or_404(Recording, pk=recording_pk)
+    try:
+        recording = Recording.objects.get(pk=recording_pk)
 
-    # Check if the user owns the recording or if the recording is public
-    if recording.owner == request.user or recording.public:
-        annotation_instance = get_object_or_404(
-            SequenceAnnotations, pk=sequence_annotation_pk, recording=recording, owner=request.user
-        )
+        # Check if the user owns the recording or if the recording is public
+        if recording.owner == request.user or recording.public:
+            annotation_instance = SequenceAnnotations.objects.get(
+                pk=sequence_annotation_pk, recording=recording, owner=request.user
+            )
 
-        # Update annotation details
-        if annotation.start_time is not None:
-            annotation_instance.start_time = annotation.start_time
-        if annotation.end_time:
-            annotation_instance.end_time = annotation.end_time
-        if annotation.comments:
-            annotation_instance.comments = annotation.comments
-        if annotation.type:
-            annotation_instance.type = annotation.type
+            # Update annotation details
+            if annotation.start_time is not None:
+                annotation_instance.start_time = annotation.start_time
+            if annotation.end_time:
+                annotation_instance.end_time = annotation.end_time
+            if annotation.comments:
+                annotation_instance.comments = annotation.comments
+            if annotation.type:
+                annotation_instance.type = annotation.type
+            else:
+                annotation_instance.type = None
+            annotation_instance.save()
+
+            # Clear existing species associations
+            if species_ids is not None:
+                annotation_instance.species.clear()
+                # Add species to the annotation based on the provided species_ids
+                for species_id in species_ids:
+                    try:
+                        species_obj = Species.objects.get(pk=species_id)
+                        annotation_instance.species.add(species_obj)
+                    except Species.DoesNotExist:
+                        # Handle the case where the species with the given ID doesn't exist
+                        return {"error": f"Species with ID {species_id} not found"}
+
+            return {"message": "Annotation updated successfully", "id": annotation_instance.pk}
         else:
-            annotation_instance.type = None
-        annotation_instance.save()
-
-        # Clear existing species associations
-        if species_ids is not None:
-            annotation_instance.species.clear()
-            # Add species to the annotation based on the provided species_ids
-            for species_id in species_ids:
-                species_obj = get_object_or_404(Species, pk=species_id)
-                annotation_instance.species.add(species_obj)
+            return {
+                "error": "Permission denied. You do not own this recording, and it is not public."
+            }
 
-        return {"message": "Annotation updated successfully", "id": annotation_instance.pk}
-    else:
-        return {"error": "Permission denied. You do not own this recording, and it is not public."}
+    except Recording.DoesNotExist:
+        return {"error": "Recording not found"}
+    except Annotations.DoesNotExist:
+        return {"error": "Annotation not found"}
 
 
 @router.delete("/{recording_pk}/annotations/{annotation_pk}")
 def delete_annotation(request, recording_pk: int, annotation_pk: int):
-    recording = get_object_or_404(Recording, pk=recording_pk)
+    try:
+        recording = Recording.objects.get(pk=recording_pk)
 
-    # Check if the user owns the recording or if the recording is public
-    if recording.owner == request.user or recording.public:
-        annotation_instance = get_object_or_404(
-            Annotations, pk=annotation_pk, recording=recording, owner=request.user
-        )
+        # Check if the user owns the recording or if the recording is public
+        if recording.owner == request.user or recording.public:
+            annotation_instance = Annotations.objects.get(
+                pk=annotation_pk, recording=recording, owner=request.user
+            )
 
-        # Delete the annotation
-        annotation_instance.delete()
+            # Delete the annotation
+            annotation_instance.delete()
 
-        return {"message": "Annotation deleted successfully"}
-    else:
-        return {"error": "Permission denied. You do not own this recording, and it is not public."}
+            return {"message": "Annotation deleted successfully"}
+        else:
+            return {
+                "error": "Permission denied. You do not own this recording, and it is not public."
+            }
+
+    except Recording.DoesNotExist:
+        return {"error": "Recording not found"}
+    except Annotations.DoesNotExist:
+        return {"error": "Annotation not found"}
 
 
 # SEQUENCE ANNOTATIONS
@@ -1087,21 +1221,29 @@ def delete_annotation(request, recording_pk: int, annotation_pk: int):
 
 @router.get("/{pk}/sequence-annotations")
 def get_sequence_annotations(request: HttpRequest, pk: int):
-    recording = get_object_or_404(Recording, pk=pk)
+    try:
+        recording = Recording.objects.get(pk=pk)
 
-    # Check if the user owns the recording or if the recording is public
-    if recording.owner == request.user or recording.public:
-        # Query annotations associated with the recording that are owned by the current user
-        annotations_qs = SequenceAnnotations.objects.filter(recording=recording, owner=request.user)
+        # Check if the user owns the recording or if the recording is public
+        if recording.owner == request.user or recording.public:
+            # Query annotations associated with the recording that are owned by the current user
+            annotations_qs = SequenceAnnotations.objects.filter(
+                recording=recording, owner=request.user
+            )
 
-        # Serialize the annotations using AnnotationSchema
-        return [
-            SequenceAnnotationSchema.from_orm(annotation, owner_email=request.user.email).dict()
-            for annotation in annotations_qs
-        ]
+            # Serialize the annotations using AnnotationSchema
+            return [
+                SequenceAnnotationSchema.from_orm(annotation, owner_email=request.user.email).dict()
+                for annotation in annotations_qs
+            ]
 
-    else:
-        return {"error": "Permission denied. You do not own this recording, and it is not public."}
+        else:
+            return {
+                "error": "Permission denied. You do not own this recording, and it is not public."
+            }
+
+    except Recording.DoesNotExist:
+        return {"error": "Recording not found"}
 
 
 @router.put("/{pk}/sequence-annotations")
@@ -1111,36 +1253,50 @@ def put_sequence_annotation(
     annotation: SequenceAnnotationSchema,
     species_ids: list[int] | None,
 ):
-    recording = get_object_or_404(Recording, pk=pk)
-    if recording.owner == request.user or recording.public:
-        # Create a new annotation
-        new_annotation = SequenceAnnotations.objects.create(
-            recording=recording,
-            owner=request.user,
-            start_time=annotation.start_time,
-            end_time=annotation.end_time,
-            type=annotation.type,
-            comments=annotation.comments,
-        )
+    try:
+        recording = Recording.objects.get(pk=pk)
+        if recording.owner == request.user or recording.public:
+            # Create a new annotation
+            new_annotation = SequenceAnnotations.objects.create(
+                recording=recording,
+                owner=request.user,
+                start_time=annotation.start_time,
+                end_time=annotation.end_time,
+                type=annotation.type,
+                comments=annotation.comments,
+            )
 
-        return {"message": "Annotation added successfully", "id": new_annotation.pk}
-    else:
-        return {"error": "Permission denied. You do not own this recording, and it is not public."}
+            return {"message": "Annotation added successfully", "id": new_annotation.pk}
+        else:
+            return {
+                "error": "Permission denied. You do not own this recording, and it is not public."
+            }
+
+    except Recording.DoesNotExist:
+        return {"error": "Recording not found"}
 
 
 @router.delete("/{recording_pk}/sequence-annotations/{sequence_annotation_pk}")
 def delete_sequence_annotation(request, recording_pk: int, sequence_annotation_pk: int):
-    recording = get_object_or_404(Recording, pk=recording_pk)
+    try:
+        recording = Recording.objects.get(pk=recording_pk)
 
-    # Check if the user owns the recording or if the recording is public
-    if recording.owner == request.user or recording.public:
-        annotation_instance = get_object_or_404(
-            SequenceAnnotations, pk=sequence_annotation_pk, recording=recording, owner=request.user
-        )
+        # Check if the user owns the recording or if the recording is public
+        if recording.owner == request.user or recording.public:
+            annotation_instance = SequenceAnnotations.objects.get(
+                pk=sequence_annotation_pk, recording=recording, owner=request.user
+            )
 
-        # Delete the annotation
-        annotation_instance.delete()
+            # Delete the annotation
+            annotation_instance.delete()
 
-        return {"message": "Annotation deleted successfully"}
-    else:
-        return {"error": "Permission denied. You do not own this recording, and it is not public."}
+            return {"message": "Annotation deleted successfully"}
+        else:
+            return {
+                "error": "Permission denied. You do not own this recording, and it is not public."
+            }
+
+    except Recording.DoesNotExist:
+        return {"error": "Recording not found"}
+    except Annotations.DoesNotExist:
+        return {"error": "Annotation not found"}
diff --git a/bats_ai/core/views/recording_location.py b/bats_ai/core/views/recording_location.py
new file mode 100644
index 00000000..fb164317
--- /dev/null
+++ b/bats_ai/core/views/recording_location.py
@@ -0,0 +1,260 @@
+from __future__ import annotations
+
+import logging
+from typing import TYPE_CHECKING, Any, Literal
+
+from django.contrib.gis.geos import Polygon
+from django.db.models import Case, IntegerField, Q, QuerySet, Value, When
+from ninja import Query, Router, Schema
+from ninja.errors import HttpError
+
+from bats_ai.core.models import (
+    Configuration,
+    GRTSCells,
+    Recording,
+    RecordingAnnotation,
+)
+
+if TYPE_CHECKING:
+    from django.http import HttpRequest
+
+logger = logging.getLogger(__name__)
+
+router = Router()
+
+# Continental US sample frame ID, defaulting to CONUS GRTS.
+_CONUS_SAMPLE_FRAME_ID = 14
+
+
+class RecordingLocationsQuerySchema(Schema):
+    # When true, exclude recordings the current user has already submitted.
+    exclude_submitted: bool | None = None
+    # Comma-separated tag texts; recording must have all listed tags.
+    tags: str | None = None
+    # Bounding box filter (lon/lat) as `[min_lon, min_lat, max_lon, max_lat]`.
+    bbox: str | None = None
+
+
+class RecordingLocationsFeaturePropertiesSchema(Schema):
+    recording_id: int
+    filename: str
+
+
+class RecordingLocationsFeatureGeometrySchema(Schema):
+    type: Literal["Point"] = "Point"
+    coordinates: list[float]
+
+
+class RecordingLocationsFeatureSchema(Schema):
+    type: Literal["Feature"] = "Feature"
+    geometry: RecordingLocationsFeatureGeometrySchema
+    properties: RecordingLocationsFeaturePropertiesSchema
+
+
+class RecordingLocationsResponseSchema(Schema):
+    type: Literal["FeatureCollection"] = "FeatureCollection"
+    features: list[RecordingLocationsFeatureSchema]
+
+
+def _split_tags(tags: str | None) -> list[str]:
+    if not tags:
+        return []
+    return [t.strip() for t in tags.split(",") if t.strip()]
+
+
+def _apply_recording_filters_and_sort(
+    *,
+    qs: QuerySet[Recording],
+    exclude_submitted: bool,
+    submitted_by_user: QuerySet[int] | None,
+    tags: str | None,
+    bbox_poly: Polygon | None,
+    grts_cell_ids: QuerySet[int] | None,
+) -> QuerySet[Recording]:
+    if exclude_submitted and submitted_by_user is not None:
+        qs = qs.exclude(pk__in=submitted_by_user)
+
+    tag_list = _split_tags(tags)
+    if tag_list:
+        for tag in tag_list:
+            qs = qs.filter(tags__text=tag)
+        qs = qs.distinct()
+
+    if bbox_poly is not None and grts_cell_ids is not None:
+        qs = qs.filter(
+            Q(recording_location__intersects=bbox_poly) | Q(grts_cell_id__in=grts_cell_ids)
+        )
+
+    # Keep deterministic ordering even though we don't expose sorting params.
+    return qs.order_by("-created")
+
+
+def _parse_bbox(bbox: str | None) -> tuple[float, float, float, float] | None:
+    if not bbox:
+        return None
+
+    raw = bbox.strip()
+    # Allow bbox=lon1,lat1,lon2,lat2
+    values = [v.strip() for v in raw.split(",")]
+
+    if not isinstance(values, list) or len(values) != 4:
+        raise HttpError(400, "bbox must contain exactly 4 numbers")
+
+    try:
+        min_lon, min_lat, max_lon, max_lat = (float(v) for v in values)
+    except Exception as e:
+        raise HttpError(400, f"bbox values must be numbers: {e}") from e
+
+    if not (-90.0 <= min_lat <= 90.0 and -90.0 <= max_lat <= 90.0):
+        raise HttpError(400, "bbox latitude values must be within [-90, 90]")
+
+    # Normalize ordering.
+    if min_lon > max_lon:
+        min_lon, max_lon = max_lon, min_lon
+    if min_lat > max_lat:
+        min_lat, max_lat = max_lat, min_lat
+
+    return min_lon, min_lat, max_lon, max_lat
+
+
+def _get_recording_location_coords(recording: Recording) -> list[float] | None:
+    """Return `[lon, lat]` for `Recording.recording_location` if present."""
+    point = recording.recording_location
+    if not point:
+        return None
+
+    # Prefer direct GEOS access instead of serializing geometry to JSON.
+    return [float(point.x), float(point.y)]
+
+
+def _precompute_grts_cell_centroids(
+    cell_ids: set[int],
+) -> dict[int, list[float]]:
+    """Precompute centroid coordinates for each `grts_cell_id`.
+
+    Choose the same "best" cell as `core/views/grts_cells.py` does,
+    then compute `[lon, lat]` from its centroid.
+    """
+    if not cell_ids:
+        return {}
+
+    # Default to Continental US (sample_frame_id=14). We currently only import
+    # CONUS GRTS, so this keeps centroid selection aligned with loaded data.
+    frame_rank = Case(
+        When(sample_frame_id=_CONUS_SAMPLE_FRAME_ID, then=Value(0)),
+        default=Value(1),
+        output_field=IntegerField(),
+    )
+
+    rows = (
+        GRTSCells.objects.filter(
+            grts_cell_id__in=cell_ids,
+            centroid_4326__isnull=False,
+        )
+        .annotate(frame_rank=frame_rank)
+        .order_by("grts_cell_id", "frame_rank")
+        .distinct("grts_cell_id")
+        .values_list("grts_cell_id", "centroid_4326")
+    )
+
+    return {
+        int(cell_id): [float(centroid.x), float(centroid.y)]
+        for cell_id, centroid in rows
+        if centroid is not None
+    }
+
+
+@router.get("/", response=RecordingLocationsResponseSchema)
+def get_recording_locations(
+    request: HttpRequest,
+    q: Query[RecordingLocationsQuerySchema],
+):
+    config = Configuration.objects.first()
+    vetting_enabled = bool(config.mark_annotations_completed_enabled) if config else False
+
+    # Build "full" set: my + shared recordings.
+    my_qs = Recording.objects.filter(owner=request.user)
+    shared_qs = Recording.objects.filter(public=True).exclude(
+        Q(owner=request.user) | Q(spectrogram__isnull=True)
+    )
+
+    exclude_submitted = bool(q.exclude_submitted)
+    submitted_by_user = None
+    if exclude_submitted:
+        submitted_by_user = RecordingAnnotation.objects.filter(
+            owner=request.user, submitted=True
+        ).values_list("recording_id", flat=True)
+
+    bbox = _parse_bbox(q.bbox)
+    bbox_poly: Polygon | None = None
+    grts_cell_ids: QuerySet[int] | None = None
+    if bbox is not None:
+        bbox_poly = Polygon.from_bbox((bbox[0], bbox[1], bbox[2], bbox[3]))
+        grts_cell_ids = GRTSCells.objects.filter(centroid_4326__intersects=bbox_poly).values_list(
+            "grts_cell_id", flat=True
+        )
+
+    my_qs = _apply_recording_filters_and_sort(
+        qs=my_qs,
+        exclude_submitted=exclude_submitted,
+        submitted_by_user=submitted_by_user,
+        tags=q.tags,
+        bbox_poly=bbox_poly,
+        grts_cell_ids=grts_cell_ids,
+    )
+    shared_qs = _apply_recording_filters_and_sort(
+        qs=shared_qs,
+        exclude_submitted=exclude_submitted,
+        submitted_by_user=submitted_by_user,
+        tags=q.tags,
+        bbox_poly=bbox_poly,
+        grts_cell_ids=grts_cell_ids,
+    )
+
+    my_list = list(my_qs.only("id", "audio_file", "recording_location", "grts_cell_id", "created"))
+    shared_list = list(
+        shared_qs.only(
+            "id",
+            "audio_file",
+            "recording_location",
+            "grts_cell_id",
+            "created",
+        )
+    )
+    recordings = my_list + shared_list
+
+    required_cell_ids = {r.grts_cell_id for r in recordings if r.grts_cell_id is not None}
+    centroids_by_cell_id = _precompute_grts_cell_centroids(required_cell_ids)
+
+    features: list[dict[str, Any]] = []
+    for rec in recordings:
+        coords: list[float] | None = None
+
+        if vetting_enabled:
+            # When vetting is enabled, we only show the centroid of the
+            # GRTS cell and not the direct recording location.
+            if rec.grts_cell_id is not None:
+                coords = centroids_by_cell_id.get(rec.grts_cell_id)
+            # If we can't resolve a centroid, fall back to recording_location.
+            if coords is None:
+                coords = _get_recording_location_coords(rec)
+        else:
+            coords = _get_recording_location_coords(rec)
+            if coords is None and rec.grts_cell_id is not None:
+                coords = centroids_by_cell_id.get(rec.grts_cell_id)
+
+        if coords is None:
+            continue
+
+        features.append(
+            {
+                "type": "Feature",
+                "geometry": {"type": "Point", "coordinates": coords},
+                "properties": {
+                    "recording_id": rec.id,
+                    "filename": str(rec.audio_file),
+                },
+            }
+        )
+
+    return {"type": "FeatureCollection", "features": features}

From 649eacd176950a80d9f76a4ce5fb2169a663dbc2 Mon Sep 17 00:00:00 2001
From: Bryon Lewis <Bryon.Lewis@kitware.com>
Date: Wed, 1 Apr 2026 07:45:46 -0400
Subject: [PATCH 16/21] add bbox to neighbors schema

---
 bats_ai/core/views/recording.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/bats_ai/core/views/recording.py b/bats_ai/core/views/recording.py
index 62056286..7cfada1a 100644
--- a/bats_ai/core/views/recording.py
+++ b/bats_ai/core/views/recording.py
@@ -83,7 +83,8 @@ class UnsubmittedNeighborsQuerySchema(Schema):
     ) = "created"
     sort_direction: Literal["asc", "desc"] | None = "desc"
     tags: str | None = None  # Comma-separated tag texts; recording must have all listed tags
-
+    # [min_lon, min_lat, max_lon, max_lat] as JSON array or comma-separated (see _parse_bbox).
+    bbox: str | None = None
 
 class UnsubmittedNeighborsResponse(Schema):
     """Response for unsubmitted neighbors: next and previous recording IDs in the vetting order."""

From 8b3f0d485426aca89a9e69666db04047030ee8b7 Mon Sep 17 00:00:00 2001
From: Bryon Lewis <Bryon.Lewis@kitware.com>
Date: Wed, 1 Apr 2026 07:49:33 -0400
Subject: [PATCH 17/21] linting

---
 bats_ai/core/views/recording.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/bats_ai/core/views/recording.py b/bats_ai/core/views/recording.py
index 7cfada1a..c6b80da3 100644
--- a/bats_ai/core/views/recording.py
+++ b/bats_ai/core/views/recording.py
@@ -86,6 +86,7 @@ class UnsubmittedNeighborsQuerySchema(Schema):
     # [min_lon, min_lat, max_lon, max_lat] as JSON array or comma-separated (see _parse_bbox).
     bbox: str | None = None
 
+
 class UnsubmittedNeighborsResponse(Schema):
     """Response for unsubmitted neighbors: next and previous recording IDs in the vetting order."""
 

From c72a3102a44ddb0bbf2075af5cf8439792122f86 Mon Sep 17 00:00:00 2001
From: Bryon Lewis <Bryon.Lewis@kitware.com>
Date: Wed, 1 Apr 2026 09:07:22 -0400
Subject: [PATCH 18/21] modify default single point size

---
 client/src/components/RecordingLocationsMap.vue | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/client/src/components/RecordingLocationsMap.vue b/client/src/components/RecordingLocationsMap.vue
index 82dde4d8..30dd6a4c 100644
--- a/client/src/components/RecordingLocationsMap.vue
+++ b/client/src/components/RecordingLocationsMap.vue
@@ -192,7 +192,7 @@ export default defineComponent({
             filter: ['!', ['has', 'point_count']],
             paint: {
               'circle-color': '#11b4da',
-              'circle-radius': 5,
+              'circle-radius': 10,
               'circle-stroke-width': 1,
               'circle-stroke-color': '#fff',
             },

From fa0aff79ed08c926e076e2be17c1aa06fb10f5ea Mon Sep 17 00:00:00 2001
From: Bryon Lewis <Bryon.Lewis@kitware.com>
Date: Wed, 1 Apr 2026 10:19:15 -0400
Subject: [PATCH 19/21] pinning maplibre due to a build issue

---
 client/package-lock.json | 262 +++++++++++++++++++++------------------
 client/package.json      |   4 +-
 2 files changed, 145 insertions(+), 121 deletions(-)

diff --git a/client/package-lock.json b/client/package-lock.json
index fa954595..74e77a0e 100644
--- a/client/package-lock.json
+++ b/client/package-lock.json
@@ -19,7 +19,7 @@
         "django-s3-file-field": "1.1.0",
         "geojs": "1.19.0",
         "lodash": "4.17.23",
-        "maplibre-gl": "^5.21.1",
+        "maplibre-gl": "5.17.0",
         "vue": "3.5.30",
         "vue-router": "5.0.4",
         "vuetify": "3.12.3"
@@ -34,7 +34,7 @@
         "eslint-plugin-vue": "10.8.0",
         "sass-embedded": "^1.98.0",
         "typescript": "5.9.3",
-        "vite": "8.0.2",
+        "vite": "8.0.3",
         "vite-plugin-vuetify": "2.1.3",
         "vue-tsc": "3.2.6"
       }
@@ -1642,22 +1642,24 @@
       }
     },
     "node_modules/@emnapi/core": {
-      "version": "1.9.0",
-      "resolved": "https://registry.npmjs.org/@emnapi/core/-/core-1.9.0.tgz",
-      "integrity": "sha512-0DQ98G9ZQZOxfUcQn1waV2yS8aWdZ6kJMbYCJB3oUBecjWYO1fqJ+a1DRfPF3O5JEkwqwP1A9QEN/9mYm2Yd0w==",
+      "version": "1.9.1",
+      "resolved": "https://registry.npmjs.org/@emnapi/core/-/core-1.9.1.tgz",
+      "integrity": "sha512-mukuNALVsoix/w1BJwFzwXBN/dHeejQtuVzcDsfOEsdpCumXb/E9j8w11h5S54tT1xhifGfbbSm/ICrObRb3KA==",
       "license": "MIT",
       "optional": true,
+      "peer": true,
       "dependencies": {
         "@emnapi/wasi-threads": "1.2.0",
         "tslib": "^2.4.0"
       }
     },
     "node_modules/@emnapi/runtime": {
-      "version": "1.9.0",
-      "resolved": "https://registry.npmjs.org/@emnapi/runtime/-/runtime-1.9.0.tgz",
-      "integrity": "sha512-QN75eB0IH2ywSpRpNddCRfQIhmJYBCJ1x5Lb3IscKAL8bMnVAKnRg8dCoXbHzVLLH7P38N2Z3mtulB7W0J0FKw==",
+      "version": "1.9.1",
+      "resolved": "https://registry.npmjs.org/@emnapi/runtime/-/runtime-1.9.1.tgz",
+      "integrity": "sha512-VYi5+ZVLhpgK4hQ0TAjiQiZ6ol0oe4mBx7mVv7IflsiEp0OWoVsp/+f9Vc1hOhE0TtkORVrI1GvzyreqpgWtkA==",
       "license": "MIT",
       "optional": true,
+      "peer": true,
       "dependencies": {
         "tslib": "^2.4.0"
       }
@@ -1668,6 +1670,7 @@
       "integrity": "sha512-N10dEJNSsUx41Z6pZsXU8FjPjpBEplgH24sfkmITrBED1/U2Esum9F3lfLrMjKHHjmi557zQn7kR9R+XWXu5Rg==",
       "license": "MIT",
       "optional": true,
+      "peer": true,
       "dependencies": {
         "tslib": "^2.4.0"
       }
@@ -1881,6 +1884,19 @@
         "node": ">=v12.0.0"
       }
     },
+    "node_modules/@mapbox/geojson-rewind": {
+      "version": "0.5.2",
+      "resolved": "https://registry.npmjs.org/@mapbox/geojson-rewind/-/geojson-rewind-0.5.2.tgz",
+      "integrity": "sha512-tJaT+RbYGJYStt7wI3cq4Nl4SXxG8W7JDG5DMJu97V25RnbNg3QtQtf+KD+VLjNpWKYsRvXDNmNrBgEETr1ifA==",
+      "license": "ISC",
+      "dependencies": {
+        "get-stream": "^6.0.1",
+        "minimist": "^1.2.6"
+      },
+      "bin": {
+        "geojson-rewind": "geojson-rewind"
+      }
+    },
     "node_modules/@mapbox/jsonlint-lines-primitives": {
       "version": "2.0.2",
       "resolved": "https://registry.npmjs.org/@mapbox/jsonlint-lines-primitives/-/jsonlint-lines-primitives-2.0.2.tgz",
@@ -1928,13 +1944,10 @@
       }
     },
     "node_modules/@maplibre/geojson-vt": {
-      "version": "6.0.4",
-      "resolved": "https://registry.npmjs.org/@maplibre/geojson-vt/-/geojson-vt-6.0.4.tgz",
-      "integrity": "sha512-HYv3POhMRCdhP3UPPATM/hfcy6/WuVIf5FKboH8u/ZuFMTnAIcSVlq5nfOqroLokd925w2QtE7YwquFOIacwVQ==",
-      "license": "ISC",
-      "dependencies": {
-        "kdbush": "^4.0.2"
-      }
+      "version": "5.0.4",
+      "resolved": "https://registry.npmjs.org/@maplibre/geojson-vt/-/geojson-vt-5.0.4.tgz",
+      "integrity": "sha512-KGg9sma45S+stfH9vPCJk1J0lSDLWZgCT9Y8u8qWZJyjFlP8MNP1WGTxIMYJZjDvVT3PDn05kN1C95Sut1HpgQ==",
+      "license": "ISC"
     },
     "node_modules/@maplibre/maplibre-gl-style-spec": {
       "version": "24.7.0",
@@ -1980,12 +1993,6 @@
         "supercluster": "^8.0.1"
       }
     },
-    "node_modules/@maplibre/vt-pbf/node_modules/@maplibre/geojson-vt": {
-      "version": "5.0.4",
-      "resolved": "https://registry.npmjs.org/@maplibre/geojson-vt/-/geojson-vt-5.0.4.tgz",
-      "integrity": "sha512-KGg9sma45S+stfH9vPCJk1J0lSDLWZgCT9Y8u8qWZJyjFlP8MNP1WGTxIMYJZjDvVT3PDn05kN1C95Sut1HpgQ==",
-      "license": "ISC"
-    },
     "node_modules/@mdi/font": {
       "version": "7.4.47",
       "resolved": "https://registry.npmjs.org/@mdi/font/-/font-7.4.47.tgz",
@@ -2009,6 +2016,24 @@
         "node": ">= 10"
       }
     },
+    "node_modules/@napi-rs/wasm-runtime": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/@napi-rs/wasm-runtime/-/wasm-runtime-1.1.2.tgz",
+      "integrity": "sha512-sNXv5oLJ7ob93xkZ1XnxisYhGYXfaG9f65/ZgYuAu3qt7b3NadcOEhLvx28hv31PgX8SZJRYrAIPQilQmFpLVw==",
+      "license": "MIT",
+      "optional": true,
+      "dependencies": {
+        "@tybys/wasm-util": "^0.10.1"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/Brooooooklyn"
+      },
+      "peerDependencies": {
+        "@emnapi/core": "^1.7.1",
+        "@emnapi/runtime": "^1.7.1"
+      }
+    },
     "node_modules/@nodelib/fs.scandir": {
       "version": "2.1.5",
       "resolved": "https://registry.npmjs.org/@nodelib/fs.scandir/-/fs.scandir-2.1.5.tgz",
@@ -2432,9 +2457,9 @@
       }
     },
     "node_modules/@rolldown/binding-android-arm64": {
-      "version": "1.0.0-rc.11",
-      "resolved": "https://registry.npmjs.org/@rolldown/binding-android-arm64/-/binding-android-arm64-1.0.0-rc.11.tgz",
-      "integrity": "sha512-SJ+/g+xNnOh6NqYxD0V3uVN4W3VfnrGsC9/hoglicgTNfABFG9JjISvkkU0dNY84MNHLWyOgxP9v9Y9pX4S7+A==",
+      "version": "1.0.0-rc.12",
+      "resolved": "https://registry.npmjs.org/@rolldown/binding-android-arm64/-/binding-android-arm64-1.0.0-rc.12.tgz",
+      "integrity": "sha512-pv1y2Fv0JybcykuiiD3qBOBdz6RteYojRFY1d+b95WVuzx211CRh+ytI/+9iVyWQ6koTh5dawe4S/yRfOFjgaA==",
       "cpu": [
         "arm64"
       ],
@@ -2448,9 +2473,9 @@
       }
     },
     "node_modules/@rolldown/binding-darwin-arm64": {
-      "version": "1.0.0-rc.11",
-      "resolved": "https://registry.npmjs.org/@rolldown/binding-darwin-arm64/-/binding-darwin-arm64-1.0.0-rc.11.tgz",
-      "integrity": "sha512-7WQgR8SfOPwmDZGFkThUvsmd/nwAWv91oCO4I5LS7RKrssPZmOt7jONN0cW17ydGC1n/+puol1IpoieKqQidmg==",
+      "version": "1.0.0-rc.12",
+      "resolved": "https://registry.npmjs.org/@rolldown/binding-darwin-arm64/-/binding-darwin-arm64-1.0.0-rc.12.tgz",
+      "integrity": "sha512-cFYr6zTG/3PXXF3pUO+umXxt1wkRK/0AYT8lDwuqvRC+LuKYWSAQAQZjCWDQpAH172ZV6ieYrNnFzVVcnSflAg==",
       "cpu": [
         "arm64"
       ],
@@ -2464,9 +2489,9 @@
       }
     },
     "node_modules/@rolldown/binding-darwin-x64": {
-      "version": "1.0.0-rc.11",
-      "resolved": "https://registry.npmjs.org/@rolldown/binding-darwin-x64/-/binding-darwin-x64-1.0.0-rc.11.tgz",
-      "integrity": "sha512-39Ks6UvIHq4rEogIfQBoBRusj0Q0nPVWIvqmwBLaT6aqQGIakHdESBVOPRRLacy4WwUPIx4ZKzfZ9PMW+IeyUQ==",
+      "version": "1.0.0-rc.12",
+      "resolved": "https://registry.npmjs.org/@rolldown/binding-darwin-x64/-/binding-darwin-x64-1.0.0-rc.12.tgz",
+      "integrity": "sha512-ZCsYknnHzeXYps0lGBz8JrF37GpE9bFVefrlmDrAQhOEi4IOIlcoU1+FwHEtyXGx2VkYAvhu7dyBf75EJQffBw==",
       "cpu": [
         "x64"
       ],
@@ -2480,9 +2505,9 @@
       }
     },
     "node_modules/@rolldown/binding-freebsd-x64": {
-      "version": "1.0.0-rc.11",
-      "resolved": "https://registry.npmjs.org/@rolldown/binding-freebsd-x64/-/binding-freebsd-x64-1.0.0-rc.11.tgz",
-      "integrity": "sha512-jfsm0ZHfhiqrvWjJAmzsqiIFPz5e7mAoCOPBNTcNgkiid/LaFKiq92+0ojH+nmJmKYkre4t71BWXUZDNp7vsag==",
+      "version": "1.0.0-rc.12",
+      "resolved": "https://registry.npmjs.org/@rolldown/binding-freebsd-x64/-/binding-freebsd-x64-1.0.0-rc.12.tgz",
+      "integrity": "sha512-dMLeprcVsyJsKolRXyoTH3NL6qtsT0Y2xeuEA8WQJquWFXkEC4bcu1rLZZSnZRMtAqwtrF/Ib9Ddtpa/Gkge9Q==",
       "cpu": [
         "x64"
       ],
@@ -2496,9 +2521,9 @@
       }
     },
     "node_modules/@rolldown/binding-linux-arm-gnueabihf": {
-      "version": "1.0.0-rc.11",
-      "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-arm-gnueabihf/-/binding-linux-arm-gnueabihf-1.0.0-rc.11.tgz",
-      "integrity": "sha512-zjQaUtSyq1nVe3nxmlSCuR96T1LPlpvmJ0SZy0WJFEsV4kFbXcq2u68L4E6O0XeFj4aex9bEauqjW8UQBeAvfQ==",
+      "version": "1.0.0-rc.12",
+      "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-arm-gnueabihf/-/binding-linux-arm-gnueabihf-1.0.0-rc.12.tgz",
+      "integrity": "sha512-YqWjAgGC/9M1lz3GR1r1rP79nMgo3mQiiA+Hfo+pvKFK1fAJ1bCi0ZQVh8noOqNacuY1qIcfyVfP6HoyBRZ85Q==",
       "cpu": [
         "arm"
       ],
@@ -2512,9 +2537,9 @@
       }
     },
     "node_modules/@rolldown/binding-linux-arm64-gnu": {
-      "version": "1.0.0-rc.11",
-      "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-arm64-gnu/-/binding-linux-arm64-gnu-1.0.0-rc.11.tgz",
-      "integrity": "sha512-WMW1yE6IOnehTcFE9eipFkm3XN63zypWlrJQ2iF7NrQ9b2LDRjumFoOGJE8RJJTJCTBAdmLMnJ8uVitACUUo1Q==",
+      "version": "1.0.0-rc.12",
+      "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-arm64-gnu/-/binding-linux-arm64-gnu-1.0.0-rc.12.tgz",
+      "integrity": "sha512-/I5AS4cIroLpslsmzXfwbe5OmWvSsrFuEw3mwvbQ1kDxJ822hFHIx+vsN/TAzNVyepI/j/GSzrtCIwQPeKCLIg==",
       "cpu": [
         "arm64"
       ],
@@ -2528,9 +2553,9 @@
       }
     },
     "node_modules/@rolldown/binding-linux-arm64-musl": {
-      "version": "1.0.0-rc.11",
-      "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-arm64-musl/-/binding-linux-arm64-musl-1.0.0-rc.11.tgz",
-      "integrity": "sha512-jfndI9tsfm4APzjNt6QdBkYwre5lRPUgHeDHoI7ydKUuJvz3lZeCfMsI56BZj+7BYqiKsJm7cfd/6KYV7ubrBg==",
+      "version": "1.0.0-rc.12",
+      "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-arm64-musl/-/binding-linux-arm64-musl-1.0.0-rc.12.tgz",
+      "integrity": "sha512-V6/wZztnBqlx5hJQqNWwFdxIKN0m38p8Jas+VoSfgH54HSj9tKTt1dZvG6JRHcjh6D7TvrJPWFGaY9UBVOaWPw==",
       "cpu": [
         "arm64"
       ],
@@ -2544,9 +2569,9 @@
       }
     },
     "node_modules/@rolldown/binding-linux-ppc64-gnu": {
-      "version": "1.0.0-rc.11",
-      "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-ppc64-gnu/-/binding-linux-ppc64-gnu-1.0.0-rc.11.tgz",
-      "integrity": "sha512-ZlFgw46NOAGMgcdvdYwAGu2Q+SLFA9LzbJLW+iyMOJyhj5wk6P3KEE9Gct4xWwSzFoPI7JCdYmYMzVtlgQ+zfw==",
+      "version": "1.0.0-rc.12",
+      "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-ppc64-gnu/-/binding-linux-ppc64-gnu-1.0.0-rc.12.tgz",
+      "integrity": "sha512-AP3E9BpcUYliZCxa3w5Kwj9OtEVDYK6sVoUzy4vTOJsjPOgdaJZKFmN4oOlX0Wp0RPV2ETfmIra9x1xuayFB7g==",
       "cpu": [
         "ppc64"
       ],
@@ -2560,9 +2585,9 @@
       }
     },
     "node_modules/@rolldown/binding-linux-s390x-gnu": {
-      "version": "1.0.0-rc.11",
-      "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-s390x-gnu/-/binding-linux-s390x-gnu-1.0.0-rc.11.tgz",
-      "integrity": "sha512-hIOYmuT6ofM4K04XAZd3OzMySEO4K0/nc9+jmNcxNAxRi6c5UWpqfw3KMFV4MVFWL+jQsSh+bGw2VqmaPMTLyw==",
+      "version": "1.0.0-rc.12",
+      "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-s390x-gnu/-/binding-linux-s390x-gnu-1.0.0-rc.12.tgz",
+      "integrity": "sha512-nWwpvUSPkoFmZo0kQazZYOrT7J5DGOJ/+QHHzjvNlooDZED8oH82Yg67HvehPPLAg5fUff7TfWFHQS8IV1n3og==",
       "cpu": [
         "s390x"
       ],
@@ -2576,9 +2601,9 @@
       }
     },
     "node_modules/@rolldown/binding-linux-x64-gnu": {
-      "version": "1.0.0-rc.11",
-      "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-x64-gnu/-/binding-linux-x64-gnu-1.0.0-rc.11.tgz",
-      "integrity": "sha512-qXBQQO9OvkjjQPLdUVr7Nr2t3QTZI7s4KZtfw7HzBgjbmAPSFwSv4rmET9lLSgq3rH/ndA3ngv3Qb8l2njoPNA==",
+      "version": "1.0.0-rc.12",
+      "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-x64-gnu/-/binding-linux-x64-gnu-1.0.0-rc.12.tgz",
+      "integrity": "sha512-RNrafz5bcwRy+O9e6P8Z/OCAJW/A+qtBczIqVYwTs14pf4iV1/+eKEjdOUta93q2TsT/FI0XYDP3TCky38LMAg==",
       "cpu": [
         "x64"
       ],
@@ -2592,9 +2617,9 @@
       }
     },
     "node_modules/@rolldown/binding-linux-x64-musl": {
-      "version": "1.0.0-rc.11",
-      "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-x64-musl/-/binding-linux-x64-musl-1.0.0-rc.11.tgz",
-      "integrity": "sha512-/tpFfoSTzUkH9LPY+cYbqZBDyyX62w5fICq9qzsHLL8uTI6BHip3Q9Uzft0wylk/i8OOwKik8OxW+QAhDmzwmg==",
+      "version": "1.0.0-rc.12",
+      "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-x64-musl/-/binding-linux-x64-musl-1.0.0-rc.12.tgz",
+      "integrity": "sha512-Jpw/0iwoKWx3LJ2rc1yjFrj+T7iHZn2JDg1Yny1ma0luviFS4mhAIcd1LFNxK3EYu3DHWCps0ydXQ5i/rrJ2ig==",
       "cpu": [
         "x64"
       ],
@@ -2608,9 +2633,9 @@
       }
     },
     "node_modules/@rolldown/binding-openharmony-arm64": {
-      "version": "1.0.0-rc.11",
-      "resolved": "https://registry.npmjs.org/@rolldown/binding-openharmony-arm64/-/binding-openharmony-arm64-1.0.0-rc.11.tgz",
-      "integrity": "sha512-mcp3Rio2w72IvdZG0oQ4bM2c2oumtwHfUfKncUM6zGgz0KgPz4YmDPQfnXEiY5t3+KD/i8HG2rOB/LxdmieK2g==",
+      "version": "1.0.0-rc.12",
+      "resolved": "https://registry.npmjs.org/@rolldown/binding-openharmony-arm64/-/binding-openharmony-arm64-1.0.0-rc.12.tgz",
+      "integrity": "sha512-vRugONE4yMfVn0+7lUKdKvN4D5YusEiPilaoO2sgUWpCvrncvWgPMzK00ZFFJuiPgLwgFNP5eSiUlv2tfc+lpA==",
       "cpu": [
         "arm64"
       ],
@@ -2624,9 +2649,9 @@
       }
     },
     "node_modules/@rolldown/binding-wasm32-wasi": {
-      "version": "1.0.0-rc.11",
-      "resolved": "https://registry.npmjs.org/@rolldown/binding-wasm32-wasi/-/binding-wasm32-wasi-1.0.0-rc.11.tgz",
-      "integrity": "sha512-LXk5Hii1Ph9asuGRjBuz8TUxdc1lWzB7nyfdoRgI0WGPZKmCxvlKk8KfYysqtr4MfGElu/f/pEQRh8fcEgkrWw==",
+      "version": "1.0.0-rc.12",
+      "resolved": "https://registry.npmjs.org/@rolldown/binding-wasm32-wasi/-/binding-wasm32-wasi-1.0.0-rc.12.tgz",
+      "integrity": "sha512-ykGiLr/6kkiHc0XnBfmFJuCjr5ZYKKofkx+chJWDjitX+KsJuAmrzWhwyOMSHzPhzOHOy7u9HlFoa5MoAOJ/Zg==",
       "cpu": [
         "wasm32"
       ],
@@ -2639,26 +2664,10 @@
         "node": ">=14.0.0"
       }
     },
-    "node_modules/@rolldown/binding-wasm32-wasi/node_modules/@napi-rs/wasm-runtime": {
-      "version": "1.1.1",
-      "resolved": "https://registry.npmjs.org/@napi-rs/wasm-runtime/-/wasm-runtime-1.1.1.tgz",
-      "integrity": "sha512-p64ah1M1ld8xjWv3qbvFwHiFVWrq1yFvV4f7w+mzaqiR4IlSgkqhcRdHwsGgomwzBH51sRY4NEowLxnaBjcW/A==",
-      "license": "MIT",
-      "optional": true,
-      "dependencies": {
-        "@emnapi/core": "^1.7.1",
-        "@emnapi/runtime": "^1.7.1",
-        "@tybys/wasm-util": "^0.10.1"
-      },
-      "funding": {
-        "type": "github",
-        "url": "https://github.com/sponsors/Brooooooklyn"
-      }
-    },
     "node_modules/@rolldown/binding-win32-arm64-msvc": {
-      "version": "1.0.0-rc.11",
-      "resolved": "https://registry.npmjs.org/@rolldown/binding-win32-arm64-msvc/-/binding-win32-arm64-msvc-1.0.0-rc.11.tgz",
-      "integrity": "sha512-dDwf5otnx0XgRY1yqxOC4ITizcdzS/8cQ3goOWv3jFAo4F+xQYni+hnMuO6+LssHHdJW7+OCVL3CoU4ycnh35Q==",
+      "version": "1.0.0-rc.12",
+      "resolved": "https://registry.npmjs.org/@rolldown/binding-win32-arm64-msvc/-/binding-win32-arm64-msvc-1.0.0-rc.12.tgz",
+      "integrity": "sha512-5eOND4duWkwx1AzCxadcOrNeighiLwMInEADT0YM7xeEOOFcovWZCq8dadXgcRHSf3Ulh1kFo/qvzoFiCLOL1Q==",
       "cpu": [
         "arm64"
       ],
@@ -2672,9 +2681,9 @@
       }
     },
     "node_modules/@rolldown/binding-win32-x64-msvc": {
-      "version": "1.0.0-rc.11",
-      "resolved": "https://registry.npmjs.org/@rolldown/binding-win32-x64-msvc/-/binding-win32-x64-msvc-1.0.0-rc.11.tgz",
-      "integrity": "sha512-LN4/skhSggybX71ews7dAj6r2geaMJfm3kMbK2KhFMg9B10AZXnKoLCVVgzhMHL0S+aKtr4p8QbAW8k+w95bAA==",
+      "version": "1.0.0-rc.12",
+      "resolved": "https://registry.npmjs.org/@rolldown/binding-win32-x64-msvc/-/binding-win32-x64-msvc-1.0.0-rc.12.tgz",
+      "integrity": "sha512-PyqoipaswDLAZtot351MLhrlrh6lcZPo2LSYE+VDxbVk24LVKAGOuE4hb8xZQmrPAuEtTZW8E6D2zc5EUZX4Lw==",
       "cpu": [
         "x64"
       ],
@@ -6038,6 +6047,18 @@
         "node": ">= 0.4"
       }
     },
+    "node_modules/get-stream": {
+      "version": "6.0.1",
+      "resolved": "https://registry.npmjs.org/get-stream/-/get-stream-6.0.1.tgz",
+      "integrity": "sha512-ts6Wi+2j3jQjqi70w5AlN8DFnkSwC+MqmxEzdEALB2qXZYV3X/b1CTfgPLGJNMeAWxdPfU8FO1ms3NUfaHCPYg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
     "node_modules/github-from-package": {
       "version": "0.0.0",
       "resolved": "https://registry.npmjs.org/github-from-package/-/github-from-package-0.0.0.tgz",
@@ -6807,22 +6828,24 @@
       }
     },
     "node_modules/maplibre-gl": {
-      "version": "5.21.1",
-      "resolved": "https://registry.npmjs.org/maplibre-gl/-/maplibre-gl-5.21.1.tgz",
-      "integrity": "sha512-zto1RTnFkOpOO1bm93ElCXF1huey2N4LvXaGLMFcYAu9txh0OhGIdX1q3LZLkrMKgMxMeYduaQo+DVNzg098fg==",
+      "version": "5.17.0",
+      "resolved": "https://registry.npmjs.org/maplibre-gl/-/maplibre-gl-5.17.0.tgz",
+      "integrity": "sha512-gwS6NpXBfWD406dtT5YfEpl2hmpMm+wcPqf04UAez/TxY1OBjiMdK2ZoMGcNIlGHelKc4+Uet6zhDdDEnlJVHA==",
       "license": "BSD-3-Clause",
       "dependencies": {
+        "@mapbox/geojson-rewind": "^0.5.2",
         "@mapbox/jsonlint-lines-primitives": "^2.0.2",
         "@mapbox/point-geometry": "^1.1.0",
         "@mapbox/tiny-sdf": "^2.0.7",
         "@mapbox/unitbezier": "^0.0.1",
         "@mapbox/vector-tile": "^2.0.4",
         "@mapbox/whoots-js": "^3.1.0",
-        "@maplibre/geojson-vt": "^6.0.4",
-        "@maplibre/maplibre-gl-style-spec": "^24.7.0",
-        "@maplibre/mlt": "^1.1.8",
-        "@maplibre/vt-pbf": "^4.3.0",
+        "@maplibre/geojson-vt": "^5.0.4",
+        "@maplibre/maplibre-gl-style-spec": "^24.4.1",
+        "@maplibre/mlt": "^1.1.2",
+        "@maplibre/vt-pbf": "^4.2.1",
         "@types/geojson": "^7946.0.16",
+        "@types/supercluster": "^7.1.3",
         "earcut": "^3.0.2",
         "gl-matrix": "^3.4.4",
         "kdbush": "^4.0.2",
@@ -6830,6 +6853,7 @@
         "pbf": "^4.0.1",
         "potpack": "^2.1.0",
         "quickselect": "^3.0.0",
+        "supercluster": "^8.0.1",
         "tinyqueue": "^3.0.0"
       },
       "engines": {
@@ -7315,9 +7339,9 @@
       "license": "ISC"
     },
     "node_modules/picomatch": {
-      "version": "4.0.3",
-      "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.3.tgz",
-      "integrity": "sha512-5gTmgEY/sqK6gFXLIsQNH19lWb4ebPDLA4SdLP7dsWkIXHWlG66oPuVvXSGFPppYZz8ZDZq0dYYrbHfBCVUb1Q==",
+      "version": "4.0.4",
+      "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.4.tgz",
+      "integrity": "sha512-QP88BAKvMam/3NxH6vj2o21R6MjxZUAd6nlwAS/pnGvN9IVLocLHxGYIzFhg6fUQ+5th6P4dv4eW9jX3DSIj7A==",
       "license": "MIT",
       "engines": {
         "node": ">=12"
@@ -7703,14 +7727,14 @@
       "license": "Unlicense"
     },
     "node_modules/rolldown": {
-      "version": "1.0.0-rc.11",
-      "resolved": "https://registry.npmjs.org/rolldown/-/rolldown-1.0.0-rc.11.tgz",
-      "integrity": "sha512-NRjoKMusSjfRbSYiH3VSumlkgFe7kYAa3pzVOsVYVFY3zb5d7nS+a3KGQ7hJKXuYWbzJKPVQ9Wxq2UvyK+ENpw==",
+      "version": "1.0.0-rc.12",
+      "resolved": "https://registry.npmjs.org/rolldown/-/rolldown-1.0.0-rc.12.tgz",
+      "integrity": "sha512-yP4USLIMYrwpPHEFB5JGH1uxhcslv6/hL0OyvTuY+3qlOSJvZ7ntYnoWpehBxufkgN0cvXxppuTu5hHa/zPh+A==",
       "devOptional": true,
       "license": "MIT",
       "dependencies": {
         "@oxc-project/types": "=0.122.0",
-        "@rolldown/pluginutils": "1.0.0-rc.11"
+        "@rolldown/pluginutils": "1.0.0-rc.12"
       },
       "bin": {
         "rolldown": "bin/cli.mjs"
@@ -7719,27 +7743,27 @@
         "node": "^20.19.0 || >=22.12.0"
       },
       "optionalDependencies": {
-        "@rolldown/binding-android-arm64": "1.0.0-rc.11",
-        "@rolldown/binding-darwin-arm64": "1.0.0-rc.11",
-        "@rolldown/binding-darwin-x64": "1.0.0-rc.11",
-        "@rolldown/binding-freebsd-x64": "1.0.0-rc.11",
-        "@rolldown/binding-linux-arm-gnueabihf": "1.0.0-rc.11",
-        "@rolldown/binding-linux-arm64-gnu": "1.0.0-rc.11",
-        "@rolldown/binding-linux-arm64-musl": "1.0.0-rc.11",
-        "@rolldown/binding-linux-ppc64-gnu": "1.0.0-rc.11",
-        "@rolldown/binding-linux-s390x-gnu": "1.0.0-rc.11",
-        "@rolldown/binding-linux-x64-gnu": "1.0.0-rc.11",
-        "@rolldown/binding-linux-x64-musl": "1.0.0-rc.11",
-        "@rolldown/binding-openharmony-arm64": "1.0.0-rc.11",
-        "@rolldown/binding-wasm32-wasi": "1.0.0-rc.11",
-        "@rolldown/binding-win32-arm64-msvc": "1.0.0-rc.11",
-        "@rolldown/binding-win32-x64-msvc": "1.0.0-rc.11"
+        "@rolldown/binding-android-arm64": "1.0.0-rc.12",
+        "@rolldown/binding-darwin-arm64": "1.0.0-rc.12",
+        "@rolldown/binding-darwin-x64": "1.0.0-rc.12",
+        "@rolldown/binding-freebsd-x64": "1.0.0-rc.12",
+        "@rolldown/binding-linux-arm-gnueabihf": "1.0.0-rc.12",
+        "@rolldown/binding-linux-arm64-gnu": "1.0.0-rc.12",
+        "@rolldown/binding-linux-arm64-musl": "1.0.0-rc.12",
+        "@rolldown/binding-linux-ppc64-gnu": "1.0.0-rc.12",
+        "@rolldown/binding-linux-s390x-gnu": "1.0.0-rc.12",
+        "@rolldown/binding-linux-x64-gnu": "1.0.0-rc.12",
+        "@rolldown/binding-linux-x64-musl": "1.0.0-rc.12",
+        "@rolldown/binding-openharmony-arm64": "1.0.0-rc.12",
+        "@rolldown/binding-wasm32-wasi": "1.0.0-rc.12",
+        "@rolldown/binding-win32-arm64-msvc": "1.0.0-rc.12",
+        "@rolldown/binding-win32-x64-msvc": "1.0.0-rc.12"
       }
     },
     "node_modules/rolldown/node_modules/@rolldown/pluginutils": {
-      "version": "1.0.0-rc.11",
-      "resolved": "https://registry.npmjs.org/@rolldown/pluginutils/-/pluginutils-1.0.0-rc.11.tgz",
-      "integrity": "sha512-xQO9vbwBecJRv9EUcQ/y0dzSTJgA7Q6UVN7xp6B81+tBGSLVAK03yJ9NkJaUA7JFD91kbjxRSC/mDnmvXzbHoQ==",
+      "version": "1.0.0-rc.12",
+      "resolved": "https://registry.npmjs.org/@rolldown/pluginutils/-/pluginutils-1.0.0-rc.12.tgz",
+      "integrity": "sha512-HHMwmarRKvoFsJorqYlFeFRzXZqCt2ETQlEDOb9aqssrnVBB1/+xgTGtuTrIk5vzLNX1MjMtTf7W9z3tsSbrxw==",
       "devOptional": true,
       "license": "MIT"
     },
@@ -8780,16 +8804,16 @@
       "license": "MIT"
     },
     "node_modules/vite": {
-      "version": "8.0.2",
-      "resolved": "https://registry.npmjs.org/vite/-/vite-8.0.2.tgz",
-      "integrity": "sha512-1gFhNi+bHhRE/qKZOJXACm6tX4bA3Isy9KuKF15AgSRuRazNBOJfdDemPBU16/mpMxApDPrWvZ08DcLPEoRnuA==",
+      "version": "8.0.3",
+      "resolved": "https://registry.npmjs.org/vite/-/vite-8.0.3.tgz",
+      "integrity": "sha512-B9ifbFudT1TFhfltfaIPgjo9Z3mDynBTJSUYxTjOQruf/zHH+ezCQKcoqO+h7a9Pw9Nm/OtlXAiGT1axBgwqrQ==",
       "devOptional": true,
       "license": "MIT",
       "dependencies": {
         "lightningcss": "^1.32.0",
-        "picomatch": "^4.0.3",
+        "picomatch": "^4.0.4",
         "postcss": "^8.5.8",
-        "rolldown": "1.0.0-rc.11",
+        "rolldown": "1.0.0-rc.12",
         "tinyglobby": "^0.2.15"
       },
       "bin": {
diff --git a/client/package.json b/client/package.json
index 97fbf158..8512561b 100644
--- a/client/package.json
+++ b/client/package.json
@@ -24,7 +24,7 @@
     "django-s3-file-field": "1.1.0",
     "geojs": "1.19.0",
     "lodash": "4.17.23",
-    "maplibre-gl": "^5.21.1",
+    "maplibre-gl": "5.17.0",
     "vue": "3.5.30",
     "vue-router": "5.0.4",
     "vuetify": "3.12.3"
@@ -39,7 +39,7 @@
     "eslint-plugin-vue": "10.8.0",
     "sass-embedded": "^1.98.0",
     "typescript": "5.9.3",
-    "vite": "8.0.2",
+    "vite": "8.0.3",
     "vite-plugin-vuetify": "2.1.3",
     "vue-tsc": "3.2.6"
   }

From d033a85bd17891120372ec9c05b05299188c68a3 Mon Sep 17 00:00:00 2001
From: Bryon Lewis <61746913+BryonLewis@users.noreply.github.com>
Date: Thu, 2 Apr 2026 13:00:15 -0400
Subject: [PATCH 20/21] Update client/src/use/useState.ts

Co-authored-by: Michael Nagler <mike.nagler@kitware.com>
---
 client/src/use/useState.ts | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/client/src/use/useState.ts b/client/src/use/useState.ts
index 4922f053..a90e2b35 100644
--- a/client/src/use/useState.ts
+++ b/client/src/use/useState.ts
@@ -237,9 +237,9 @@ export default function useState() {
     localStorage.setItem(MAP_FILTER_BOUNDS_STORAGE_KEY, JSON.stringify(bounds));
   }
 
-function clearMapFilterBounds() {
-  localStorage.removeItem(MAP_FILTER_BOUNDS_STORAGE_KEY);
-}
+  function clearMapFilterBounds() {
+    localStorage.removeItem(MAP_FILTER_BOUNDS_STORAGE_KEY);
+  }
 
   function loadMapFilterBounds(): [number, number, number, number] | null {
     try {

From 04b334804cc81d441c2ed92933f45238083e30f9 Mon Sep 17 00:00:00 2001
From: Bryon Lewis <61746913+BryonLewis@users.noreply.github.com>
Date: Thu, 2 Apr 2026 13:01:11 -0400
Subject: [PATCH 21/21] Update client/src/views/Recordings.vue

Co-authored-by: Michael Nagler <mike.nagler@kitware.com>
---
 client/src/views/Recordings.vue | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/client/src/views/Recordings.vue b/client/src/views/Recordings.vue
index ad234658..df800812 100644
--- a/client/src/views/Recordings.vue
+++ b/client/src/views/Recordings.vue
@@ -305,8 +305,8 @@ export default defineComponent({
               :exclude-submitted="configuration.mark_annotations_completed_enabled && !showSubmittedRecordings"
               :resize-tick="mapResizeTick"
               :report-bounds="showMap && filterListsByMap"
-              @bounds-change="onMapBounds"
               :initial-bounds="mapBounds"
+              @bounds-change="onMapBounds"
             />
           </v-card-text>
         </v-card>