MeteoHub è una piattaforma cloud che fornisce accesso ai dati meteorologici su tutto il territorio italiano, incluse previsioni meteo e marine, osservazioni, prodotti radar e dataset derivati.

Progettata per ricercatori, enti pubblici e team operativi, MeteoHub supporta sia l’esplorazione interattiva sia flussi di lavoro completamente automatizzati.

Gli utenti possono accedere e scaricare i dati tramite:

• Interfaccia Web: senza necessità di configurazioni tecniche
• REST API: per l'automazione e l'integrazione con altri sistemi.
• Client da riga di comando: per download automatizzati.

👉 L'accesso a tutti i servizi è attualmente offerto gratuitamente, nel rispetto delle policy di fair use e dei limiti di risorse.

• Accesso unificato a molteplici dataset meteorologici.
• Dataset ottimizzati per il cloud per flussi di lavoro basati sull'intelligenza artificiale (vedi la Guida ARCO).
• Pianificazione automatizzata delle richieste.
• Post-processing integrato.
• Strumenti di visualizzazione dei dati.

• Ricercatori
• Operatori della Protezione Civile
• Aziende del settore energetico
• Agenzie ambientali
• Team di AI e data science

MeteoHub fornisce accesso a quattro categorie di dati meteorologici:

• Previsioni meteo
• Previsioni marine
• Osservazioni
• Prodotti radar

👉 Catalogo dei dataset:
https://meteohub.agenziaitaliameteo.it/app/datasets

👉 Licenze e attribuzioni:
https://meteohub.agenziaitaliameteo.it/app/license

Several visualisation tools are available to explore selected meteorological datasets from the MeteoHub catalogue:

• Weather forecasts – 3-day, weekly, and monthly maps
• ICON-2I static map
• Marine forecasts map
• Observed data map
• Radar map

👉 In particular, the 3 days map allows users to:

• Overlay multiple fields simultaneously.
• View information at any point on the map.

👉 The observed data map provides:

• Time series for each station.

Sono disponibili diversi strumenti per visualizzare i dataset:

• Mappe previsionali: 3 giorni, Settimanali e Mensili
• Mappa statica di ICON-2I
• Mappa di previsioni marine
• Mappa dei dati osservati
• Mappa radar

👉 La mappa a 3 giorni consente di:

• Sovrapporre più variabili simultaneamente.
• Visualizzare le informazioni in qualsiasi punto della mappa.

👉 La mappa dei dati osservati fornisce:

• Le serie temporali per ciascuna stazione.

Se siete un’organizzazione o un’associazione meteorologica e desiderate che i dati della vostra rete meteorologica vengano pubblicati su MeteoHub, scriveteci a meteohub-support@cineca.it. Valuteremo la vostra richiesta.

👉 Le singole stazioni non possono essere considerate.

Scarica i dati in pochi semplici passaggi:

• Accedi alla piattaforma web oppure REGISTRATI gratuitamente se non hai ancora un account.
• Apri la pagina DATASET > Estrazione Dati.
• Seleziona un dataset.
• Applica i filtri (ad esempio product, time range).
• Invia la richiesta e monitora lo stato in DATASETS > Le mie richieste.
• Scarica i risultati da DATASET > Le mie richieste quando sono pronti.

Alcuni dataset sono disponibili per il download senza effettuare l'accesso.

Esistono tre modi per scaricare direttamente i dati:

• Collegamento diretto alla lista di output per variabile.
• Pacchetti di dati: includono variabili pre-selezionate (disponibili per specifici dataset di previsione e per dati radar).
• Download dei dati osservati dalle reti di monitoraggio tramite la Mappa dati osservati.

Collegamento diretto

Nella sezione DATASETS > Lista open data, usa il pulsante Browse single variable files a destra, per navigare tra le cartelle per run e selezionare le variabili di interesse.

Attualmente disponibile per:

• ICON-2I (surface and pressure levels)
• ICON-2I-RUC (Rapid Update Cycle)
• MOLOCH-AIM
• Seasonal Forecast (0.1° downscaling)
• WRF
• WW3 MEDITA

