Recuperare le regioni di previsione

GET https://contrails.googleapis.com/v2/regions: ottieni le regioni di evitamento delle scie di condensazione nel formato multipoligono GeoJSON.

In caso di esito positivo, la risposta sarà un FeatureCollection in formato GeoJSON.

Le regioni di evitamento delle scie restituite in formato poligonale sono classificate in base ai livelli di gravità, che vanno da 1 a 4 per ogni livello di volo. Più alto è il valore, più grave è la scia di condensazione.

Parametri di query

Parametri
time

string

Obbligatorio. Ora della richiesta.

Formato: stringa di data e ora ISO 8601 O numero intero di epoca Unix

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

integer

Facoltativo. Livelli di volo da restituire. Se non viene specificato alcun livello di volo, vengono inclusi tutti i livelli di volo.

Formato: livelli di volo in ettometri; [270, 280, 290, 300, 310, 320, 330, 340, 350, 360, 370, 380, 390, 400, 410, 420, 430, 440]

Esempio: [270, 280, 290, 300]
threshold

integer

Facoltativo. Soglia minima del livello di gravità. Se imposti questo campo, vengono restituite solo le regioni con gravità maggiore o uguale alla soglia.

Formato: i valori validi sono compresi tra 1 e 4 (inclusi).
aircraftClass

string

Facoltativo. Classe di aeromobili. Al momento è supportato solo default.

Esempi

  • Per recuperare tutte le regioni di evitamento delle scie di condensazione per un momento specifico:

    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 risposta GeoJSON elenca tutte le regioni di evitamento delle scie di condensazione in formato poligonale:

    geometria flight_level soglia tempo 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 predefinito
    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 predefinito
    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 predefinito
    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 predefinito
    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 predefinito

  • Per recuperare le regioni di evitamento delle scie di condensazione limitate a livelli di volo specifici, con l'ora specificata come numero intero dell'epoca 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},
)

  • Per recuperare le regioni di evitamento delle scie di condensazione limitate a livelli di volo specifici e uguali o superiori a una soglia di livello di gravità pari a 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},
)