Scopri cosa puoi creare con l'API Contrails e come si comportano i suoi endpoint.
Panoramica
L'API Contrails combina dati meteorologici su larga scala, dati di volo e immagini satellitari con un modello di visione artificiale all'avanguardia per produrre previsioni delle scie di condensazione basate sull'AI. Queste previsioni indicano le zone in cui è probabile la formazione di scie di condensazione e il potenziale impatto delle scie di condensazione per le prossime 48 ore.
L'integrazione di queste previsioni nei flussi di lavoro di pianificazione del volo può aiutare i piloti a evitare di sorvolare queste regioni, impedendo la formazione di scie di condensazione che contribuiscono al riscaldamento globale.
Per comprendere queste informazioni su dove si formeranno le scie di condensazione e sul loro riscaldamento, l'API Contrails offre previsioni sotto forma di griglie e regioni.
Previsioni
L'API Contrails offre previsioni come:
Griglie:dati 4D ad alta fedeltà che rappresentano i valori dell'indice di forzatura delle scie di condensazione sugli assi di latitudine, longitudine, altitudine e tempo, in formato NetCDF. Queste griglie rappresentano l'intero globo come una griglia di un quarto di grado, in cui i passaggi di latitudine e longitudine sono di 0,25 gradi. Ogni griglia è prevista per un'ora intera (UTC).
I valori dell'indice di forzatura delle scie di condensazione vanno da 0, che rappresenta una località senza riscaldamento significativo, a 4, che rappresenta una località con un forte riscaldamento dovuto alle scie di condensazione.
Le griglie sono consigliate per la pianificazione programmatica dei voli, soprattutto per il reindirizzamento dei voli.
Regioni:versione semplificata e poligonale della previsione, che rappresenta le regioni di evitamento delle scie di condensazione nel formato multipoligono GeoJSON.
Le regioni di evitamento delle scie di condensazione sono classificate con gli stessi livelli di gravità, ma omettono 0 e iniziano solo da 1 (impatto leggero).
Le regioni sono consigliate per i pianificatori di volo umani che possono stabilire politiche basate sui livelli di gravità e possono riassegnare manualmente le rotte dei voli, in genere tramite deviazioni verticali (ovvero regolando i livelli di volo).
Autenticazione
Per utilizzare l'API Contrails, devi disporre di una chiave API e devi abilitare l'API Contrails.
Per informazioni dettagliate, segui la guida alla configurazione dell'ambiente.
Errori
Quando utilizzi l'API Contrails, puoi riscontrare i seguenti errori:
| Codice | Causa | Gestione degli errori |
|---|---|---|
| 400 (richieste non valide) | Richiesta con dati errati | Non riprovare automaticamente. Questo errore è causato da problemi nel codice; controlla di utilizzare il formato dei parametri corretto. |
| 404 | Richiesta di un orario di previsione che non è ancora stato calcolato | Riprova con una strategia di backoff esponenziale. |
| 429 | Numero eccessivo di richieste (consulta Limiti di utilizzo) | Riprova con il backoff esponenziale. |
| 5XX | Errore del server | Riprova con il backoff esponenziale. |
Controllo delle versioni
Le release delle versioni principali, come il lancio della v2, possono introdurre un comportamento incompatibile con le release precedenti e potrebbero richiedere modifiche al codice.
Gli aggiornamenti regolari tra le release delle versioni principali dovrebbero essere compatibili con le versioni precedenti.
Puoi leggere gli aggiornamenti chiave nelle note di rilascio dell'API Contrails.
Passaggi successivi
- Per iniziare a utilizzare l'API Contrails, configura l'ambiente.
- Leggi la documentazione di riferimento dell'API Contrails per indicazioni dettagliate sui metodi API Contrails disponibili.
- Leggi la panoramica delle previsioni delle scie di condensazione per capire come vengono calcolate le previsioni dell'API Contrails.