Ad eccezione di WW3 MEDITA e di Seasonal Forecast, questa funzione consente l'accesso solo ai dati dell'ultima settimana.

💡 Gli utenti possono anche accedere e scaricare i dati direttamente da:
https://meteohub.agenziaitaliameteo.it/nwp/

Pacchetti di dati

Nella sezione DATASETS > Lista open data, i pacchetti di dati sono insiemi di variabili di output selezionate pronti all'uso e forniti come un unico set scaricabile, disponibile per tutti gli utenti (inclusi quelli non autenticati).

Vengono generati quotidianamente e possono essere scaricati cliccando sul pulsante di download a destra. Essendo pre-elaborati, non è necessaria alcuna richiesta di estrazione.

I dataset attualmente supportati includono:

• ICON-2I (surface and pressure levels)
• BOLAM-ISAC
• MOLOCH-ISAC
• Radar SRI DPC
• WRF
• WRF_OL
• WRF_DA_ITA

Mappa dati osservati

I dati osservati possono essere scaricati direttamente da OBSERVATIONS > Mappa dati osservati.

• Il pulsante DOWNLOAD DATA nel menù laterale consente agli utenti di scaricare i dati per la variabile selezionata (precipitazione esclusa).
• Gli utenti non autenticati possono accedere agli ultimi 10 giorni e scaricare fino a 3 giorni consecutivi.
• Gli utenti autenticati hanno accesso completo e possono scaricare fino a 10 giorni consecutivi alla volta.

Dopo aver cliccato su DOWNLOAD DATA, gli utenti possono selezionare l’intervallo temporale desiderato e il formato di download preferito, quindi procedere con lo scaricamento dei dati. Per impostazione predefinita, il dataset esportato include i dati di tutte le stazioni attualmente disponibili sulla mappa.

💡 Al momento non è possibile selezionare singole stazioni o gruppi di stazioni personalizzati. I dati possono essere selezionati solo a livello di rete. Seleziona una rete dal menu a tendina NETWORKS per scaricarne i dati.

L’estrazione dati è un processo asincrono.

Questi sono i principali workflow:

User: Accesso → Invio di una richiesta → Monitoraggio dello stato della richiesta → Download del risultato

MeteoHub:

• Acquisizione delle richieste: Ricezione di una richiesta → Inserimento nella coda
• Elaborazione delle richieste (disaccoppiata): Recupero di una richiesta dalla coda → Elaborazione → Salvataggio del risultato

Utilizza l'interfaccia web per configurare e inviare richieste di estrazione senza bisogno di impostazioni tecniche.

Ideale per:

• Analisi esplorativa
• Download occasionali
• Estrazioni programmate.

💡 In qualsiasi fase della preparazione di una richiesta di estrazione dati, gli utenti possono annullare il processo cliccando sul pulsante Cancel, che li riporta alla pagina di selezione del dataset. Una volta cliccato sul pulsante Submit, la richiesta viene inviata al sistema MeteoHub e non può più essere revocata.

Step 1 — Registrati su MeteoHub

Per utilizzare l'estrazione dati, è necessario innanzitutto un account sulla piattaforma MeteoHub:

• Vai alla pagina SIGN UP e compila il modulo di registrazione.
• Controlla la tua casella di posta e clicca sul link di verifica per attivare il tuo account.

Step 2 — Seleziona uno o più dataset

Dopo aver effettuato l'accesso a MeteoHub, vai su DATASETS > Estrazione dati per avviare una richiesta e scegliere uno o più dataset dall'elenco.

È consentito selezionare più di un dataset contemporaneamente solo se i dataset:

• Appartengono alla stessa categoria
• Hanno licenze compatibili

Step 3 — Applica i filtri

I filtri dipendono dal tipo di dataset:

💡 Solo il Reference time è obbligatorio. Se gli altri filtri non vengono selezionati, non viene applicato alcun filtro.

Step 4 — Post-elaborazione opzionale

A seconda della configurazione del tuo account, è possibile applicare strumenti di post-elaborazione:

