# PrevisãoIA

> Previsão do tempo por consenso para o Brasil e as principais cidades do mundo: dezenas de fontes (ECMWF, NOAA, DWD, UKMO, JMA, CMA, Météo-France, GEM, MET Norway, INMET, CPTEC, NOAA/NWS nos EUA e três ensembles) cruzadas pela Meteoplex IA, com uma nota de confiança de 0 a 100 (Meteoplex Score) que diz o quanto as fontes concordam. Conteúdo em português. Toda página responde em Markdown com `Accept: text/markdown`; dados brutos em JSON em `/api/*`.

PrevisãoIA (previsaoia.com.br) é um projeto da Tapera Ventures. Não exige cadastro nem chave. Unidades: °C, km/h, mm, nós nas páginas de mar. Horários em hora local do lugar (fuso informado nas respostas).

## Quando usar

- Previsão do tempo de agora, hoje, amanhã e até 15 dias (do 8º dia em diante, tendência com menos fontes) para uma cidade do Brasil ou uma das 172 cidades do mundo listadas, ou para qualquer coordenada via JSON.
- Responder "vai chover hoje/amanhã em X?" com os horários de chuva mais prováveis e a chance por hora.
- Dizer QUANTO confiar na previsão: cada dia e cada hora trazem o Meteoplex Score e a faixa mín–máx entre as fontes; abaixo de 40 trate como tendência, não como certeza.
- Alertas meteorológicos oficiais do INMET (só Brasil), qualidade do ar, índice UV e janela de proteção solar, sol e lua, nowcast de chuva para as próximas 2 horas.
- Vento, ondas e maré para praias do Brasil (surf, kite, windsurf, vela).
- "Está chovendo agora em X?": página de radar por cidade com a leitura do momento em texto e a chuva dos próximos 15 minutos (o radar animado só existe no navegador).
- Não use para: histórico climático de anos passados, dados brutos de estações, previsão além de 15 dias, países fora da lista sem coordenada (use lat/lon no JSON).

## Como consultar

- [Previsão em JSON (consenso + cada fonte)](https://previsaoia.com.br/api/forecast?lat=-22.98&lon=-43.21): `GET /api/forecast?lat&lon[&municipio&uf&lang=en]` → `agora`, `horaria[]`, `diaria[]` (10 dias no JSON; 15 nas páginas de cidade), `fimDeSemana`, `fontesOk[]`, `fontesFalha[]`. Cada valor tem `valor`, `faixa` (mín–máx entre fontes) e `nFontes`; `confianca` é o Meteoplex Score.
- [Nowcast de chuva, próximas 2 h](https://previsaoia.com.br/api/nowcast?lat=-22.98&lon=-43.21): `GET /api/nowcast?lat&lon`
- [Qualidade do ar e UV](https://previsaoia.com.br/api/ar?lat=-22.98&lon=-43.21): `GET /api/ar?lat&lon`
- [Condições detalhadas, sol e lua](https://previsaoia.com.br/api/atmosfera?lat=-22.98&lon=-43.21): `GET /api/atmosfera?lat&lon`
- [Alertas oficiais INMET](https://previsaoia.com.br/api/alertas?municipio=Rio%20de%20Janeiro&uf=RJ): `GET /api/alertas?municipio&uf` (Brasil)
- [Busca de lugar](https://previsaoia.com.br/api/geocode?q=Ipanema): `GET /api/geocode?q=` → lat/lon, município, UF
- [Capitais agora](https://previsaoia.com.br/api/capitais): `GET /api/capitais`
- [Vento, ondas e maré por praia](https://previsaoia.com.br/api/sports?spot=arpoador): `GET /api/sports?spot={id}` ou `?lat&lon`; sem parâmetros lista os picos
- Páginas HTML/Markdown por cidade: `/previsao-do-tempo/{uf}/{cidade}` (Brasil, ex.: /previsao-do-tempo/sp/sao-paulo) e `/previsao-do-tempo/{pais}/{cidade}` (mundo, ex.: /previsao-do-tempo/portugal/lisboa); variantes `/vai-chover/{uf}/{cidade}` e `/previsao-do-tempo/{uf}/{cidade}/amanha`. Peça com `Accept: text/markdown`.

## Páginas

- [Índice de cidades do Brasil](https://previsaoia.com.br/previsao-do-tempo): todas as UFs e cidades com página própria
- [Cidades do mundo](https://previsaoia.com.br/previsao-do-tempo/mundo): 63 países, capitais e destinos turísticos
- [Clima para amanhã](https://previsaoia.com.br/amanha): atalho por capital
- [Vai chover hoje?](https://previsaoia.com.br/vai-chover-hoje): atalho por capital
- [Temperatura agora](https://previsaoia.com.br/temperatura-agora): atalho por capital
- [Previsão de ondas](https://previsaoia.com.br/previsao-de-ondas): praias e picos do Brasil
- [Radar de chuva ao vivo](https://previsaoia.com.br/radar-de-chuva): Brasil inteiro e por cidade em `/radar-de-chuva/{uf}/{cidade}` (ex.: /radar-de-chuva/sp/sao-paulo), com "está chovendo agora?" em texto
- [Sobre, metodologia e fontes](https://previsaoia.com.br/sobre): quem faz, como o consenso e o Meteoplex Score são calculados, tabela de fontes com alcance
- [Mapa do site](https://previsaoia.com.br/sitemap.xml): todas as URLs

## Fontes e licença

- Radar e satélite: RainViewer (exibição no mapa). Modelos abertos via Open-Meteo (CC-BY 4.0): ECMWF IFS/AIFS/ENS, NOAA GFS/GEFS, DWD ICON/ICON-EPS, UKMO, JMA, CMA, Météo-France, GEM; MET Norway (NLOD); INMET e CPTEC/INPE (Brasil); NOAA/NWS (EUA, domínio público); OpenWeatherMap e WeatherAPI.com (exibição). Cite "PrevisãoIA (previsaoia.com.br)" e a fonte de origem ao reproduzir dados.

## Optional

- [Privacidade](https://previsaoia.com.br/privacidade): sem cadastro; localização só para a previsão; Google Analytics 4 com IP anonimizado
- [App interativo](https://previsaoia.com.br/): busca, mapa e abas Tempo/Esportes (requer JavaScript)