Recuperar uma grade de previsão

GET https://contrails.googleapis.com/v2/grids: recebe uma grade de previsões de rastros de condensação.

Se for bem-sucedida, a resposta será um NetCDF de valores de forçante de rastros de condensação.

Parâmetros de consulta

Parâmetros
time

string

Obrigatório. Horário da solicitação.

Formato: string de data e hora ISO 8601 OU número inteiro de época Unix

Exemplo: 2026-01-20T21:00:00Z
bbox[]

number

Opcional. Limites da região a ser retornada.

Formato: [lng_min, lat_min, lng_max, lat_max]

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

string

Opcional. Código da aeronave.

Formato: código de tipo de aeronave ICAO de 4 caracteres

Exemplo: A320
flightLevel[]

integer

Opcional. Níveis de voo a serem retornados. Se nenhum nível de voo for especificado, todos os níveis de voo serão incluídos.

Formato: níveis de voo em hectopés; [270, 280, 290, 300, 310, 320, 330, 340, 350, 360, 370, 380, 390, 400, 410, 420, 430, 440]

Exemplo: [270, 280, 290, 300]
format

string

Opcional. Formato solicitado. A transmissão de um valor diferente de "netcdf4" vai gerar um erro UNIMPLEMENTED, já que os polígonos não são aceitos.
aircraftClass

string

Opcional. Classe de aeronave. Atualmente, somente default é aceito.
data[]

string

Opcional. Esse campo especifica quais variáveis de dados serão incluídas na resposta. Ele pode processar uma ou várias variáveis de dados. Se esse campo estiver vazio ou não for fornecido, o padrão será ["contrails"].

Exemplo: ["contrails", "expected_effective_energy_forcing", "persistent_formation_probability", "nominal_cocip_effective_energy_forcing"]

Exemplos

  • Para recuperar a grade global padrão de rastros de condensação para um momento específico:

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

    Quando carregada com xarray, essa solicitação retorna o seguinte conjunto de dados:

    Dimensões: (longitude: 1441, latitude: 721, flight_level: 18, time: 1)
    Coordenadas
    Nome Dimensões Tipo de dados Valores
    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...
    time (time) datetime64[ns] 2026-01-28T20:00:00
    forecast_reference_time (time) datetime64[ns] 2026-01-27T08:00:00
    Variáveis de dados
    contrails (longitude, latitude, flight_level, time) 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 : default

  • Para recuperar uma grade limitada a um limite geográfico específico e filtrada para um tipo de aeronave específico, com o tempo especificado como um número inteiro de época 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},
)

  • Para recuperar uma grade limitada a um subconjunto de níveis de voo e uma região específica com as camadas contrails e expected_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},
)

  • Se você quiser recuperar uma grade com as variáveis de dados contrails, persistent_formation_probability e nominal_cocip_effective_energy_forcing:

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