💡 La post-elaborazione può ridurre lo spazio di archiviazione necessario.

Step 5 — Invia la richiesta

Prima di inviare la richiesta, devi fornire un nome per la richiesta. Può essere una singola parola o una breve frase e non é necessario che sia univoco.

💡 Utilizza un nome chiaro e descrittivo.

Prima di inviare la richiesta, puoi anche pianificarla utilizzando il pulsante Schedule.

Per maggiori dettagli, consulta la sezione Programmazione delle richieste di questa guida.

Per completare la procedura, fai clic su Submit.

Step 6 — Scarica i resultati

Dopo l'invio, vieni reindirizzato a DATASET > Le mie richieste, dove puoi:

• Monitorare l'avanzamento della richiesta
• Scaricare il risultato della richiesta

Una volta pronti i risultati, ricevi una notifica via email.

Per maggiori dettagli, consulta la sezione Le mie richieste di questa guida.

💡 Nel Profilo utente, l'impostazione Notify on success request consente di attivare o disattivare le notifiche email per le richieste andate a buon fine. In caso di errore, le notifiche vengono sempre inviate.

La sezione include tre schede:

1. Requests
2. Schedules
3. Archive

1. Scheda Requests

Questa scheda visualizza tutte le richieste inviate dall'utente.

La richiesta più recente appare in cima, con lo stato PENDING se l'esecuzione è ancora in corso.

Facendo clic sull'icona di aggiornamento, le informazioni della pagina vengono aggiornate:

Quando lo stato della richiesta diventa SUCCESS, l'esecuzione è stata completata con successo e i dati di output sono disponibili per il download tramite l'icona di download corrispondente:

Facendo clic sull'icona del cestino rosso:

gli utenti possono scegliere una delle seguenti opzioni:

• Archive: la richiesta viene spostata nella scheda Archive, mentre tutti i file correlati vengono eliminati definitivamente.
• Delete: sia la richiesta che tutti i file associati verranno eliminati definitivamente.

Inoltre, le richieste non vengono conservate a tempo indeterminato a meno che non vengano archiviate. Esse scadono automaticamente dopo un massimo di 180 giorni. Quando una richiesta scade, il sistema la archivia o la elimina in base alla configurazione impostata tramite l'opzione Delete expired requests nella sezione Profile (accessibile dal menu in alto a destra).

Users can also configure a shorter expiration period using the “Requests expiration” field in the Profile page. Gli utenti possono anche configurare un periodo di scadenza più breve utilizzando il campo Requests expiration nel Profile.

💡 Questa funzionalità aiuta a gestire automaticamente le richieste e la conservazione dei dati, riducendo l'utilizzo dello spazio di storage poiché la quota di archiviazione per utente è limitata

Ulteriori informazioni sono disponibili nella scheda Requests

• L'utilizzo della quota di archiviazione da parte dell'utente viene visualizzato nella sezione Storage a sinistra.
• Il numero di richieste inviate durante l'ultima ora è visualizzato nella sezione Request Hourly Report a sinistra.

💡 Per rispettare i limiti di storage, le richieste che si prevede generino risultati di grandi dimensioni devono essere suddivise in richieste più piccole (vedere la sezione Buone pratiche di questa guida)

Dettagli della richiesta

Facendo clic sull'icona di espansione accanto al nome della richiesta:

gli utenti possono visualizzare ulteriori dettagli:

• Task ID
• Dataset
• Reference time
• Filter

Nell'angolo in alto a sinistra sono disponibili tre icone:

• Clone as a new request: crea una nuova richiesta basata su quella selezionata. Gli utenti possono modificarne i parametri e inviarla nuovamente
• Copy to clipboard: copia i parametri della richiesta in formato JSON.
• Download JSON: scarica i parametri della richiesta in un file JSON.

💡 Il JSON generato può essere riutilizzato per inviare la stessa richiesta tramite l'API.

2. Scheda Schedules

La scheda Schedules visualizza tutte le richieste pianificate create dall'utente.

Le richieste programmate possono essere:

• OFF per disattivarle temporaneamente
• ON per riattivarle
• Eliminate definitivamente

