Recuperar regiões de previsão

GET https://contrails.googleapis.com/v2/regions: receba regiões de prevenção de rastros de condensação no formato multipolígonos GeoJSON.

Se a solicitação for bem-sucedida, a resposta será um FeatureCollection no formato GeoJSON.

As regiões de prevenção de rastros de condensação retornadas em formato de polígono são classificadas por níveis de gravidade, que variam de 1 a 4 para cada nível de voo. Quanto maior o valor, mais grave é o rastro.

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
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]
threshold

integer

Opcional. Limite mínimo de nível de gravidade. Definir esse campo retorna apenas regiões com gravidade maior ou igual ao limite.

Formato: os valores válidos variam de 1 a 4 (inclusive).
aircraftClass

string

Opcional. Classe da aeronave. Atualmente, somente default é aceito.

Exemplos

  • Para recuperar todas as regiões de prevenção de rastros de condensação em um momento específico:

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

    A resposta GeoJSON lista todas as regiões de prevenção de rastros de condensação no formato de polígono:

    geometria flight_level limite 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 padrão
    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 padrão
    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 padrão
    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 padrão
    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 padrão

  • Para recuperar regiões de prevenção de rastros de condensação limitadas a níveis de voo específicos, com o tempo especificado como um número inteiro da época 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},
)

  • Para recuperar regiões de prevenção de rastros de condensação limitadas a níveis de voo específicos e iguais ou acima de um limite de nível de gravidade de 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},
)