Logo da Defesa Civil RS
Defesa Civil RS Rede Hidrometeorológica
API operacional
Documentação pública · API GraphQL

API de Dados Hidrometeorológicos
do Rio Grande do Sul

Acesse dados de chuva, nível de rios, temperatura, vento, pressão atmosférica, radiação solar, umidade e sensação térmica.
Os dados são coletados pelas estações metereológicas em todo o estado, disponibilizados pela Defesa Civil RS através da MKS.

O que é esta API?

Uma API é como uma "janela de dados" que permite que sistemas de computador consultem informações automaticamente. Pense nela como um balcão de atendimento digital: você faz uma pergunta específica — por exemplo, "qual foi a chuva acumulada na estação X nas últimas 3 horas?" — e o sistema responde com os dados exatos.

Esta API utiliza GraphQL — uma tecnologia que permite pedir exatamente as informações que você precisa, sem dados desnecessários. Você define quais campos quer receber e o servidor retorna somente eles.
Tempo real

Dados atualizados automaticamente conforme as estações transmitem leituras, via Subscription WebSocket.

Histórico

Consulte registros passados com intervalo e período totalmente personalizados.

Múltiplas estações

Filtre por código de estação, permitindo acompanhar várias regiões do estado.

Vários indicadores

Chuva, nível de rio, temperatura, vento, pressão atmosférica, umidade e mais.


Endereço da API

Todas as consultas são enviadas para este único endereço (endpoint):

https://redehidrometeorologica.defesacivil.rs.gov.br/graphql

Fonte dos dados

Origem das informações

Os dados apresentados nesta documentação são retirados da Rede Hidrometeorológica da Defesa Civil RS. Você também pode acessar o mapa oficial pelo link abaixo:

https://redehidrometeorologica.defesacivil.rs.gov.br/Mapa Abrir mapa

Exemplos de consulta

Escolha o tipo de dado que deseja consultar clicando nas abas abaixo:

Busca dados de uma estação específica em um intervalo de tempo.

Ajuste stationCode, startDate, endDate e interval conforme sua necessidade. Veja a tabela de intervalos disponíveis abaixo.
Query · Historic
query Historic {
    historic(
        system: Qualle_Hidrometeorologia
        client: "casa-militar-defesa-civil-rs"
        stationCode: "DCRS-00005"
        startDate: "2026-06-17 12:00:00"
        endDate: "2026-06-17 13:31:00"
        interval: HOUR_1
    )
}
Campo O que significa Exemplo
stationCode Código identificador da estação "DCRS-00005"
startDate Data/hora de início (YYYY-MM-DD HH:MM:SS) "2026-06-17 12:00:00"
endDate Data/hora de término "2026-06-17 13:31:00"
interval Intervalo de agregação dos dados HOUR_1, MIN_15, HOUR_24

Busca dados filtrados por estação e localização geográfica.

Query · Tags_data
query Tags_data {
    tags_data(
        station: ["DCRS-00002"]
        clients: ["casa-militar-defesa-civil-rs"]
        filters: {
            localizacao: [{
                codigos: ["43"]
                tipo: UNIDADE_FEDERATIVA
            }]
        }
    ) {
        qualle_meteorologia {
            codigo
            data {
                chuva {
                    acumulado {
                        h001 { value }
                        min005 { value }
                    }
                }
            }
        }
    }
}

A Subscription é diferente das consultas comuns: ela fica "escutando" a API e atualiza os dados automaticamente toda vez que uma nova leitura chega.

Para usar Subscriptions no Postman, configure a conexão como WebSocket em vez de HTTP padrão.
Subscription · Nowcasting
subscription Nowcasting {
    nowcasting_unique(
        clients: ["casa-militar-defesa-civil-rs"]
    ) {
        qualle_meteorologia {
            codigo
            name { prefix general local }
            timestamp
            position {
                bacia latitude longitude
                regiao altitude
            }
            data {
                rio {
                    rio_nome { value }
                    rio_nivel { value }
                    rio_nivel_tendencia { value }
                    rio_area_drenagem { value }
                }
                chuva {
                    acumulado {
                        s015  { value }
                        h001  { value }
                        h003  { value }
                        h006  { value }
                        h012  { value }
                        h024  { value }
                        h168  { value }
                    }
                }
                temperatura {
                    atual { value }
                    historico {
                        diaatual { media { value } maxima { value } minima { value } }
                        diaanterior { media { value } }
                    }
                }
                umidade { atual { value } }
                pressaoatmos { atual { value } tendencia { value } }
                senstermica { atual { value } }
                radiacaosolar { atual { value } }
                vento {
                    velocidade_media { value }
                    velocidade_maxima { value }
                    direcao { value }
                }
            }
            filter {
                relacao {
                    tem_chuva_acumulada
                    tem_nivel_do_rio
                    tem_pressao_atmosferica
                    tem_umidade
                    tem_vento
                }
            }
        }
    }
}

Métricas e unidades de medida

Use estes nomes de campo ao montar suas consultas para selecionar os dados desejados:

Chuva acumulada (milimetros)
chuva · mm
Nível do rio (metros)
rio · m
Temperatura (°Celsius)
temperatura · °C
Vento (Quilômetro por hora)
vento · km/h
Pressão atmosférica (Hectopascal)
pressaoatmos · hPa
Radiação solar (Quilowatt-hora por metro quadrado)
radiacaosolar · kWh/m²
Umidade relativa (Por cento)
umidade · %
Sensação térmica (°Celsius)
senstermica · °C

Intervalos de tempo disponíveis

Use a coluna Parâmetro dentro de chuva.acumulado. Para consultas históricas, use a coluna Filtro no campo interval.

Parâmetro Filtro Descrição
s015 - 10 segundos
min005 MIN_5 5 minutos
min010 MIN_10 10 minutos
min015 MIN_15 15 minutos
min030 MIN_30 30 minutos
h001 HOUR_1 1 hora (60 minutos)
h1min30 H_1_MIN_30 1 hora e 30 minutos (90 minutos)
h003 HOUR_3 3 horas (180 minutos)
h006 HOUR_6 6 horas (360 minutos)
h012 HOUR_12 12 horas (720 minutos)
h024 HOUR_24 24 horas (1 dia)
h048 HOUR_48 48 horas (2 dias)
h072 HOUR_72 72 horas (3 dias)
h096 HOUR_96 96 horas (4 dias)
h120 HOUR_120 120 horas (5 dias)
h144 HOUR_144 144 horas (6 dias)
h168 HOUR_168 168 horas (7 dias)

Dúvidas frequentes

Os dados são gratuitos?

A API é disponibilizada pela Defesa Civil RS em parceria com a MKS. Consulte as condições de uso com a equipe responsável antes de utilizar os dados em produções públicas ou comerciais.

Com que frequência os dados são atualizados?

Os dados chegam em tempo real conforme cada estação transmite. O menor intervalo de leitura disponível é de 10 segundos (s015), dependendo da estação e do tipo de sensor.