L'eliminazione di una richiesta programmata non rimuove automaticamente le richieste correlate dalla scheda Requests.

Espandendo la riga di una richiesta pianificata, gli utenti possono visualizzare:

• Dettagli della richiesta
• Metodo di pianificazione
• Data e dimensione dell'ultima esecuzione

È inoltre possibile scaricare il file di output dell'esecuzione più recente.

3. Scheda Archive

La scheda Archive visualizza le richieste archiviate. Le richieste archiviate possono anche essere eliminate definitivamente. Espandendo una richiesta archiviata, gli utenti possono visualizzare le informazioni standard relative alla richiesta.

Le seguenti funzioni sono disponibili anche per le richieste archiviate:

• Clone as a new request
• Copy to clipboard
• Download JSON

La pianificazione consente agli utenti di eseguire automaticamente le richieste per recuperare i nuovi dati aggiunti a un dataset dall'ultima esecuzione.

Esistono tre metodi di pianificazione:

• At time: esecuzione a orario fisso (ad esempio ogni giorno alle 09:00)
• Periodically: esecuzione ripetuta a intervalli regolari (ad esempio ogni 4 ore)
• On-data-ready: esecuzione automatica non appena sono disponibili nuovi dati.

💡 Per l’opzione Periodically, l'intervallo di programmazione non può essere inferiore a 15 minuti.

Dopo la pianificazione, la richiesta appare nella scheda Schedules e viene attivata automaticamente al verificarsi della condizione configurata.

Le richieste pianificate possono essere disattivate o eliminate definitivamente.

💡 Il metodo on-data-ready è particolarmente adatto per i dataset previsionali, in quanto attiva automaticamente la richiesta ogni volta che sono disponibili nuovi dati.

💡 Il metodo periodico è utile per recuperare dati osservati in tempo quasi reale, programmando le estrazioni a intervalli regolari (ad esempio ogni 30 minuti).

👉 Dati osservati

I dataset osservativi sono dinamici e possono essere aggiornati nel tempo, poiché correzioni o dati aggiuntivi potrebbero diventare disponibili anche giorni dopo la pubblicazione originale.

Di conseguenza, le estrazioni programmate non garantiscono una replica esatta del dataset nel tempo.

Facendo clic sull'icona Profile nell'angolo in alto a destra dell'intestazione, gli utenti possono visualizzare e gestire le impostazioni del proprio profilo.

👤 Informazioni Utente

• Full name: nome e cognome dell’utente.
• Email: indirizzo email dell’utente (usato anche come username).
• Group attualmente non in uso.
• Roles: classificazione dei ruoli dell’utente.
• Privacy accepted: indica se l’utente ha accettato l'informativa sulla privacy della piattaforma.

💾 Archiviazione e gestione dei dati

• Disk quota (GB): spazio di archiviazione assegnato all'utente per il salvataggio dei risultati delle richieste.
• Requests expiration (max 180 days): numero di giorni dopo i quali le richieste scadono.
• Delete expired requests (Yes/No):
  • Yes: le richieste scadute vengono eliminate.
  • No (impostazione predefinita): le richieste scadute vengono archiviate.

📊 Autorizzazioni di Accesso ai Dati

(Configurato dagli amministratori)

• Open datasets allowed (Yes/No): consente l'accesso ai dataset aperti.
• Allowed datasets: definisce l'accesso a dataset specifici (attualmente non in uso).
• Observation archive allowed (Yes/No): consente l'accesso allo storico dei dati osservati.

⚙️ Elaborazione e Pianificazione

(Configurato dagli amministratori)

• Post-processing allowed (Yes/No): consente l'utilizzo di strumenti di post-elaborazione.
• Schedules allowed (Yes/No): consente la pianificazione delle richieste di estrazione dati.
• Notify on success request: abilita o disabilita le notifiche email quando una richiesta viene completata con successo.

💡 In caso di fallimento della richiesta, le notifiche via email vengono sempre inviate indipendentemente da questa impostazione.

📦 Limits and Constraints

