GET https://contrails.googleapis.com/v2/grids : obtenir une grille de prévisions de traînées de condensation.
Si la requête aboutit, la réponse sera un fichier NetCDF contenant les valeurs de forçage des traînées de condensation.
Paramètres de requête
| Paramètres | |
|---|---|
time |
Obligatoire. Heure de la demande. Format : chaîne de date et heure ISO 8601 OU entier d'époque Unix Exemple : |
bbox[] |
Facultatif. Limites de la région à renvoyer. Format : [lng_min, lat_min, lng_max, lat_max] Exemple : |
aircraftType |
Facultatif. Code de l'avion. Format : code de type d'aéronef OACI à quatre caractères Exemple : |
flightLevel[] |
Facultatif. Niveaux de vol à renvoyer. Si aucun niveau de vol n'est spécifié, tous les niveaux de vol sont inclus. Format : niveaux de vol en hectopiés ; [270, 280, 290, 300, 310, 320, 330, 340, 350, 360, 370, 380, 390, 400, 410, 420, 430, 440] Exemple : |
format |
Facultatif. Format demandé. Si vous transmettez une valeur autre que "netcdf4", une erreur UNIMPLEMENTED sera générée, car les polygones ne sont pas acceptés. |
aircraftClass |
Facultatif. Classe de l'aéronef. Pour le moment, seul le type |
data[] |
Facultatif. Ce champ spécifie les variables de données à inclure dans la réponse. Il peut gérer une ou plusieurs variables de données.
Si ce champ est vide ou n'est pas renseigné, la valeur par défaut est Exemple : |
Exemples
Pour récupérer la grille de contrails mondiale par défaut à un moment précis :
response = requests.get( url="https://contrails.googleapis.com/v2/grids", params={"time": 2026-01-27T12:00:00Z}, headers={"x-goog-api-key": API_KEY}, )Lorsqu'elle est chargée avec xarray, cette requête renvoie l'ensemble de données suivant :
Dimensions : (longitude : 1441, latitude : 721, niveau_de_vol : 18, heure : 1) Coordonnées Nom Dimensions Type de données Valeurs longitude (longitude) float32 -180,0 -179,8 ... 179,8 1... latitude (latitude) float32 -90,0 -89,75 -89,5 ... 8... flight_level (flight_level) int16 270 280 290 300 … 41… durée (heure) datetime64[ns] 2026-01-28T20:00:00 forecast_reference_time (heure) datetime64[ns] 2026-01-27T08:00:00 Variables de données contrails (longitude, latitude, niveau_de_vol, heure) float32 0.0 0.0 0.0 0.0 ... 0.0 ... Attributs inference_pipeli... contrails.forecast-pipeline_20260115.02_p0 api_version : contrails.api-service_20260125.00_p0 aircraft_class : par défaut Pour récupérer une grille limitée à une limite géographique spécifique et filtrée pour un type d'aéronef spécifique, avec une heure spécifiée sous la forme d'un entier d'époque Unix :
response = requests.get( url="https://contrails.googleapis.com/v2/grids", params={"time": 1769508160, "bbox": [-40, 20, 20, 60], "aircraftType": "A320" }, headers={"x-goog-api-key": API_KEY}, )Pour récupérer une grille limitée à un sous-ensemble de niveaux de vol et à une région spécifique avec les calques
contrailsetexpected_effective_energy_forcing:response = requests.get( url="https://contrails.googleapis.com/v2/grids", params={"time": 2026-01-27T12:00:00Z, "bbox": [-10, 40, 10, 55], "flightLevel": [300,310,320,330], "data": ["contrails", "expected_effective_energy_forcing"] }, headers={"x-goog-api-key": API_KEY}, )