Recuperar uma grade de previsão

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

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

Parâmetros de consulta

Parâmetros
time

string

Obrigatório. Hora 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 quatro caracteres do tipo de aeronave da OACI

Exemplo: A320
flightLevel[]

integer

Opcional. Níveis de voo a serem retornados. Se nenhum nível de voo for especificado, todos 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. Transmitir um valor diferente de "netcdf4" vai gerar um erro UNIMPLEMENTED porque polígonos não são compatíveis.
aircraftClass

string

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

string

Opcional. Esse campo especifica quais variáveis de dados incluir 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"]

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 (horário) datetime64[ns] 2026-01-28T20:00:00
    forecast_reference_time (horário) datetime64[ns] 2026-01-27T08:00:00
    Variáveis de dados
    trilhas de condensação (longitude, latitude, nível_de_voo, tempo) 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 : padrão

  • Para recuperar uma grade limitada a uma fronteira geográfica específica 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},
)