• Max number of templates – maximum number of templates (e.g. shapefile or GRIB templates) that can be uploaded for post-processing. Set to 0 for unlimited uploads.
• Max allowed output size (GB) – maximum output size for a single extraction request.
• Allowed requests per hour – maximum number of requests that can be submitted per hour. Set to 0 for no limit.

🔐 Security and Access

• Last password change – date of the last password update. Click Change to update the password.
• Open sessions – currently active user sessions.

🔑 Integration

• ARCO Access Key – allows users to create, replace, or delete the access key used for the ARCO service

👉 See the ARCO Guide for more details.

🧹 Deprecated / Unused

• AMQP Queue – currently not in use.

Editing the Profile

By clicking the Edit icon:

users can customise the following parameters:

• First name
• Last name
• Requests expiration in days (max 180)
• Delete expired requests (otherwise requests are archived)

The MeteoHub client is a command-line application designed for advanced users requiring automation features.

It is mainly intended for:

• Scheduled extractions
• Data bundle retrieval

The client does not support request or schedule creation: extraction requests and schedules must be created through the Web Interface or API.

👉 The client application can be downloaded from the GitLab repository, which also includes the related documentation.

💡 Use the API for fully automated end-to-end workflows.

The MeteoHub API enables full automation of data workflows, including:

• Request creation
• Scheduling
• Output download

👉 Swagger documentation is available here.

To use the authenticated APIs an access token must be provided.

The token is obtained from the login API:

https://meteohub.agenziaitaliameteo.it/auth/login

Example of the request:

POST https://meteohub.agenziaitaliameteo.it/auth/login
{ 
  "username": "user@example.com", 
  "password": "string", 
}

👉 The access token needs to be included in the Authorization header.

Example of an authenticated API request using cURL:

curl -X 'GET' 'https://meteohub.agenziaitaliameteo.it/api/requests' -H 'Authorization: Bearer <access token>'

To create a data extraction request, use the following API:

POST https://meteohub.agenziaitaliameteo.it/api/data

👉 This endpoint requires authentication. The access token obtained from the login API must be included in the Authorization header.

The request body must include:

• Request name
• Dataset(s)
• Reference time in UTC
• Filters (optional)
• Post-processing (optional)

Example of the request body:

{
  "request_name": "name of the request",
  "reftime": {
    "from": "2022-01-10T11:04:54.615Z",
    "to": "2022-01-10T11:04:54.615Z"
  },
  "dataset_names": [
    "dataset_name"
  ],
  "filters": {
    "area": [{}],
    "level": [{}],
    "origin": [{}],
    "proddef": [{}],
    "product": [{}],
    "quantity": [{}],
    "run": [{}],
    "task": [{}],
    "timerange": [{}],
    "network": [{}]
  },
  "output_format": "json",
  "only_reliable": true,
  "postprocessors": [
    {}
  ]
}

💡 Filters are dataset-specific (see the related table in this guide).

Observation datasets also support:

• output_format (optional) – returns data in JSON format instead of the default BUFR format.
• only_reliable (optional) – excludes data marked as unreliable.

💡 To simplify request creation, especially when specific filters are required, first generate a request through the Web Interface. Then, from the “My Requests” page, use the “Copy to clipboard” option to copy the precompiled JSON body and reuse it in the API.

To create a scheduled data extraction request, use the following API:

POST https://meteohub.agenziaitaliameteo.it/api/schedules

👉 This endpoint requires authentication. The access token obtained from the login API must be included in the Authorization header of the request.

The request body is similar to the one described in the previous section “Submit a Data Extraction Request”, with additional parameters to define the scheduling interval.

The available scheduling methods are:

• Periodic extraction – data is extracted at regular time intervals (e.g. every 4 hours).

To enable this method, add the following parameter to the request body:

"period-settings": { 
  "every": number,    // time interval of the extraction    
  "period": string    // one of: “minutes","hours","days"  
}

👉 Any extraction interval can be specified, with a minimum value of 15 minutes.

• Fixed-time execution – data is extracted on specific days at a specific time (e.g. every Monday at 09:00).

