Récupérer les régions de prévision

GET https://contrails.googleapis.com/v2/regions : obtenez les régions d'évitement des traînées de condensation au format multipolygone GeoJSON.

Si la requête aboutit, la réponse sera un FeatureCollection au format GeoJSON.

Les régions d'évitement des traînées de condensation renvoyées au format polygone sont classées par niveau de gravité, de 1 à 4 pour chaque niveau de vol. Plus la valeur est élevée, plus la traînée de condensation est importante.

Paramètres de requête

Paramètres
time

string

Obligatoire. Heure de la demande.

Format : chaîne de date et heure ISO 8601 OU entier d'époque Unix

Exemple : 2026-01-20T21:00:00Z
flightLevel[]

integer

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 : [270, 280, 290, 300]
threshold

integer

Facultatif. Seuil de niveau de gravité minimal. Si vous définissez ce champ, seules les régions dont la gravité est supérieure ou égale au seuil seront renvoyées.

Format : les valeurs valides sont comprises entre 1 et 4 (inclus).
aircraftClass

string

Facultatif. Classe de l'aéronef. Pour le moment, seul le type default est compatible.

Exemples

  • Pour récupérer toutes les régions d'évitement des traînées de condensation à un moment précis :

    response = requests.get(
  url="https://contrails.googleapis.com/v2/regions",
  params={"time": 2026-01-27T12:00:00Z},
  headers={"x-goog-api-key": API_KEY},
)

    La réponse GeoJSON liste toutes les régions d'évitement des traînées de condensation au format polygone :

    géométrie flight_level threshold (seuil) heure forecast_reference_time aircraft_class
    0 MULTIPOLYGON Z (((166.25 81.12 8229.6, 168.37 ... 270 1 2026-01-28T20:00:00+00:00 2026-01-27T08:00:00+00:00 par défaut
    1 MULTIPOLYGON Z (((92.38 45.5 8229.6, 93 46.62 ... 270 2 2026-01-28T20:00:00+00:00 2026-01-27T08:00:00+00:00 par défaut
    2 MULTIPOLYGON Z (((83.38 65 8229.6, 84 66.12 82... 270 3 2026-01-28T20:00:00+00:00 2026-01-27T08:00:00+00:00 par défaut
    3 MULTIPOLYGON Z (((57.38 76 8229.6, 57.75 76.88... 270 4 2026-01-28T20:00:00+00:00 2026-01-27T08:00:00+00:00 par défaut
    4 MULTIPOLYGON Z (((162.38 79 8534.4, 162.75 79.... 280 1 2026-01-28T20:00:00+00:00 2026-01-27T08:00:00+00:00 par défaut

  • Pour récupérer les régions d'évitement des traînées de condensation limitées à des niveaux de vol spécifiques, avec le temps spécifié sous la forme d'un entier epoch Unix :

    response = requests.get(
  url="https://contrails.googleapis.com/v2/regions",
  params={
    "time": 1768942800,
    "flightLevel": [300,310,320,330]
  },
  headers={"x-goog-api-key": API_KEY},
)

  • Pour récupérer les régions d'évitement des traînées de condensation limitées à des niveaux de vol spécifiques et égales ou supérieures à un seuil de niveau de gravité de 3 :

    response = requests.get(
  url="https://contrails.googleapis.com/v2/regions",
  params={
    "time": 2026-01-27T12:00:00Z,
    "flightLevel": [300,310,320,330],
    "threshold": 3
  },
  headers={"x-goog-api-key": API_KEY},
)