Busca de Observações Meteorológicas

Visão Geral

Recupere relatórios meteorológicos medidos de superfície e de altitude sem perder a identidade da estação, hora da observação, unidades, valores brutos ou indicadores de qualidade do provedor. Escolha a fonte por tipo de observação e necessidade de retenção, em seguida, valide os registros retornados antes da normalização.

Esta funcionalidade abrange METARs, observações de superfície históricas, radiosondas e metadados de estação. Exclui saídas de modelos, volumes de radar e imagens de satélite.

Quando Usar Esta Funcionalidade

• Uma tarefa precisa de observações METAR recentes para estações nomeadas ou uma pequena região.
• Dados de superfície horários ou sinóticos históricos são necessários do NOAA NCEI.
• Um fluxo de trabalho de sondagem precisa de perfis de radiosonda observados em vez de perfis de modelo.
• Identificadores de estação, realocações, instrumentos ou metadados precisam ser resolvidos.
• Uma busca retornou valores duplicados, desatualizados, com unidades ambíguas ou com indicadores de qualidade.

Não use produtos de previsão como observações, e não substitua um ponto de grade de modelo próximo por um relatório de estação ausente sem aprovação explícita.

Escolha a Fonte

Prefira um adaptador de projeto existente quando ele já lida com o esquema do provedor, retentativas e cache. Registre o endpoint exato ou o objeto de arquivo usado.

Defina a Solicitação de Observação

Resolva estes valores antes de buscar:

• tipo de observação e variáveis;
• sistema de identificador de estação, não apenas a string do identificador;
• instantes de início e fim em UTC, incluindo a inclusividade do intervalo;
• idade máxima aceitável da observação;
• formas de saída bruta, decodificada ou ambas;
• indicadores de qualidade exigidos e política para valores rejeitados;
• unidades de saída e representação de valor ausente;
• local e retenção do cache.

Para consultas espaciais, também defina a geometria de busca, o limite de distância e como uma estação é selecionada. Retorne a estação selecionada e a distância em vez de usar silenciosamente o relatório mais próximo.

Busque METARs Recentes

O Aviation Weather Center expõe dados METAR legíveis por máquina em /api/data/metar. Envie um agente de usuário descritivo, mantenha a consulta restrita e trate um 204 No Content válido separadamente de um erro.

import json
from urllib.error import HTTPError
from urllib.parse import urlencode
from urllib.request import Request, urlopen


def fetch_metars(stations, hours=2):
    station_ids = sorted({station.strip().upper() for station in stations})
    if not station_ids or any(len(station) != 4 for station in station_ids):
        raise ValueError("use one or more four-character ICAO station IDs")
    if not 1 <= hours <= 24:
        raise ValueError("hours must be between 1 and 24 for this narrow query")

    query = urlencode({
        "ids": ",".join(station_ids),
        "format": "json",
        "hours": hours,
    })
    request = Request(
        f"https://aviationweather.gov/api/data/metar?{query}",
        headers={"User-Agent": "weather-observation-fetching/1.0 contact@example.org"},
    )
    try:
        with urlopen(request, timeout=30) as response:
            if response.status == 204:
                return []
            records = json.load(response)
    except HTTPError as exc:
        if exc.code == 429:
            raise RuntimeError("AWC rate limit reached; honor Retry-After") from exc
        raise

    if not isinstance(records, list):
        raise RuntimeError("unexpected METAR response shape")
    return records

Substitua o endereço de contato de exemplo por um contato de projeto apropriado. Para um instantâneo atual em grande escala, baixe o arquivo de cache compactado do provedor uma vez em vez de emitir muitas consultas de estação.

Busque Dados de Superfície Históricos

Para ISD:

1. Resolva a estação usando o inventário de estação atual e seus identificadores USAF/WBAN.
2. Confirme que a cobertura da estação se sobrepõe ao intervalo de tempo solicitado.
3. Use arquivos HTTPS em massa para uma solicitação histórica grande; evite uma chamada de rede por observação.

…