Add BGS representative thumbnail metadata

Author: Sam-Bolling

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

@@ -22,6 +22,7 @@ Explorer production polish was implemented separately in the Explorer repository
 - BGS role inference: `Groundwater Telemetry Site`
 - BGS symbol rule: fixed Sensor Emplaced style
 - latest-reading label fix for `Water Level maOD`
+- representative thumbnail fallback using the official UKGEOS borehole-dimensions illustration
 
 ## Source
 
@@ -122,12 +123,19 @@ Verified card after Explorer polish deployment:
 - system subtitle: `BGS GGA07 Downhole Hydro Logger`
 - outputs: Conductivity, Water Level maOD, Water Temperature
 - role badge: `GROUNDWATER TELEMETRY SITE`
+- representative thumbnail: official UKGEOS borehole-dimensions illustration
 - latest readings: Conductivity, Water Level maOD, Water Temperature
 - source links: BGS SensorThings Thing, BGS SensorThings API Docs, Open Government Licence v3.0
 
 Explorer polish was pushed and deployed to improve the card from generic `Deployed System` to `Groundwater Telemetry Site` and to keep `Water Level maOD` as the latest-reading label. Production bundle checks confirmed the new JS contains the BGS role/symbol/label updates, and the browser card check confirmed the visible production card text.
 
+## Thumbnail Research And Licensing
+
+The BGS/UKGEOS Glasgow Observatory page includes relevant visual assets, including photographs and official illustrations. UKGEOS legal text states that data/material on the website is made available under the Open Government Licence where possible with acknowledgement `Contains NERC materials (c) NERC 2026`, but also explicitly says photographic images are not subject to OGL and are identified separately to their copyright owners/license.
+
+Because no station-specific licensed photograph was identified during this pass, the BGS card uses the official UKGEOS borehole-dimensions illustration as a representative, non-photographic visual for Glasgow Observatory borehole infrastructure. The implementation labels it as representative, not station-specific.
+
 ## Remaining Follow-Up
 
 - Investigate the live OSH SensorML PUT 500 for BGS systems if richer system metadata becomes necessary.
-- Consider representative BGS/UKGEOS imagery only after separate licensing research; no image was added in this pass.
+- Consider replacing the representative illustration only if a station-specific photograph with clear reuse terms is identified.

publishers/bgs_sensorthings/README.md

@@ -18,6 +18,8 @@ The first pass uses three UKGEOS Glasgow downhole hydro loggers:
 
 Curated source records are restricted to BGS datastreams that reported unrestricted access and Open Government Licence / UKRI acknowledgement usage text during probing.
 
