Add hydrology station thumbnail metadata

Author: Sam-Bolling

docs/research/new-publisher-source-planning/Environment_Agency_Hydrology_Live_Demo_Verification_2026-05-26.md

@@ -118,6 +118,8 @@ EA Hydrology Beggearn Huish
 Verified UI behavior:
 
 - The deployed-system card renders an image-backed STANAG symbol element instead of the old blank fallback rectangle.
+- A representative hydrometric gauge photograph is available in system SensorML metadata for the deployed-system side-card thumbnail path. It is explicitly labeled as representative imagery, not station-specific imagery.
+- Because the current OSH server rejects system SensorML PUTs with HTTP 500, the production Explorer also includes an Environment Agency Hydrology fallback thumbnail using that same representative photograph when SensorML media is unavailable.
 - The card includes a `Latest readings` section.
 - The card shows both Beggearn Huish readings:
   - River flow `0.219 m3/s`
@@ -147,6 +149,8 @@ Confirmed live-demo features:
 - correct OSH preset connected,
 - EA hydrology resources visible on map,
 - STANAG symbol no longer blank fallback,
+- representative gauge photo metadata available for side-card thumbnail display,
+- Explorer fallback thumbnail available while system SensorML PUTs are blocked server-side,
 - deployed-system side card latest readings visible,
 - map popup latest-reading content populated,
 - backend latest observations available.

docs/research/new-publisher-source-planning/Environment_Agency_Hydrology_Publisher_Completion_Report_2026-05-26.md

@@ -59,6 +59,10 @@ CSAPI UIDs sanitize Environment Agency station notation before embedding it in r
 
 Deployment descriptions now explicitly identify the resources as Environment Agency hydrology monitoring stations and water sensor systems. This gives the Explorer symbol classifier enough semantic signal to avoid the generic blank friendly land-unit rectangle fallback.
 
+System SensorML now includes a representative Environment Agency river-gauge station photograph as the first document link. This follows the side-card image pattern used by ISS, CO-OPS, NDBC, and aviation weather publishers, where image-type SensorML documents become deployed-system card thumbnails. Because the Environment Agency station resources do not expose station-specific photos, the image is labeled as representative rather than exact-station imagery and includes source/license attribution: Brian Green / Geograph, CC BY-SA 2.0, via Wikimedia Commons.
+
+The Explorer also includes a defensive Environment Agency Hydrology thumbnail fallback using the same representative photograph. This is needed because the current OSH server still returns HTTP 500 on system SensorML PUTs, so freshly added image metadata may not reach the live side card through the normal SensorML path until that server behavior is fixed.
+
 ### Explorer Symbol Classification
 
 Environment Agency Hydrology was aligned with the existing water/weather station publishers for NATO/STANAG display. The closest established symbol family is the friendly emplaced sensor symbol already used for USGS Water, CO-OPS, NDBC, and NWS station resources.
@@ -175,6 +179,8 @@ The server enforces the DataRecord result fields strictly. The runtime was adjus
 
 Procedure SensorML is accepted. System SensorML PUTs currently return HTTP 500 for all Environment Agency station systems on the configured server. This does not block the operational path: systems, datastreams, deployments, and live observations are present and working. The bootstrap logs the skipped SensorML PUTs and continues.
 
+The representative gauge photo was added to system SensorML, but this server-side PUT failure means the live Explorer cannot rely on SensorML metadata alone for the side-card thumbnail. The Explorer fallback supplies the same representative image when Environment Agency Hydrology deployments have no SensorML media link.
+
 ## Documentation Updates
 
 Updated `publishers/README.md` to include Environment Agency Hydrology in the publisher fleet and bootstrap command list.

docs/research/new-publisher-source-planning/Environment_Agency_Hydrology_Publisher_Implementation_Plan_2026-05-26.md

@@ -141,8 +141,11 @@ System metadata should include:
 - river/catchment/location metadata if available,
 - source station URL,
 - available curated measures,
+- representative hydrometric gauge photo metadata for Explorer side-card thumbnails,
 - licensing and attribution note.
 