To enable this method, add the following parameter to the request body:

"crontab-settings": { 
  "minute": number #range between 0-59,     
  "hour": number   #range between 0-23,     
  "day_of_week": number    // range between 0-7 where 0 and 7 refers 
                           // to Sunday, 1 to Monday, and so on 
  "day_of_month": number    // range between 0-31
  "month_of_year": number   // range between 1-12 where 1 refers to
                            // January and 12 refers to December  
}

👉 If no values are provided for day_of_week, day_of_month, or month_of_year, the request defaults to a daily schedule (every day of the year).

• On-data-ready – data is extracted as soon as it becomes available.

To enable this method, add the following parameter to the request body:

"on-data-ready": true

👉 This option is supported only for forecast datasets.

• Retrieve the list of all submitted requests and their status:

GET https://meteohub.agenziaitaliameteo.it/api/requests

If the data extraction is complete, the fileoutput parameter in the response indicates the name of the output file.

• Download the file using the dedicated endpoint:

GET https://meteohub.agenziaitaliameteo.it/api/data/{filename}

where the parameter filename specifies the file to download.

👉 These endpoints require authentication. The access token obtained from the login API must be included in the Authorization header of the requests.

• Use this endpoint to retrieve all submitted requests and identify the id of the request of interest:

GET https://meteohub.agenziaitaliameteo.it/api/requests

If the data extraction is complete, the fileoutput parameter in the response indicates the name of the output file.

• Delete the request using the dedicated endpoint:

DELETE https://meteohub.agenziaitaliameteo.it/api/requests/{request_id} 

where the parameter request_id specifies the id of the request to delete.

👉 These endpoints require authentication. The access token obtained from the login API must be included in the Authorization header of the requests.

💡The request ID is also returned in the response of the data extraction endpoint as the request_id field.

👉 No authentication is required to use these APIs, unless the requested dataset has restricted access.

Download data bundles with filters

Use this endpoint to download one or more data bundles filtered by dataset, reference date, and/or run:

GET https://meteohub.agenziaitaliameteo.it/api/opendata/{dataset_id}/download?reftime={reference_date}&run={run}

• dataset_name – corresponds to the Dataset ID shown on the Open Data List page.
• reference_date – supported formats are YYYYMMDD or YYYY-MM-DD (e.g. to download bundles for January the 10th 2022 use 20220110 or 2022-01-10).
• run – valid time in HH:MM (e.g.12:00), expressed in UTC.

Download a specific data bundle

Retrieve the list of available data bundles for a specific dataset:

GET https://meteohub.agenziaitaliameteo.it/api/datasets/{dataset_id}/opendata

• dataset_id – corresponds to the Dataset ID shown on the Open Data List page.

The filename field in the response indicates the name of each data bundle.

👉 This feature is currently available only for a subset of forecast datasets and for the radar_sri_dpc dataset (see enabled datasets in section Data bundle).

Download the data bundle:

GET https://meteohub.agenziaitaliameteo.it/api/opendata/{filename} 

The filename parameter is the name of the data bundle of interest.

🔹 Use the API for automated pipelines.

🔹 Prefer scheduled extractions for recurring workflows.

🔹 Use filters to optimize storage usage.

🔹 To comply with disk quotas, split requests expected to generate large outputs into smaller requests.

🔹 Use the configuration options in the Profile section (icon in the top-right corner of the header) to manage automatically the retention of request and related data, helping free up storage space since user disk quota is limited.

🔹 Deleting a request: in the DATASETS > My Requests page, clicking the red trash-bin icon allows users to either delete or archive the request. Both the request and all associated files are permanently deleted.

🔹 Requests expiration: requests are not stored indefinitely and expire after a user-defined retention period configured in the Profile. The default and maximum retention period is 180 days.

🔹 Retention of expired requests: users can choose in their Profile how to handle expired requests by deleting or archiving them.

🔹 Archiving requests: the request is archived and all related files are permanently deleted. Archived requests are listed in the “Archived” tab of DATASETS > My request page. Users can re-execute an archived request using the "Clone" button on the right-side of the details of the request itself.