+The card thumbnail uses an official UKGEOS borehole-dimensions illustration from the Glasgow Observatory page as a representative visual. It is not a station-specific photograph. UKGEOS legal text says photographic images are not covered by OGL, so the publisher intentionally avoids UKGEOS photographs unless a specific image license is available.
+
 ## Bootstrap
 
 ```bash

publishers/bgs_sensorthings/bootstrap_bgs_sensorthings.py

@@ -41,6 +41,36 @@
 BGS_INTERACTIVE_DOCS = "https://sensors-docs.bgs.ac.uk/"
 BGS_API_ROOT = "https://sensors.bgs.ac.uk/FROST-Server/v1.1"
 OGL3 = "https://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/"
+UKGEOS_LEGAL = "https://www.ukgeos.ac.uk/legal-and-compliance"
+
+
+def _image_docs(station: dict) -> list[dict]:
+    image = station.get("image") or {}
+    if not image.get("url"):
+        return []
+    return [
+        {
+            "role": "http://dbpedia.org/resource/Illustration",
+            "name": image.get("name") or "Representative UKGEOS illustration",
+            "description": (
+                f"{image.get('description', 'Representative UKGEOS visual.')} "
+                f"Acknowledgement: {image.get('acknowledgement', 'Contains NERC materials (c) NERC 2026')}."
+            ),
+            "link": {"href": image["url"], "type": "image/svg+xml"},
+        },
+        {
+            "role": "http://dbpedia.org/resource/Web_page",
+            "name": "Representative image source",
+            "description": "UKGEOS Glasgow Observatory page containing the representative borehole infrastructure illustration.",
+            "link": {"href": image.get("pageUrl") or "https://www.ukgeos.ac.uk/glasgow-observatory", "type": "text/html"},
+        },
+        {
+            "role": "http://dbpedia.org/resource/Web_page",
+            "name": "UKGEOS legal and attribution notes",
+            "description": image.get("license", "UKGEOS legal text documents OGL availability and image exclusions."),
+            "link": {"href": UKGEOS_LEGAL, "type": "text/html"},
+        },
+    ]
 
 
 def _load_stations() -> list[dict]:
@@ -152,7 +182,7 @@ def _system_stub(station: dict) -> dict:
 def _system_sml(station: dict) -> dict:
     site_id = station["siteId"]
     parameter_labels = ", ".join(d["label"] for d in station.get("datastreams", []))
-    docs = [
+    docs = _image_docs(station) + [
         {
             "role": "http://dbpedia.org/resource/Web_page",
             "name": "BGS SensorThings Thing",

publishers/bgs_sensorthings/stations.json

@@ -24,6 +24,15 @@
       "thingUrl": "https://sensors.bgs.ac.uk/FROST-Server/v1.1/Things(195)",
       "selectionReason": "Recent unrestricted SensorThings telemetry from the UKGEOS Glasgow observatory with a useful groundwater/geothermal parameter mix.",
       "dataUsage": "Available under the Open Government Licence subject to the following acknowledgement accompanying the reproduced UKRI materials \"Contains UKRI materials (c) UKRI [year]\"",
+      "image": {
+        "url": "https://www.ukgeos.ac.uk/assets/img/svgs/illustrations/borehole_dimmensions.svg",
+        "pageUrl": "https://www.ukgeos.ac.uk/glasgow-observatory",
+        "licenseUrl": "https://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/",
+        "name": "Representative UKGEOS borehole dimensions illustration",
+        "description": "Official UKGEOS illustration representing Glasgow Observatory borehole infrastructure. This is a representative visual for BGS SensorThings hydro logger deployments, not a station-specific photograph.",
+        "license": "Open Government Licence v3.0 where UKGEOS website material is made available under OGL; photographic images are explicitly excluded by UKGEOS legal text.",
+        "acknowledgement": "Contains NERC materials (c) NERC 2026"
+      },
       "datastreams": [
         {
           "datastreamId": "405",
@@ -71,6 +80,15 @@
       "thingUrl": "https://sensors.bgs.ac.uk/FROST-Server/v1.1/Things(197)",
       "selectionReason": "Recent unrestricted SensorThings telemetry from the UKGEOS Glasgow observatory with a useful groundwater/geothermal parameter mix.",
       "dataUsage": "Available under the Open Government Licence subject to the following acknowledgement accompanying the reproduced UKRI materials \"Contains UKRI materials (c) UKRI [year]\"",
+      "image": {
+        "url": "https://www.ukgeos.ac.uk/assets/img/svgs/illustrations/borehole_dimmensions.svg",
+        "pageUrl": "https://www.ukgeos.ac.uk/glasgow-observatory",
+        "licenseUrl": "https://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/",
+        "name": "Representative UKGEOS borehole dimensions illustration",
+        "description": "Official UKGEOS illustration representing Glasgow Observatory borehole infrastructure. This is a representative visual for BGS SensorThings hydro logger deployments, not a station-specific photograph.",
+        "license": "Open Government Licence v3.0 where UKGEOS website material is made available under OGL; photographic images are explicitly excluded by UKGEOS legal text.",
+        "acknowledgement": "Contains NERC materials (c) NERC 2026"
+      },
       "datastreams": [
         {
           "datastreamId": "430",
@@ -118,6 +136,15 @@
       "thingUrl": "https://sensors.bgs.ac.uk/FROST-Server/v1.1/Things(200)",
       "selectionReason": "Recent unrestricted SensorThings telemetry from the UKGEOS Glasgow observatory with a useful groundwater/geothermal parameter mix.",
       "dataUsage": "Available under the Open Government Licence subject to the following acknowledgement accompanying the reproduced UKRI materials \"Contains UKRI materials (c) UKRI [year]\"",
+      "image": {
+        "url": "https://www.ukgeos.ac.uk/assets/img/svgs/illustrations/borehole_dimmensions.svg",
+        "pageUrl": "https://www.ukgeos.ac.uk/glasgow-observatory",
+        "licenseUrl": "https://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/",
+        "name": "Representative UKGEOS borehole dimensions illustration",
+        "description": "Official UKGEOS illustration representing Glasgow Observatory borehole infrastructure. This is a representative visual for BGS SensorThings hydro logger deployments, not a station-specific photograph.",
+        "license": "Open Government Licence v3.0 where UKGEOS website material is made available under OGL; photographic images are explicitly excluded by UKGEOS legal text.",
+        "acknowledgement": "Contains NERC materials (c) NERC 2026"
+      },
       "datastreams": [
         {
           "datastreamId": "404",