Recupera una cuadrícula de previsión

GET https://contrails.googleapis.com/v2/grids: Obtén una cuadrícula de pronósticos de estelas de condensación.

Si la solicitud se realiza correctamente, la respuesta será un archivo NetCDF con los valores de forzamiento de estelas de condensación.

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
bbox[]

number

Opcional. Son los límites de la región que se devolverá.

Formato: [lng_min, lat_min, lng_max, lat_max]

Ejemplo: [-40, 20, 20, 60]
aircraftType

string

Opcional. Código de aeronave.

Formato: Código de tipo de aeronave de la OACI de 4 caracteres

Ejemplo: A320
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]
format

string

Opcional. Es el formato solicitado. Si se pasa un valor que no sea "netcdf4", se generará un error UNIMPLEMENTED, ya que no se admiten los polígonos.
aircraftClass

string

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

string

Opcional. Este campo especifica qué variables de datos se deben incluir en la respuesta. Puede controlar una o varias variables de datos. Si este campo está vacío o no se proporciona, el valor predeterminado es ["contrails"].

Ejemplo: ["contrails", "expected_effective_energy_forcing"]

Ejemplos

  • Para recuperar la cuadrícula de estelas predeterminada global para un momento específico, haz lo siguiente:

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

    Cuando se carga con Xarray, esta solicitud devuelve el siguiente conjunto de datos:

    Dimensiones: (longitud: 1441, latitud: 721, nivel_de_vuelo: 18, hora: 1)
    Coordenadas
    Nombre Dimensiones Tipo de datos Valores
    longitude (longitud) float32 -180.0 -179.8 … 179.8 1…
    latitude (latitud) float32 -90.0 -89.75 -89.5 … 8…
    flight_level (flight_level) int16 270, 280, 290, 300… 41…
    time (hora) datetime64[ns] 2026-01-28T20:00:00
    forecast_reference_time (hora) datetime64[ns] 2026-01-27T08:00:00
    Variables de datos
    estelas de condensación (longitud, latitud, nivel_vuelo, hora) float32 0.0 0.0 0.0 0.0 … 0.0 …
    Atributos
    inference_pipeli... contrails.forecast-pipeline_20260115.02_p0
    api_version : contrails.api-service_20260125.00_p0
    aircraft_class : predeterminado

  • Para recuperar una cuadrícula limitada a un límite geográfico específico y filtrada para un tipo de aeronave específico, con el tiempo especificado como un número entero de época de Unix, haz lo siguiente:

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

  • Para recuperar una cuadrícula limitada a un subconjunto de niveles de vuelo y una región específica con las capas contrails y expected_effective_energy_forcing, haz lo siguiente:

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