Portal do Governo Brasileiro

Manual de uso da API Estações e Dados Meteorológicos

  • Recuperar todas estações de acordo com o tipo passado como parâmetro:
    • Tipos:
      • T - Automáticas
      • M - Manuais
    • https://apitempo.inmet.gov.br/estacoes/<tipo>
    • https://apitempo.inmet.gov.br/estacoes/T

  • Recuperar dados horários referentes a todas as estações automáticas de um determinado dia:
    • https://apitempo.inmet.gov.br/estacoes/dados/<data>
    • https://apitempo.inmet.gov.br/estacao/dados/2020-05-02
    • Sendo data no formato AAAA-MM-DD (ex: 2020-05-020)

  • Recuperar dados horários referentes a todas as estações automáticas de um determinado dia e hora:
    • https://apitempo.inmet.gov.br/estacoes/dados/<data>/<hora>
    • https://apitempo.inmet.gov.br/estacao/dados/2020-05-02/0800
    • Sendo data no formato AAAA-MM-DD (ex: 2020-05-02)
    • Sendo hora no formato HH00 hora cheia (ex: 1200), considera horário UTC

    • Recuperar dados horários referentes a estação automática ou manual:
      • https://apitempo.inmet.gov.br/estacao/<data_inicial>/<data_final>/<cod_estacao>
      • https://apitempo.inmet.gov.br/estacao/2019-10-23/2019-10-23/A301
      • Sendo data no formato AAAA-MM-DD (ex: 2019-10-23)

    • Recuperar dados diários referentes a estação automática ou manual:
      • https://apitempo.inmet.gov.br/estacao/diaria/<data_inicial>/<data_final>/<cod_estacao>
      • https://apitempo.inmet.gov.br/estacao/diaria/2019-10-01/2019-10-31/A301
      • Sendo data no formato AAAA-MM-DD (ex: 2019-10-31)

    • Recuperar dados da estação mais próxima ao geocode passado como parâmetro:
      • https://apiprevmet3.inmet.gov.br/estacao/proxima/<geocode>
      • https://apiprevmet3.inmet.gov.br/estacao/proxima/5300108
      • Lista de GEOCODES podem ser recuperados pela API de Previsão do Tempo

    Para as estações meteorológicas, segue a tabela de atributos e unidades do JSON:

    ATRIBUTOS DIARIOS
    CAMPODESCRIÇÃOUNIDADE
    CHUVAPRECIPITAÇÃO TOTAL, DIARIO (AUT)mm
    PRESS_ATM_MEDPRESSAO ATMOSFERICA MEDIA DIARIA (AUT)mB
    TEMP_MAXTEMPERATURA MÁXIMA, DIARIA (AUT)°C
    TEMP_MEDTEMPERATURA MÉDIA, DIÁRIA (AUT)°C
    TEMP_MINTEMPERATURA MÍNIMA, DIARIA (AUT)°C
    UMID_MEDUMIDADE RELATIVA DO AR, MEDIA DIARIA (AUT)%
    UMID_MINUMIDADE RELATIVA DO AR, MINIMA DIARIA (AUT)%
    VEL_VENTO_MEDVENTO, VELOCIDADE MÉDIA DIÁRIA (AUT)m/s

    ATRIBUTOS HORARIOS
    CODIGO ATRIBUTODESCRIÇÃOUNIDADE
    VEN_DIRVENTO, DIREÇÃO HORARIA (gr)° (gr)
    CHUVAPRECIPITAÇÃO TOTAL, HORÁRIOmm
    PRE_INSPRESSÃO ATMOSFÉRICA AO NÍVEL DA ESTACÃO, HORARIAmB
    PRE_MINPRESSÃO ATMOSFÉRICA MIN. NA HORA ANT. (AUT)mB
    UMD_MAXUMIDADE REL. MAX. NA HORA ANT. (AUT)%
    PRE_MAXPRESSÃO ATMOSFÉRICA MAX.NA HORA ANT. (AUT)mB
    VEN_VELVENTO, VELOCIDADE HORARIAm/s
    PTO_MINTEMPERATURA ORVALHO MIN. NA HORA ANT. (AUT)°C
    TEM_MAXTEMPERATURA MÁXIMA NA HORA ANT. (AUT)°C
    RAD_GLORADIAÇÃO GLOBALW/m²
    PTO_INSTEMPERATURA DO PONTO DE ORVALHO°C
    VEN_RAJVENTO, RAJADA MÁXIMAm/s
    TEM_INSTEMPERATURA DO AR - BULBO SECO, HORARIA°C
    UMD_INSUMIDADE RELATIVA DO AR, HORARIA%
    TEM_MINTEMPERATURA MÍNIMA NA HORA ANT. (AUT)°C
    UMD_MINUMIDADE REL. MIN. NA HORA ANT. (AUT)%
    PTO_MAXTEMPERATURA ORVALHO MAX. NA HORA ANT. (AUT)°C