Recupera regiones de previsión

GET https://contrails.googleapis.com/v2/regions: Obtén regiones de evitación de estelas de condensación en formato de polígonos múltiples GeoJSON.

Si la operación se realiza correctamente, la respuesta será un FeatureCollection en formato GeoJSON.

Las regiones de evitación de estelas devueltas en formato de polígono se clasifican según niveles de gravedad, que van del 1 al 4 para cada nivel de vuelo. Cuanto más alto sea el valor, más grave será la estela.

Parámetros de consulta

Parámetros
time

string

Obligatorio. Hora de la solicitud.

Formato: Cadena de fecha y hora ISO 8601 O número entero de época de Unix

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

integer

Opcional. Son los niveles de vuelo que se devolverán. Si no se especifica ningún nivel de vuelo, se incluyen todos.

Formato: Niveles de vuelo en hectopulgadas; [270, 280, 290, 300, 310, 320, 330, 340, 350, 360, 370, 380, 390, 400, 410, 420, 430, 440]

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

integer

Opcional. Es el umbral de nivel de gravedad mínimo. Si se configura este campo, solo se devuelven las regiones con una gravedad mayor o igual que el umbral.

Formato: Los valores válidos varían de 1 a 4 (inclusive).
aircraftClass

string

Opcional. Clase de aeronave. Por el momento, solo se admite default.

Ejemplos

  • Para recuperar todas las regiones de evitación de estelas de condensación para un momento específico, haz lo siguiente:

    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 respuesta de GeoJSON enumera todas las regiones de evitación de estelas de condensación en formato de polígono:

    geometría flight_level umbral hora 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 predeterminado
    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 predeterminado
    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 predeterminado
    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 predeterminado
    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 predeterminado

  • Para recuperar las regiones de evitación de estelas de condensación limitadas a niveles de vuelo específicos, con el tiempo especificado como un número entero de época Unix, haz lo siguiente:

    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},
)

  • Para recuperar las regiones de evitación de estelas de condensación limitadas a niveles de vuelo específicos y con un umbral de nivel de gravedad igual o superior a 3, haz lo siguiente:

    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},
)