O globo do meu portfólio: todas as fontes de dados em tempo real (e as que não deram certo)

· ArcGIS, Dados Abertos, NASA, APIs, React, 3D

O fundo da home do meu portfólio é um globo 3D que mostra o planeta agora: satélites, a Estação Espacial, terremotos, incêndios, furacões, vento, alertas de emergência e mais. Nada ali é simulado: cada ponto vem de uma fonte pública consultada pelo navegador. Este post detalha cada camada, de onde vem o dado, o que dá para ver, e também as APIs e ideias que não deram certo no caminho, que foram muitas.

TL;DR


1. A base: o globo em si

O globo usa o ArcGIS Maps SDK for JavaScript (SceneView). Ele já resolve câmera, zoom, rotação e relevo, e me deixa focar nas camadas de dados. A base tem quatro peças:

Colorindo as luzes da noite

Os tiles do Black Marble vêm em tons de cinza azulado, e o oceano ficava marrom-escuro com o brilho residual. Criei uma camada própria (BaseTileLayer) que baixa cada tile, passa pixel por pixel num canvas e aplica uma paleta: abaixo de um limiar vira preto puro; acima, uma curva leva o brilho para amarelo e laranja, como lâmpadas de sódio.

const b = d[i] / 255;
if (b < 0.11) {
  d[i] = d[i + 1] = d[i + 2] = 0; // oceano preto
} else {
  const e = Math.pow((b - 0.11) / 0.89, 0.5);
  d[i] = e * 255;                    // vermelho
  d[i + 1] = Math.pow(e, 1.8) * 210; // verde
  d[i + 2] = Math.pow(e, 5.5) * 80;  // azul
}

Antes de chegar nisso, testei duas alternativas no mesmo dia e voltei atrás: uma textura 8K estática das luzes da Terra e a camada oficial Earth at Night do ArcGIS. Nas duas voltei atrás e fiquei com o Black Marble e a paleta ajustada.

Pontos que acompanham o globo

Os ícones não são gráficos do ArcGIS: um <canvas> transparente fica por cima do globo e é redesenhado a cada quadro. Para cada ponto, o código confere se ele está no lado da Terra virado para a câmera (produto escalar entre a posição da câmera e a do ponto) e projeta a coordenada na tela com view.toScreen. Os ícones diminuem quando a câmera se afasta, e as linhas de vento fazem o contrário, engrossando de perto.


2. As camadas ativas

🛰️ Satélites: CelesTrak + SGP4

O CelesTrak publica os elementos orbitais (TLE) de grupos de satélites. Uso três: GPS, Galileo e meteorológicos, cerca de 137 satélites. O navegador calcula a posição de cada um com o modelo SGP4 (biblioteca satellite.js) e recalcula a cada 10 segundos, então você vê os satélites andando.

O CelesTrak pede para não ser consultado mais de uma vez a cada duas horas por grupo, então o TLE fica em cache por 2h. Às vezes ele responde 200 com uma mensagem de texto no lugar do TLE; nesse caso o globo mantém o cache anterior. No hover aparecem o nome e a altitude.

🛰 Estação Espacial Internacional: wheretheiss.at

A ISS tem um anel azul próprio, atualizado a cada 8 segundos pela API pública wheretheiss.at. O hover mostra altitude (cerca de 400 km) e velocidade (cerca de 27.600 km/h).

🌍 Terremotos: USGS

O feed GeoJSON do USGS traz os terremotos de magnitude 4.5 ou mais das últimas 24 horas. Cada um vira um anel pulsante com tamanho e cor pela magnitude (amarelo, laranja, vermelho), com a magnitude escrita ao lado. O hover mostra o local e há quanto tempo aconteceu.

🌋 Vulcões: Smithsonian

São 425 vulcões do catálogo do Smithsonian Global Volcanism Program, num JSON público. Triângulos coloridos pelo tipo (escudo, estratovulcão, caldeira...) e com tamanho pela altitude. Esse dado não é ao vivo: é o catálogo de vulcões, não as erupções do dia.

🔥 Incêndios: NASA VIIRS

Os focos de calor vêm dos satélites VIIRS da NASA, pelo ArcGIS Living Atlas. Sem filtro são mais de 100 mil focos por dia no mundo, impossível de desenhar. Filtro as últimas 6 horas, confiança alta e potência do fogo (FRP) de pelo menos 10 MW, até 500 focos.

hours_old <= 6 AND confidence = 'high' AND frp >= 10

⚠️ Alertas de emergência: CAP

O CAP Alerts Feed do Living Atlas junta avisos oficiais de agências de vários países no formato CAP (Common Alerting Protocol): tempestades, enchentes, calor extremo. A área de cada alerta é um polígono; peço ao serviço o centroide (returnCentroid) e desenho um ⚠️ ali. O hover mostra evento, severidade, área e órgão emissor.

🌀 Furacões, ciclones e tufões

A camada Active Hurricanes do Living Atlas junta o NHC (Atlântico e Pacífico Leste) e o JTWC (demais bacias), então cobre o planeta inteiro. Cada tempestade vira uma espiral colorida pela categoria Saffir-Simpson, com vento em km/h e pressão em mb no hover. Foi a terceira fonte que testei para isso (veja mais abaixo).

💨 Vento: modelo GFS

