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.
Dados atualizados automaticamente conforme as estações transmitem leituras, via Subscription WebSocket.
Consulte registros passados com intervalo e período totalmente personalizados.
Filtre por código de estação, permitindo acompanhar várias regiões do estado.
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):
Fonte dos dados
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:
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.
stationCode, startDate,
endDate e interval conforme sua
necessidade. Veja a tabela de intervalos disponíveis
abaixo.
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
|
A Subscription é diferente das consultas comuns: ela fica "escutando" a API e atualiza os dados automaticamente toda vez que uma nova leitura chega.
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 · mmrio · mtemperatura · °Cvento · km/hpressaoatmos · hParadiacaosolar · kWh/m²umidade · %senstermica · °CIntervalos 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
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.
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.