Alby96/Europa
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Survey the ARPA REST APIs and correct the licence position

Browse Source 
Scanned the two public ARPA Piemonte APIs and recorded what they actually
contain, so this question does not get re-litigated from the marketing pages
later. Neither needs a key, a token or a registration.

This corrects something I got wrong. The docs said ARPA states no licence for
its data, based on the open-data page saying only "gratuiti". The site's legal
notice does state one — CC BY 4.0, commercial use explicitly permitted, credit
"Fonte: Arpa Piemonte - www.arpa.piemonte.it" — and both APIs link that notice
from their OpenAPI description, so anything they serve is covered. Only the
radar volumes remain ambiguous, because their own page does not repeat the
licence and the access link is still issued by email; both questions belong in
the same message to ARPA.

The survey's operative findings:

- api_realtime carries 374 stations with coordinates, of which 286 have a rain
  gauge, spanning 74 m to 2820 m of elevation.
- Its observations lag by about 4.5 hours on an hourly cadence, measured
  uniformly across every station sampled. That is the property that decides how
  it can be used: it is an observation archive with a publishing delay, not a
  real-time feed, and it must never sit next to 5-minute radar looking current.
- Only 4 of 143 hydrometer stations publish guard and danger thresholds, and 5
  publish a river name. A river-level warning built on this would be empty for
  97% of stations, so that idea is recorded as rejected rather than pending.
- Meteoweb is a 3.27-million-record historical archive plus a seismic
  catalogue: a research dataset, not app content.

One thing is worth adopting: rain-gauge accumulations as ground truth for the
radar. Radar infers rainfall from reflectivity aloft, gauges measure what
reached the ground, and the network is densest exactly where Alpine terrain
blocks the beam. It belongs behind the worker, clearly timestamped, once the
worker exists.

Also notes that the credit ARPA asks for is the full "Fonte: Arpa Piemonte -
www.arpa.piemonte.it", not the bare name currently in the region config, to be
adopted the moment any ARPA-sourced data is displayed.

No code changes: nothing is integrated yet.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Alby96
2026-09-10 16:33:55 +02:00
co-authored by Claude Opus 5
parent f3a0e3794a
commit e14308bbb6
2 changed files with 88 additions and 23 deletions
Download Patch File Download Diff File Expand all files Collapse all files
Nuvolari/docs/licenses.md
+17 -11
View File
@@ -9,8 +9,8 @@ to save screen space.
| Data | License | Mandatory credit | Notes |
|---|---|---|---|
| Radar-DPC rasters | CC BY-SA | "Radar-DPC" | **Share-alike propagates to our frames** |
| ARPA Piemonte radar | **none stated** | — | Adapter disabled; see below |
| ARPA Piemonte alerts | not stated | "Arpa Piemonte" + link to the official bulletin | Levels republished verbatim |
| ARPA Piemonte data | CC BY 4.0, commercial OK | "Fonte: Arpa Piemonte - www.arpa.piemonte.it" | Radar volumes: licence not repeated on their page, access by email |
| ARPA Piemonte alerts | CC BY 4.0 (site notice) | as above, + link to the official bulletin | Levels republished verbatim |
| OpenStreetMap data | ODbL | "© OpenStreetMap contributors" | Must stay visible on the map |
| OpenMapTiles schema | BSD 3-Clause | "© OpenMapTiles" | Must stay visible on the map |
| OpenFreeMap service | MIT | "OpenFreeMap" — optional | Listed on the Sources screen |
@@ -29,18 +29,24 @@ The manifest carries its own `attribution` string for exactly this reason: the c
travels with the frames rather than being remembered at render time, and the app
displays whatever the publisher of those frames says to display.
## ARPA Piemonte radar: free of charge is not a licence
## ARPA Piemonte: CC BY 4.0, stated in the legal notice
The ARPA open-data page describes the radar volumes as *gratuiti* and says nothing about
reuse terms. That is not permission to redistribute. Rendering those volumes into frames
and serving them from our CDN to app users **is** redistribution.
ARPA's legal notice at <https://www.arpa.piemonte.it/note-legali> releases environmental
and open data under **CC BY 4.0**, explicitly permitting commercial use, and requires the
credit *"Fonte: Arpa Piemonte - www.arpa.piemonte.it"*. Logos, institutional emblems,
registered trademarks and third-party content are excluded.
So the adapter stays disabled until ARPA states terms, and the email that requests the
access link should ask for the reuse terms in the same breath. Both are the project
owner's to obtain — see [data-sources.md](data-sources.md) section 2.
Both ARPA REST APIs — `api_realtime` and Meteoweb — link that notice from their OpenAPI
`description`, so anything served by them is covered without further correspondence.
An earlier draft of this file recorded ARPA radar as CC BY 4.0. The source page does not
support that, so the claim has been removed rather than carried forward.
The **radar volumes** are the one gap: their open-data page says only *gratuiti* and does
not repeat the licence, and the real-time access link is issued by email. Ask ARPA to
confirm both in the same message. Until then the radar adapter stays disabled — see
[data-sources.md](data-sources.md) section 2.
The credit string ARPA asks for is the full *"Fonte: Arpa Piemonte -
www.arpa.piemonte.it"*, not the bare name currently in the region config. Adopt the full
form the moment any ARPA-sourced data is actually displayed.
## Base map credits are not automatic