Skip to content

Commit 738597c

Browse files
committed
Document UK-AIR Explorer validation
1 parent 8332972 commit 738597c

1 file changed

Lines changed: 28 additions & 4 deletions

File tree

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

Lines changed: 28 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -113,6 +113,23 @@ Verified examples:
113113
- `deployments?uid=urn:os4csapi:deployment:uk-air-demo:v1&limit=1000` returned one item.
114114
- `deployments?uid=urn:os4csapi:deployment:uk-air-stations:v1&limit=1000` returned one item.
115115

116+
## Explorer Visual Validation
117+
118+
Production Explorer was connected to the `OSH (OS4CSAPI)` preset and the map was filtered for `UK-AIR`. The live card for `UK-AIR Auchencorth Moss` opened successfully and displayed:
119+
120+
- Context path: `UK-AIR Air Quality Demo > UK-AIR Monitoring Stations > UK-AIR Auchencorth Moss`
121+
- Output: `Ozone`
122+
- Latest reading: `67.85 ug/m3`
123+
- Freshness: `recent`, approximately two hours old at validation time
124+
- Source links: UK-AIR representative timeseries, UK-AIR REST API docs, Open Government Licence v3.0
125+
126+
Two UI polish issues were found and fixed in the Explorer repo:
127+
128+
1. UK-AIR deployments initially fell through to the generic `Monitoring Site` classification. The Explorer now recognizes `UK-AIR`, `air quality`, `air pollution`, pollutant names, and pollutant codes as air-quality sites and labels the side card `Air Quality Site`.
129+
2. Latest-reading value/unit text rendered without a visible space in the card text extraction. The card now formats the display as `67.85 ug/m3`.
130+
131+
The UK-AIR symbol rule now maps air-quality stations to the same friendly emplaced sensor family used for Environment Agency Hydrology, USGS Water, CO-OPS, NDBC, and weather station markers.
132+
116133
## Validation Commands
117134

118135
```powershell
@@ -125,9 +142,16 @@ py -m publishers.uk_air.uk_air_publisher --once
125142

126143
All final validation commands completed successfully.
127144

145+
Explorer validation command:
146+
147+
```powershell
148+
npm --prefix demo run build
149+
```
150+
151+
The patched Explorer build completed successfully and was validated locally through Vite preview at `http://127.0.0.1:4174/` against the live `OSH (OS4CSAPI)` backend.
152+
128153
## Follow-Up Items
129154

130-
1. Open the production Explorer map with the `OSH (OS4CSAPI)` preset and visually confirm marker styling, side-card labels, and popup latest-reading display for UK-AIR deployments.
131-
2. If the marker falls back to a blank/generic NATO symbol, add a targeted UK-AIR / air-quality keyword mapping in the Explorer symbol mapper.
132-
3. Consider adding a representative monitoring-station image/fallback after the visual pass, following the Environment Agency Hydrology pattern.
133-
4. Consider expanding the curated sidecar after demo validation, especially for additional urban NO2/PM sites and rural background stations.
155+
1. After the Explorer deployment completes, spot-check production again to confirm the patched `Air Quality Site` label and value/unit spacing are live.
156+
2. Consider adding a representative monitoring-station image/fallback after a verified public image source is selected, following the Environment Agency Hydrology pattern.
157+
3. Consider expanding the curated sidecar after demo validation, especially for additional urban NO2/PM sites and rural background stations.

0 commit comments

Comments
 (0)