(Only administrators can modify these parameters. Current values can be viewed in the Profile section)

🔹 Disk quota limit: the storage space allocated to users for saving request results is limited. Default is 1.0 GB.

🔹 Max allowed output size (GB): the maximum output size for a single data extraction request is limited. Default is 1.0 GB.

🔹 Allowed requests per hour: the maximum number of requests that can be submitted per hour is limited. Default is 10.

🔹 Max number of templates: the maximum number of templates (e.g. shapefile or GRIB templates) that can be uploaded is limited. Default is 1.

🔹 Use the precompiled JSON in the request details (“My Requests” page) to submit the same request via API.

🔹 If no filters are selected, all data available in the dataset for the specified reference time period is retrieved. The reference time period is the only mandatory filter.

🔹 Filtering by individual stations or custom station groups is not supported for data extraction and download. Observed data can only be retrieved at the network level.

To obtain data for specific stations, the recommended approach is:

1. Submit an extraction request with the desired filters (e.g. variables, networks, and time range)
2. Post-process the resulting JSON Lines output file with a custom script to retain only the stations of interest

🔹 In the user Profile, the “Notify on success request” setting allows users to enable or disable email notifications when a request completes successfully. In case of request failure, email notifications are always sent regardless of this setting.

🔹 The on-data-ready scheduling method is suitable for forecast datasets, as it automatically triggers requests whenever new forecast data becomes available.

🔹 The periodic scheduling method can be used to retrieve near-real-time observed data by executing extractions at regular intervals (e.g. every 30 minutes).

🔹 Observed datasets are dynamic and may be updated over time, since corrections or additional data can be received even days after the initial publication. As a result, scheduled extractions do not guarantee an exact replica of the dataset over time.

⚠️ If the disk quota is exceeded, the scheduled requests are automatically disabled. They are not automatically reactivated when storage space becomes available and must be manually re-enabled from the “Schedules” tab.

⚠️ The first time an on-data-ready request is created and scheduled, it is executed immediately and then automatically re-executed whenever new data becomes available. In contrast, when a previously disabled on-data-ready request is reactivated, it resumes processing only for newly available data. Any data received during the deactivation period is not recovered.

🔹 Request taking too long?
Apply filters or split the request into smaller ones. Delays may also be caused by temporary system overload.

🔹 Dataset unavailable?
Check user permissions, licensing restrictions, or the API request syntax.

🔹 Request pending for too long?

• Please be patient: temporary system overload may delay processing.
• If the request remains pending for more than one day, contact support.
• Requests still pending after two days are automatically marked as failed and can then be deleted

🔹 Authentication errors?
Verify that your API token is valid and has not expired.

🔹 Request failed due to empty results?
Possible causes include:

• Incorrect filter combinations in the API request.
• Requested reference time (reftime) not available.

🔹 Common causes of request failure

• Output size exceeds the allowed limit.
• User storage quota has been exceeded.

🔹 How can I monitor the status of my requests?

In the Web Interface, request status is available under DATASETS > My Requests.

Via the API, you can retrieve all submitted requests together with their current status using:

GET https://meteohub.agenziaitaliameteo.it/api/requests

This API requires authentication. See the Get an Access Token section_ in this guide.

🔹 How can I check my current disk quota usage?

In the Web Interface, current disk quota usage is displayed in the DATASETS > My Requests page under the Storage indicator on the left.

Via the API, storage usage can be retrieved using:

GET https://meteohub.agenziaitaliameteo.it/api/usage

This API requires authentication. See the Get an Access Token section_ in this guide.

💡 API usage values are expressed in bytes.

🔹 How can I see how many requests I made in the last hour and how many I can still submit?

In the Web Interface, this information is available in the DATASETS > My Requests page under the Request Hourly Report indicator on the left.

Via the API, the same information can be retrieved using:

GET https://meteohub.agenziaitaliameteo.it/api/hourly

This API requires authentication. See the Get an Access Token section in this guide.

Per assistenza o richieste di informazioni tecniche, contattare:

meteohub-support@cineca.it