+Environment Agency station resources do not expose station-specific photos. Use an explicitly labeled representative Environment Agency river-gauge photograph rather than implying that the image is the exact selected station. Preserve attribution and license metadata in SensorML document links.
+
 ### Datastreams
 
 Create one datastream per selected Environment Agency measure:

publishers/environment_agency_hydrology/README.md

@@ -41,3 +41,5 @@ Use `--stations` with comma-separated Environment Agency station notations to pu
 - Values can be provisional or revised; result payloads preserve source `quality`, `completeness`, and validation-count fields when present.
 - Explorer NATO/STANAG display should use the friendly emplaced sensor symbol family (`SFGPEWRH-------`), matching USGS Water, CO-OPS, NDBC, and NWS station publishers.
 - Explorer deployed-system cards and map click popups display latest readings from the station datastreams. Freshness is based on source `phenomenonTime`, so stale groundwater values remain visibly stale even if they were published into CSAPI recently.
+- System SensorML includes a representative Environment Agency river-gauge photograph for Explorer side-card thumbnails. The image is a visual proxy, not a curated-station-specific photo: Brian Green / Geograph, CC BY-SA 2.0, via Wikimedia Commons.
+- The production Explorer has a matching fallback thumbnail for Environment Agency Hydrology because the current OSH server rejects system SensorML PUTs with HTTP 500.

publishers/environment_agency_hydrology/bootstrap_environment_agency_hydrology.py

@@ -47,6 +47,15 @@
 EA_MEASURES = "https://environment.data.gov.uk/hydrology/id/measures.json"
 EA_READINGS = "https://environment.data.gov.uk/hydrology/data/readings.json"
 OGL3 = "https://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/"
+EA_GAUGE_PHOTO = (
+    "https://upload.wikimedia.org/wikipedia/commons/f/f0/"
+    "Environment_Agency_Morton_River_Gauge_Station_-_geograph.org.uk_-_283345.jpg"
+)
+EA_GAUGE_PHOTO_PAGE = (
+    "https://commons.wikimedia.org/wiki/"
+    "File:Environment_Agency_Morton_River_Gauge_Station_-_geograph.org.uk_-_283345.jpg"
+)
+CC_BY_SA_20 = "https://creativecommons.org/licenses/by-sa/2.0/"
 
 
 def _load_stations() -> list[dict]:
@@ -169,6 +178,16 @@ def _system_sml(station: dict) -> dict:
     notation = station["stationNotation"]
     measure_labels = ", ".join(m["label"] for m in station.get("measures", []))
     docs = [
+        {
+            "role": "http://dbpedia.org/resource/Photograph",
+            "name": "Representative Hydrometric Gauge Photo",
+            "description": (
+                "Representative photograph of an Environment Agency river gauge station. "
+                "Used as a visual proxy for curated Environment Agency hydrology stations; "
+                "not a station-specific photograph. Photo: Brian Green / Geograph, CC BY-SA 2.0."
+            ),
+            "link": {"href": EA_GAUGE_PHOTO, "type": "image/jpeg"},
+        },
         {
             "role": "http://dbpedia.org/resource/Web_page",
             "name": "Environment Agency Station Resource",
@@ -180,6 +199,18 @@ def _system_sml(station: dict) -> dict:
             "name": "Hydrology API Reference",
             "link": {"href": EA_API_REFERENCE, "type": "text/html"},
         },
+        {
+            "role": "http://dbpedia.org/resource/Web_page",
+            "name": "Representative Gauge Photo Source",
+            "description": "Wikimedia Commons source page for the representative gauge photo.",
+            "link": {"href": EA_GAUGE_PHOTO_PAGE, "type": "text/html"},
+        },
+        {
+            "role": "http://dbpedia.org/resource/Web_page",
+            "name": "Representative Gauge Photo License",
+            "description": "Creative Commons Attribution-ShareAlike 2.0 license for the representative gauge photo.",
+            "link": {"href": CC_BY_SA_20, "type": "text/html"},
+        },
     ]
     for measure in station.get("measures", []):
         docs.append({