O vento vem de uma grade do modelo GFS (NOAA) com resolução de 1°: duas matrizes de 360×181 com os componentes leste-oeste e norte-sul do vento na superfície, no mesmo formato usado pelo earth.nullschool. O arquivo fica num repositório público do GitHub atualizado periodicamente.

Em cima dessa grade, 700 partículas andam pelo campo de vento, com a velocidade interpolada entre os pontos da grade, e deixam um rastro que desbota, colorido pela velocidade. É o efeito de "rios de vento" que aparece quando você liga a camada 💨.

🏙️ Cidades, clima e qualidade do ar

Os anéis verdes são polos de tecnologia pelo mundo, de San Francisco a Joanesburgo. Ao passar o mouse, o card busca na hora:

Clicar num pin desenha um arco laranja animado até Vitória-ES, onde moro, seguindo o grande círculo da Terra (interpolação esférica).

📍 Você no mapa

Se você permitir a localização, aparece um pin amarelo onde você está, com o nome da cidade vindo do Nominatim (OpenStreetMap). Se negar, a barra de cima usa a localização aproximada pelo IP (ipapi.co) só para mostrar a temperatura.

A barra de camadas

Cada camada tem um botão ON/OFF na barra do topo. O botão dispara um CustomEvent que o globo escuta, e a escolha fica salva no navegador. Cada fonte tem seu próprio arquivo, usa AbortSignal.timeout e devolve lista vazia se falhar: uma API fora do ar apaga só a sua camada, nunca o globo inteiro.


3. O que não deu certo

Essa é a parte que mais ensina. Cada item abaixo chegou a ter código, e alguns ficaram dias no ar antes de sair.

✈️ Aviões em tempo real (OpenSky)

A ideia era mostrar os aviões no ar pela OpenSky Network. A API funciona, mas não libera CORS para o navegador. Contornar exigiria um proxy no servidor só para isso, e a camada saiu.

🛰️ Starlink

O grupo starlink do CelesTrak tem milhares de satélites e seria lindo no globo, mas passou a responder 403. Ficaram só GPS, Galileo e meteorológicos.

☁️ Nuvens ao vivo (NOAA GOES)

Tentei trocar a textura fixa de nuvens por imagens recentes dos satélites GOES da NOAA. O serviço que eu encontrei pedia autenticação, e o primeiro ID de camada que usei nem existia. Voltei para a textura estática, que continua lá como enfeite, não como dado.

🌊 Correntes marítimas (Open-Meteo Marine)

Cheguei a ter correntes oceânicas reais, tracejadas para diferenciar do vento, vindas do Open-Meteo Marine. Para cobrir o planeta eram muitas consultas, e o limite gratuito de requisições estourava. Aumentar o cache para 24 horas não resolveu, e a camada saiu.

🌀 Furacões: três tentativas

🌌 Aurora boreal

Fiz a aurora com o índice Kp real da NOAA (atividade geomagnética). O problema é que, na maior parte do tempo, o Kp é baixo e não há nada para mostrar. Para demonstrar, cheguei a forçar um Kp alto, mas isso é dado falso e reverti no mesmo dia. Depois decidi tirar a camada do globo.

🧪 Dados de exemplo que viraram dados reais

Nas primeiras versões, qualidade do ar, incêndios, satélites e até raios eram amostras fixas no código. Uma a uma foram trocadas por fonte real (OpenAQ, VIIRS, CelesTrak + SGP4) e os raios simulados saíram do globo. Hoje vale a regra: se não existe dado real, a camada não existe.

🐛 O bug que desligou terremotos e vulcões

Esse foi o mais chato. Em produção, o hover dos terremotos e dos vulcões quebrava com Cannot access X before initialization, e em desenvolvimento funcionava. Passei um dia desligando partes, renomeando propriedades e comentando código, e cheguei a remover as duas camadas.

A causa estava no build: o minificador renomeava variáveis, e nomes curtos colidiam dentro dos event handlers que liam objetos guardados em useRef. A solução foi manter a minificação, mas sem renomear identificadores:

// vite.config.ts
build: { minify: "esbuild" },
esbuild: { minifyIdentifiers: false },

O bundle fica um pouco maior, e terremotos e vulcões voltaram. Detalhe importante para testar: o Chromium headless (usado em testes automatizados) renderiza sem GPU e o ArcGIS não desenha o globo nele, então esse tipo de bug só aparece num navegador de verdade.


Principais lições

  1. CORS decide o que dá para fazer no navegador. Muitas APIs públicas não liberam, e um proxy traz custo e regras de uso. O Living Atlas da Esri, com CORS liberado, virou a fonte de quatro camadas.
  2. Respeite os limites das fontes gratuitas. Cache de 2 horas no CelesTrak e no clima, filtros fortes nos incêndios.
  3. Calcular no cliente economiza API: com SGP4, uma consulta a cada 2 horas move os satélites o tempo todo.
  4. Cada camada falha sozinha. Timeout e lista vazia em cada loader mantêm o globo de pé quando uma fonte cai.
  5. Prefira tirar uma camada a mostrar dado falso. O globo ficou com menos camadas do que planejei, mas tudo o que aparece é real.
  6. Teste o build de produção num navegador com GPU. Minificação pode quebrar o que funciona em desenvolvimento.

Todos os posts