Add Digitraffic road weather publisher

Author: Sam-Bolling

docs/research/finland-publisher-expansion/Finland_Digitraffic_Road_Weather_Live_Smoke_2026-05-29.md

@@ -0,0 +1,43 @@
+# Finland Digitraffic Road Weather Live Smoke
+
+Date: 2026-05-29
+
+## Summary
+
+Phase 1 Finland datasource is live on the OSH CSAPI server using Fintraffic Digitraffic road-weather station latest-data endpoints.
+
+Resources created without `--clean`:
+
+- Procedure: `urn:os4csapi:procedure:digitraffic-road-weather:v1`
+- Root deployment: `urn:os4csapi:deployment:digitraffic-road-weather-demo:v1`
+- Station group deployment: `urn:os4csapi:deployment:digitraffic-road-weather-stations:v1`
+- Six station systems and `roadWeatherObs` datastreams
+
+Two station system creates returned the known SensorHub HTTP 500-after-create/SensorML-PUT warning path and were recovered by UID lookup. Live SensorML checks still confirmed `Publish Interval=300s` for verified systems.
+
+## Live Publish Result
+
+One publisher cycle posted six observations successfully:
+
+| Station ID | System ID | Datastream ID | Latest phenomenon time | Air C | Road C |
+| --- | --- | --- | --- | --- | --- |
+| 1014 | 05u0 | 075g2 | 2026-05-29T20:57:24Z | 9.0 | 14.7 |
+| 1003 | 05ug | 07602 | 2026-05-29T20:57:54Z | 10.7 | 16.1 |
+| 2002 | 05v0 | 076g2 | 2026-05-29T20:56:54Z | 6.2 | 10.2 |
+| 3036 | 05vg | 07702 | 2026-05-29T20:57:54Z | 8.5 | 9.5 |
+| 4010 | 06002 | 077g2 | 2026-05-29T20:57:54Z | 8.5 | 12.6 |
+| 12091 | 060g2 | 07802 | 2026-05-29T20:56:54Z | 7.4 | 8.8 |
+
+Publisher output summary: `Published: 6`, `Skipped: 0`, `Errors: 0`.
+
+## Verification Commands
+
+Validated:
+
+- `py -m py_compile publishers/digitraffic_road_weather/bootstrap_digitraffic_road_weather.py publishers/digitraffic_road_weather/digitraffic_road_weather_publisher.py`
+- `py publishers/digitraffic_road_weather/digitraffic_road_weather_publisher.py --dry-run --once`
+- `py publishers/digitraffic_road_weather/bootstrap_digitraffic_road_weather.py --dry-run --force-sml`
+- `py publishers/digitraffic_road_weather/bootstrap_digitraffic_road_weather.py --force-sml`
+- `py publishers/digitraffic_road_weather/digitraffic_road_weather_publisher.py --once`
+
+Explorer follow-up: `demo/src/pages/MapViewPage.vue` now classifies Digitraffic/Fintraffic road-weather observation datastreams as `FIN Road Wx`.

docs/research/finland-publisher-expansion/Finland_Source_Endpoint_Probe_2026-05-29.md

@@ -0,0 +1,38 @@
+# Finland Source Endpoint Probe
+
+Date: 2026-05-29
+
+## Digitraffic Road Weather
+
+Station metadata endpoint:
+
+`https://tie.digitraffic.fi/api/weather/v1/stations`
+
+Result: live GeoJSON `FeatureCollection` with 525 station features. Station geometry is Point coordinates in lon/lat order. Station properties include `id`, `name`, `collectionStatus`, `dataUpdatedTime`, and `state`.
+
+Latest all-station data endpoint:
+
+`https://tie.digitraffic.fi/api/weather/v1/stations/data`
+
+Result: live JSON object with top-level `dataUpdatedTime` and `stations[]`. Each station has `id`, `dataUpdatedTime`, and `sensorValues[]` containing sensor `id`, `stationId`, `name`, `shortName`, `measuredTime`, `unit`, and `value`.
+
+Station-specific latest data endpoint:
+
+`https://tie.digitraffic.fi/api/weather/v1/stations/{id}/data`
+
+Result: live JSON object for one station with the same `sensorValues[]` structure.
+
+Verified fresh sample times during probe: 2026-05-29T20:47Z to 2026-05-29T20:51Z.
+
+Selected Phase 1 curated stations:
+
+| ID | Source name | Region |
+| --- | --- | --- |
+| 1014 | vt25_Hanko | Uusimaa south coast |
+| 1003 | st110_Vihti_Myllylampi | Helsinki western approach |
+| 2002 | vt8_Pyharanta_Ihode | Southwest Finland |
+| 3036 | vt6_Lappeenranta_Karki | Southeast Finland |
+| 4010 | vt12_Hollola_Hameenkoski | Central southern Finland |
+| 12091 | kt92_Inari_Naatamo | Lapland / Inari |
+
+Implementation choice: use station-specific latest endpoints for the runtime publisher to keep each fetch bounded and easy to diagnose. Preserve the full source `sensorValues[]` payload as compact JSON in the CSAPI observation result while also lifting common operational fields such as air temperature, road-surface temperature, wind speed, wind direction, precipitation, road condition, and warning code.

publishers/digitraffic_road_weather/README.md

@@ -0,0 +1,27 @@
+# Digitraffic Road Weather Publisher
+
+Publishes a curated first Finland datasource: Fintraffic Digitraffic road-weather station observations.
+
+Source endpoints:
+
+- Station metadata: `https://tie.digitraffic.fi/api/weather/v1/stations`
+- Latest all-station data: `https://tie.digitraffic.fi/api/weather/v1/stations/data`
+- Station-specific data: `https://tie.digitraffic.fi/api/weather/v1/stations/{id}/data`
+
+Initial curated stations are listed in `stations.json` and cover southern, western, eastern, central, and northern Finland.
+
+## Bootstrap
+
+```powershell
+py publishers/digitraffic_road_weather/bootstrap_digitraffic_road_weather.py --dry-run
+py publishers/digitraffic_road_weather/bootstrap_digitraffic_road_weather.py --force-sml
+```
+
+## Publish
+
+```powershell
+py publishers/digitraffic_road_weather/digitraffic_road_weather_publisher.py --dry-run --once
+py publishers/digitraffic_road_weather/digitraffic_road_weather_publisher.py --once
+```
+
+Default publisher interval is 300 seconds.

publishers/digitraffic_road_weather/__init__.py

@@ -0,0 +1 @@
+"""Digitraffic road weather publisher package."""