Download dei Dati ================= Uno degli obiettivi fondamentali della piattaforma Radar-DPC è la pubblicazione dei dati meteo radar non solo per mera visualizzazione, ma anche per il libero download e per l'utilizzo da terze parti. La piattaforma **Radar-DPC** include uno stack di servizi **Representational State Transfer (REST)**, utilizzati nel back end dagli applicativi, ma che rappresenta anche utile API (Applicatio Program Interface) per il download dei dati Radar e più in generale per il lavoro con i servizi esposti da parte di applicazioni di terze parti. La REST API è documentata nell'apposita sezione :doc:`REST API <./api>` .. attention:: La piattaforma **Radar-DPC v2** consente ora il download dei prodotti **nel formato originario in cui vengono forniti i prodotti**. Consultare la sezione `Dettagli e metadati dei file raw`_. per il dettaglio dei metadati dei singoli prodotti. Termini di licenza ^^^^^^^^^^^^^^^^^^ I prodotti e i contenuti erogati dalla piattaforma Radar-DPC sono rilasciati con licenza **Creative Commons Attribuzione – Condividi allo stesso modo** `(CC-BY-SA) `_. È consentito copiarli, distribuirli, modificarli e utilizzarli anche per fini commerciali, a condizione di **citare la fonte Radar-DPC** e di **rilasciare eventuali opere derivate con la stessa licenza CC-BY-SA**. WebSocket ^^^^^^^^^ Tuttavia, per rendere più efficienti le operazioni di download degli aggiornamenti del dato d'interesse, il mero utilizzo della REST API è sconsigliato: il rischio è infatti quello di inoltrare richieste *pull* ai servizi quando non ve ne sia bisogno, ovvero quando ancora non sia presente un nuovo campione dal dato. Inoltre è da notare che i prodotti hanno dei periodi di acquisizione differenti, quindi bisogna richiederne il download specificando il corretto parametro temporale per lo specifico prodotto. Qualora alla API venga richiesto un prodotto ad un tempo che non esiste, essa genera un errore. Per questo motivo è stato implementato un servizio WebSocket, quale canale di comunicazione ove con logica *push* viene comunicata la presenza di nuovi campioni del dato, evitando la generazione di errori e di richieste non necessarie. L'URL del WebSoket è: .. code-block:: html wss://radar-wss.protezionecivile.it A scopo illustrativo si riportano alcuni esempi di messaggi trasmessi sul WebSoket: .. code-block:: html MESSAGE subscription:sub-0 destination:/topic/product message-id:T_sub-0@@session-OG2P1Kwc2OiOtJNNaeaQwQ@@4 redelivered:false content-type:application/json;charset=UTF-8 content-length:74 {   "productType" : "VMI",   "time" : 1556116200000,   "period" : "PT5M" } .. code-block:: html MESSAGE subscription:sub-0 destination:/topic/product message-id:T_sub-0@@session-OG2P1Kwc2OiOtJNNaeaQwQ@@3 redelivered:false content-type:application/json;charset=UTF-8 content-length:74 {   "productType" : "SRI",   "time" : 1556116200000,   "period" : "PT5M" } Come è possibile notare, viene espressamente indicato il valore per il parametro *time* del nuovo campione presente. Ciò consente di poter comporre in modo corretto una richista di download alla REST API, esprimendo il valore del parametro time in modo coerente. Client Ufficiale: DPC-Radar-data-downloader ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Il Dipartimento mette a disposizione un Client Ufficiale per l'Accesso e il Download dei dati, che si avvale del collegamento al WebSocket su cui vengono comunicati in modo *push* le notifiche di aggiornamento dei vari prodotti. Attraverso il client è dunque possibile effettuare richieste di download corrette dei prodotti desiderati. Il client, realizzato sia in linguaggio *java* che in linguaggio *python* è disponibile sul Repository `GitHub del Dipartimento `_ , raggiungibile al seguente indirizzo: .. code-block:: html https://github.com/pcm-dpc/DPC-Radar-data-downloader All'interno del Repository è altresì specificato come effettuare il *Build* dell'applicazione e come configurarne i parametri (es. lista dei prodotti da scaricare). Dettagli e metadati dei file raw ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ La piattaforma Radar-DPC v2 consente ora il download dei dati **nel formato originario cin cui vengono forniti i prodotti**. Questa scelta è stata fatta con l'obiettivo di ottimizzare il sistema nel suo complesso, riducendo i passaggi di elaborazione e i relativi costi computazionali. La disponibilità del dato garantisce inoltre maggiore fedeltà all’informazione di partenza, trasparenza nei processi di elaborazione e maggiore flessibilità di utilizzo da parte degli utenti, che possono applicare autonomamente le proprie procedure di analisi e post-processing. In particolare i prodotti *CUM3 | CUM6 | CUM12 | CUM24* sono forniti con *EPSG:4326*; i restanti prodotti sono forniti con *proiezione custom*, i cui *parametri* possono essere evinti dai metadati ottenibili attraverso l'utilità *GDAL Info*. Di seguito si fornisce, in via esemplificativa per entrambi i casi, l’output dell’utilità GDAL Info, che esplicita il dettaglio dei metadati del file scaricabile. Vertical Maximum Index (VMI) ---------------------------- .. code-block:: html gdalinfo 15-01-2026-10-15.tif Driver: GTiff/GeoTIFF Files: 15-01-2026-10-15.tif Size is 1200, 1400 Coordinate System is: PROJCRS["unnamed", BASEGEOGCRS["WGS 84", DATUM["World Geodetic System 1984", ELLIPSOID["WGS 84",6378137,298.257223563, LENGTHUNIT["metre",1]]], PRIMEM["Greenwich",0, ANGLEUNIT["degree",0.0174532925199433]], ID["EPSG",4326]], CONVERSION["Transverse Mercator", METHOD["Transverse Mercator", ID["EPSG",9807]], PARAMETER["Latitude of natural origin",42, ANGLEUNIT["degree",0.0174532925199433], ID["EPSG",8801]], PARAMETER["Longitude of natural origin",12.5, ANGLEUNIT["degree",0.0174532925199433], ID["EPSG",8802]], PARAMETER["Scale factor at natural origin",1, SCALEUNIT["unity",1], ID["EPSG",8805]], PARAMETER["False easting",0, LENGTHUNIT["metre",1], ID["EPSG",8806]], PARAMETER["False northing",0, LENGTHUNIT["metre",1], ID["EPSG",8807]]], CS[Cartesian,2], AXIS["easting",east, ORDER[1], LENGTHUNIT["metre",1, ID["EPSG",9001]]], AXIS["northing",north, ORDER[2], LENGTHUNIT["metre",1, ID["EPSG",9001]]]] Data axis to CRS axis mapping: 1,2 Origin = (-600000.000000000000000,650000.000000000000000) Pixel Size = (1000.000000000000000,-1000.000000000000000) Metadata: TIFFTAG_DOCUMENTNAME=/data2/RADAR/TIF/2026/01/15/VMI/VMI_15-01-2026_10-15.tif TIFFTAG_IMAGEDESCRIPTION=IDL TIFF file TIFFTAG_SOFTWARE=IDL 8.3, Exelis Visual Information Solutions, Inc. TIFFTAG_DATETIME=2026:01:15 10:21:47 TIFFTAG_XRESOLUTION=100 TIFFTAG_YRESOLUTION=100 TIFFTAG_RESOLUTIONUNIT=2 (pixels/inch) AREA_OR_POINT=Area Image Structure Metadata: COMPRESSION=LZW INTERLEAVE=BAND Corner Coordinates: Upper Left ( -600000.000, 650000.000) ( 4d31'24.21"E, 47d34'15.10"N) Lower Left ( -600000.000, -750000.000) ( 5d55'37.64"E, 35d 3'54.31"N) Upper Right ( 600000.000, 650000.000) ( 20d28'35.79"E, 47d34'15.10"N) Lower Right ( 600000.000, -750000.000) ( 19d 4'22.36"E, 35d 3'54.31"N) Center ( 0.000, -50000.000) ( 12d30' 0.00"E, 41d32'59.38"N) Band 1 Block=1200x1 Type=Float32, ColorInterp=Gray Pioggie Cumulate 1h (SRT_1) ---------------------------- .. code-block:: html gdalinfo 16-01-2026-08-30.tif Driver: GTiff/GeoTIFF Files: 16-01-2026-08-30.tif Size is 1200, 1400 Coordinate System is: PROJCRS["unnamed", BASEGEOGCRS["WGS 84", DATUM["World Geodetic System 1984", ELLIPSOID["WGS 84",6378137,298.257223563, LENGTHUNIT["metre",1]]], PRIMEM["Greenwich",0, ANGLEUNIT["degree",0.0174532925199433]], ID["EPSG",4326]], CONVERSION["Transverse Mercator", METHOD["Transverse Mercator", ID["EPSG",9807]], PARAMETER["Latitude of natural origin",42, ANGLEUNIT["degree",0.0174532925199433], ID["EPSG",8801]], PARAMETER["Longitude of natural origin",12.5, ANGLEUNIT["degree",0.0174532925199433], ID["EPSG",8802]], PARAMETER["Scale factor at natural origin",1, SCALEUNIT["unity",1], ID["EPSG",8805]], PARAMETER["False easting",0, LENGTHUNIT["metre",1], ID["EPSG",8806]], PARAMETER["False northing",0, LENGTHUNIT["metre",1], ID["EPSG",8807]]], CS[Cartesian,2], AXIS["easting",east, ORDER[1], LENGTHUNIT["metre",1, ID["EPSG",9001]]], AXIS["northing",north, ORDER[2], LENGTHUNIT["metre",1, ID["EPSG",9001]]]] Data axis to CRS axis mapping: 1,2 Origin = (-600000.000000000000000,650000.000000000000000) Pixel Size = (1000.000000000000000,-1000.000000000000000) Metadata: TIFFTAG_DOCUMENTNAME=/data2/RADAR/TMP/2026/01/16/SRT/SRT_1_adj/SRT_1_adj_16-01-2026_08-30.tif TIFFTAG_IMAGEDESCRIPTION=IDL TIFF file TIFFTAG_SOFTWARE=IDL 8.3, Exelis Visual Information Solutions, Inc. TIFFTAG_DATETIME=2026:01:16 08:36:47 TIFFTAG_XRESOLUTION=100 TIFFTAG_YRESOLUTION=100 TIFFTAG_RESOLUTIONUNIT=2 (pixels/inch) AREA_OR_POINT=Area Image Structure Metadata: COMPRESSION=LZW INTERLEAVE=BAND Corner Coordinates: Upper Left ( -600000.000, 650000.000) ( 4d31'24.21"E, 47d34'15.10"N) Lower Left ( -600000.000, -750000.000) ( 5d55'37.64"E, 35d 3'54.31"N) Upper Right ( 600000.000, 650000.000) ( 20d28'35.79"E, 47d34'15.10"N) Lower Right ( 600000.000, -750000.000) ( 19d 4'22.36"E, 35d 3'54.31"N) Center ( 0.000, -50000.000) ( 12d30' 0.00"E, 41d32'59.38"N) Band 1 Block=1200x1 Type=Float32, ColorInterp=Gray Piogge Cumulate (CUM 3/6/12/24) ------------------------------- .. code-block:: html gdalinfo Merging_202601151000_24h.tif Driver: GTiff/GeoTIFF Files: Merging_202601151000_24h.tif Size is 1341, 1233 Coordinate System is: GEOGCRS["WGS 84", ENSEMBLE["World Geodetic System 1984 ensemble", MEMBER["World Geodetic System 1984 (Transit)"], MEMBER["World Geodetic System 1984 (G730)"], MEMBER["World Geodetic System 1984 (G873)"], MEMBER["World Geodetic System 1984 (G1150)"], MEMBER["World Geodetic System 1984 (G1674)"], MEMBER["World Geodetic System 1984 (G1762)"], MEMBER["World Geodetic System 1984 (G2139)"], MEMBER["World Geodetic System 1984 (G2296)"], ELLIPSOID["WGS 84",6378137,298.257223563, LENGTHUNIT["metre",1]], ENSEMBLEACCURACY[2.0]], PRIMEM["Greenwich",0, ANGLEUNIT["degree",0.0174532925199433]], CS[ellipsoidal,2], AXIS["geodetic latitude (Lat)",north, ORDER[1], ANGLEUNIT["degree",0.0174532925199433]], AXIS["geodetic longitude (Lon)",east, ORDER[2], ANGLEUNIT["degree",0.0174532925199433]], USAGE[ SCOPE["Horizontal component of 3D system."], AREA["World."], BBOX[-90,-180,90,180]], ID["EPSG",4326]] Data axis to CRS axis mapping: 2,1 Origin = (5.600000000000000,47.579999999999998) Pixel Size = (0.010000000000000,-0.010000000000000) Metadata: AREA_OR_POINT=Area Image Structure Metadata: COMPRESSION=DEFLATE INTERLEAVE=BAND Corner Coordinates: Upper Left ( 5.6000000, 47.5800000) ( 5d36' 0.00"E, 47d34'48.00"N) Lower Left ( 5.6000000, 35.2500000) ( 5d36' 0.00"E, 35d15' 0.00"N) Upper Right ( 19.0100000, 47.5800000) ( 19d 0'36.00"E, 47d34'48.00"N) Lower Right ( 19.0100000, 35.2500000) ( 19d 0'36.00"E, 35d15' 0.00"N) Center ( 12.3050000, 41.4150000) ( 12d18'18.00"E, 41d24'54.00"N) Band 1 Block=256x256 Type=Float32, ColorInterp=Gray NoData Value=-9999 Copertura Nuvolosa (IR_108) --------------------------- .. code-block:: html gdalinfo 15-01-2026-10-30.tif Driver: GTiff/GeoTIFF Files: 15-01-2026-10-30.tif Size is 1200, 1400 Coordinate System is: PROJCRS["unnamed", BASEGEOGCRS["WGS 84", DATUM["World Geodetic System 1984", ELLIPSOID["WGS 84",6378137,298.257223563, LENGTHUNIT["metre",1]]], PRIMEM["Greenwich",0, ANGLEUNIT["degree",0.0174532925199433]], ID["EPSG",4326]], CONVERSION["Transverse Mercator", METHOD["Transverse Mercator", ID["EPSG",9807]], PARAMETER["Latitude of natural origin",42, ANGLEUNIT["degree",0.0174532925199433], ID["EPSG",8801]], PARAMETER["Longitude of natural origin",12.5, ANGLEUNIT["degree",0.0174532925199433], ID["EPSG",8802]], PARAMETER["Scale factor at natural origin",1, SCALEUNIT["unity",1], ID["EPSG",8805]], PARAMETER["False easting",0, LENGTHUNIT["metre",1], ID["EPSG",8806]], PARAMETER["False northing",0, LENGTHUNIT["metre",1], ID["EPSG",8807]]], CS[Cartesian,2], AXIS["easting",east, ORDER[1], LENGTHUNIT["metre",1, ID["EPSG",9001]]], AXIS["northing",north, ORDER[2], LENGTHUNIT["metre",1, ID["EPSG",9001]]]] Data axis to CRS axis mapping: 1,2 Origin = (-600000.000000000000000,650000.000000000000000) Pixel Size = (1000.000000000000000,-1000.000000000000000) Metadata: TIFFTAG_DOCUMENTNAME=/data2/MSG/TIF/2026/01/15/IR_108/IR_108_15-01-2026_10-30.tif TIFFTAG_IMAGEDESCRIPTION=IDL TIFF file TIFFTAG_SOFTWARE=IDL 8.3, Exelis Visual Information Solutions, Inc. TIFFTAG_DATETIME=2026:01:15 10:41:40 TIFFTAG_XRESOLUTION=100 TIFFTAG_YRESOLUTION=100 TIFFTAG_RESOLUTIONUNIT=2 (pixels/inch) AREA_OR_POINT=Area Image Structure Metadata: COMPRESSION=LZW INTERLEAVE=BAND Corner Coordinates: Upper Left ( -600000.000, 650000.000) ( 4d31'24.21"E, 47d34'15.10"N) Lower Left ( -600000.000, -750000.000) ( 5d55'37.64"E, 35d 3'54.31"N) Upper Right ( 600000.000, 650000.000) ( 20d28'35.79"E, 47d34'15.10"N) Lower Right ( 600000.000, -750000.000) ( 19d 4'22.36"E, 35d 3'54.31"N) Center ( 0.000, -50000.000) ( 12d30' 0.00"E, 41d32'59.38"N) Band 1 Block=1200x1 Type=Float32, ColorInterp=Gray Temperature Map (Temp) ---------------------- .. code-block:: html gdalinfo 202601151000_1h_Temp.tif Driver: GTiff/GeoTIFF Files: 202601151000_1h_Temp.tif Size is 631, 576 Coordinate System is: GEOGCRS["WGS 84", ENSEMBLE["World Geodetic System 1984 ensemble", MEMBER["World Geodetic System 1984 (Transit)"], MEMBER["World Geodetic System 1984 (G730)"], MEMBER["World Geodetic System 1984 (G873)"], MEMBER["World Geodetic System 1984 (G1150)"], MEMBER["World Geodetic System 1984 (G1674)"], MEMBER["World Geodetic System 1984 (G1762)"], MEMBER["World Geodetic System 1984 (G2139)"], MEMBER["World Geodetic System 1984 (G2296)"], ELLIPSOID["WGS 84",6378137,298.257223563, LENGTHUNIT["metre",1]], ENSEMBLEACCURACY[2.0]], PRIMEM["Greenwich",0, ANGLEUNIT["degree",0.0174532925199433]], CS[ellipsoidal,2], AXIS["geodetic latitude (Lat)",north, ORDER[1], ANGLEUNIT["degree",0.0174532925199433]], AXIS["geodetic longitude (Lon)",east, ORDER[2], ANGLEUNIT["degree",0.0174532925199433]], USAGE[ SCOPE["Horizontal component of 3D system."], AREA["World."], BBOX[-90,-180,90,180]], ID["EPSG",4326]] Data axis to CRS axis mapping: 2,1 Origin = (6.000000000000000,47.500263214111328) Pixel Size = (0.019983009747110,-0.019983009747110) Metadata: AREA_OR_POINT=Area Image Structure Metadata: COMPRESSION=DEFLATE INTERLEAVE=BAND Corner Coordinates: Upper Left ( 6.0000000, 47.5002632) ( 6d 0' 0.00"E, 47d30' 0.95"N) Lower Left ( 6.0000000, 35.9900496) ( 6d 0' 0.00"E, 35d59'24.18"N) Upper Right ( 18.6092792, 47.5002632) ( 18d36'33.40"E, 47d30' 0.95"N) Lower Right ( 18.6092792, 35.9900496) ( 18d36'33.40"E, 35d59'24.18"N) Center ( 12.3046396, 41.7451564) ( 12d18'16.70"E, 41d44'42.56"N) Band 1 Block=631x3 Type=Float32, ColorInterp=Gray .. toctree:: :maxdepth: 2 :caption: Contenuti