bilawalsidhu/gods-eye-viewUm simulador de satélite espião no seu navegador, exceto que os dados são reais. Inteligência espacial de código aberto ao vivo em um globo 3D fotorrealista.
Globo 3D fotorrealista. Aeronaves, navios, satélites, terremotos, trânsito e câmeras públicas ao vivo, com visualizações modeladas claramente rotuladas quando um feed ao vivo não está disponível. Controle de voz mãos-livres alimentado por um agente de IA em tempo real.
Nenhum lugar fica para trás.
▶️ Do projeto por trás da viral série God's Eye View (antigo WorldView) — 5M+ no YouTube
Você pediu, então está acontecendo. God's Eye View é open source. Acompanhe o mundo ao vivo. Fale com ele. Quebre-o. Estenda-o.
A maior parte da inteligência de código aberto é uma pilha de abas do navegador. Os sinais são abundantes, mas a interface é o gargalo. God's Eye View transforma esses sinais em um lugar: o mundo já está transmitindo — transponders de voo, balizas de navios, elementos orbitais, sismógrafos, câmeras públicas — e isso torna tudo visível em uma Terra 3D fotorrealista em tempo real. Nenhuma autorização classificada é necessária; é sinal público até o fim, e a interface roda no seu navegador, sob seu controle.
Metade da mágica é que parece um cockpit proibido. A outra metade é que cada linha de código é inspecionável.
As camadas ao vivo são fundamentadas em feeds públicos: o avião comercial cruzando sua tela está reportando telemetria, a câmera está instalada em um local publicado, e a posição da ISS é propagada a partir de elementos orbitais atuais. O cliente deliberadamente renderiza voos um intervalo de polling atrás do tempo real para poder interpolar suavemente. Algumas experiências são modeladas em vez de ao vivo: trânsito sem chave é rotulado como simulação, poses de câmera são estimadas até serem calibradas, e a reprodução de subida de lançamento é marcada como RECONSTRUCTED ESTIMATE. Cada camada mantém sua fonte e estado de atualização visíveis, incluindo estados parciais, atrasados, simulados e indisponíveis.
Requer Node.js 24.14.x ou 26.x (imposto por package.json).
.env.example → .env e defina GOOGLE_MAPS_API_KEY.3. Abra **`http://localhost:4173`**. O arranque a frio estabiliza-se em menos de dois segundos num portátil recente (mediana de 1,86 s numa captura pontual M5/Chrome — [docs/PERFORMANCE.md](https://github.com/bilawalsidhu/gods-eye-view/blob/main/docs/PERFORMANCE.md); uma linha de base de comparação, não um requisito de hardware). Um cartão de primeira execução oferece-se para preparar uma missão para si — **Live Contacts**, **Space Missions**, **Environmental** — ou deixa-o explorar manualmente.
> [!TIP]
> **Não é programador? Deixe uma IA fazer esta página inteira por si.** Um instalador de um clique está em desenvolvimento — até lá, instale um agente de codificação ([Claude Code](https://claude.com/claude-code), [Codex](https://openai.com/codex/), [Cursor](https://cursor.com) ou [Antigravity](https://antigravity.google)) e cole isto:
>
> ```text
> Clone https://github.com/bilawalsidhu/gods-eye-view and set it up on my machine.
> Install everything it needs, walk me through getting the required Google Maps API
> key step by step (plus any optional free keys I want), put the keys in .env, and
> help me set a billing alert and a usage quota on the Google key so I can't
> overspend. Then start the dev server and open it in my browser. I'm not a
> developer — explain what you're doing as you go, and ask me before any step
> that could cost money.
> ```
**Essa única chave é todo o preço de entrada.** Tudo neste README está codificado por cores — 🟢 não precisa de nada · 🟡 chave gratuita · 🔴 medido — e o Google Maps é o único 🔴 de que precisa: compra o planeta fotorrealista, e a maior parte do globo acende a 🟢 a partir daí. Para exploração individual típica, espere **$0 na maioria das camadas** e trocos nas duas medidas: o Google oferece atualmente **1.000 sessões gratuitas de blocos 3D por mês** — cada uma boa para até três horas de renderização, o que é muito difícil de esgotar para uma pessoa — e a voz tem um limite de sessão integrado de $5. Mapa completo em [Keys & Costs](#-api-keys), análise completa e honesta em [What it actually costs](#-what-it-actually-costs).
O servidor de desenvolvimento liga-se a **localhost** — as suas chaves ficam na sua máquina. Partilhar numa LAN em segurança está coberto em [Sharing an instance](#-sharing-an-instance) e [SECURITY.md](https://github.com/bilawalsidhu/gods-eye-view/blob/main/SECURITY.md).
**Atalho para macOS:** `./scripts/dev-fresh.sh` limpa a cache do Vite e puxa as suas chaves diretamente do Keychain.
---
## 🕐 Os Primeiros Cinco Minutos
Sem conta, sem registo. O cartão de primeira execução oferecer-se-á para preparar uma missão para si — ou percorra este percurso sozinho. Em algum ponto destes cinco minutos deixa de parecer uma demonstração:
1. **Ilumine o céu.** Aceite a missão **Live Contacts** (ou ligue **Flights** você mesmo) — milhares de aeronaves em tempo real, a deslizar com telemetria real, com a malha de deteção já a ler a cena. Clique numa: a câmara trava nela, um rasto desenha-se atrás dela e o seu cartão de telemetria em tempo real aparece.
2. **Assuma os controlos.** Carregue em **COCKPIT** no seu avião rastreado e desça com ele, alternando sensores em pleno voo: NVG para Ironbow FLIR. O cockpit tem a sua própria faixa informativa — sinais em tempo real nas proximidades, manchetes regionais e clima local real, com um modo **WX** opcional que renderiza nuvens volumétricas a partir de observações reais à volta da sua aeronave — e **Contacts** mantém a lista de 250 km a um clique (ou uma frase) de distância: salte de avião em avião e caia diretamente no cockpit seguinte.
3. **Aterrisse num aeroporto movimentado.** Pesquise um e desça até às pistas de táxi com **3D** ligado — contactos em solo, rastos de táxi, todo o pátio a funcionar em tempo real.
4. **Olhe através de uma câmara pública.** Ligue **CCTV** sobre Austin, Londres ou Califórnia. Os feeds não são embebidos de webcam — projetam-se *dentro* da cidade 3D. Alterne a cobertura para **VIEWSHED** e cada câmara desenha o seu volume de cobertura estimado — onde alcança e onde fica cega.
5. **Pinte as ruas com a hora de ponta.** Ligue **Traffic** e desça abaixo de ~8 km — o fluxo por veículo colore-se com os congestionamentos reais (com uma chave TomTom; sem chave é uma simulação rotulada). Depois carregue em **NEAREST** no painel CCTV e veja o congestionamento através da câmara apontada para ele.
6. **Rastreie algo em órbita.** Ligue **Satellites** e clique na ISS — viaja com ela à distância orbital, com anel de órbita e tudo.
7. **Alterne a ótica.** Toque em `1`–`7` — CRT, NVG, FLIR — e todo o planeta em tempo real re-renderiza através de um sensor diferente.
8. **Fale com ele** *(precisa de uma chave OpenAI)*: *"Leva-me a LAX e seleciona a aeronave em voo mais próxima."*
9. **Volte para casa.** Carregue em **Reset Globe** — ou apenas diga *"afasta para uma vista de globo."*
**Teclado:** `1`–`7` estilos visuais · `H` HUD · `D` deteção · `C` cockpit · `Esc` para sair.
---
## 🎙️ Fale com Ele
> A voz precisa de uma **chave OpenAI**. Sem uma, toda a aplicação continua a funcionar — o botão do microfone apenas informa que a voz está indisponível. A mesma chave alimenta o **resumo AI HUD**: uma leitura concisa, de cinco palavras, em estilo de inteligência, da vista atual, que se regenera enquanto se move.
Clique em **GEV MIC**, conceda o microfone e simplesmente fale. Isto é mais do que um controlo remoto por voz:
- **🧠 Sabe o que está a ver.** O agente puxa o contexto da cena em tempo real antes de responder — incluindo coordenadas, nomes de ruas, camadas ativas e escala da vista. Pergunte *"que cidade é esta?"* em pleno voo e ele sabe.
- **🎯 Perguntas sobre entidades.** Clique em qualquer avião, navio ou datacenter e pergunte *"o que é isto?"* Ele responde usando a telemetria em tempo real do objeto.
- **👁️ Fundamentação visual.** Ao nível da rua, lê uma captura de ecrã da viewport para identificar sinalética legível e nomes de edifícios, e é instruído a nunca alucinar rótulos.
- **🎬 Enquadramento cinematográfico.** *"Mostra-me os aviões por cima"* afasta a câmara, inclina-a e enquadra o tráfego em tempo real como um realizador.
- **🔒 Honesto e seguro.** O agente apenas confirma ações que tiveram sucesso. A sua `OPENAI_API_KEY` nunca toca no navegador; o cliente só recebe um token de sessão de curta duração.
Vinte e oito ferramentas, quatro tarefas — os comandos abaixo vêm diretamente da suíte de testes de voz e do manual de ferramentas do produto:
**🎥 Dirija-o** — verbos de câmara de operador de drone:
> 🗣️ *"Leva-me a Tóquio."* · *"Orbita à volta desta área lentamente."* · *"Desenha a rota a pé do Capitólio ao Zilker Park."* → *"Voa a rota que acabámos de desenhar."* · *"Afasta para uma vista de globo."*
**🖊️ Anote-o** — um quadro branco sobre o mundo real:
> 🗣️ *"Contorna o estado do Texas."* · *"Anota o Capitólio do Texas e os seus terrenos"* — ele desenha o **limite envolvente real**, não um círculo. · *"Qual é a distância da Torre Eiffel ao Louvre?"* — aparece uma seta de ligação e ele diz a distância. Tudo persiste até dizer *"limpa o mapa."*
**🔎 Interrogue-o** — consultas de analista contra as camadas em tempo real:
> 🗣️ *"Quantos voos estão sobre o Texas agora?"* · *"Que navios seguem para Oakland?"* · *"Qual é o maior incêndio perto de Los Angeles?"* · *"Está alguma coisa a voar acima de quarenta mil pés?"* · *"Quando passa a ISS a seguir?"*
**🎛️ Opere-o** — toda a consola, sem usar as mãos:
> 🗣️ *"Muda para visão noturna e liga a camada de voos."* · *"Liga os viewsheds das câmaras."* · *"Toca uma estação de rádio de notícias perto de Austin."* · *"Rastreia aquele avião."* → *"Entra no Cockpit."*
**E o nível de disparo rápido** — uma frase cada:
> 🗣️ *"Mostra-me a infraestrutura global."* (prepara as camadas e afasta para o globo) · *"Reproduz Orbital Watch."* (uma cena cinematográfica completa) · *"Define a densidade de deteção para cinquenta por cento."* · *"Próximo contacto — apenas helicópteros."* (em pleno cockpit) · *"Mostra-me as missões espaciais."* · *"Muda para Bing aerial."* · *"Aguça a imagem um pouco."* · *"Muda para o layout tático."* · *"O que está ligado agora?"*
*Peça rádio perto de qualquer lugar e o globo começa a transmitir — cada estação é um lugar real para onde pode voar.*
---
## 🛰️ O Que Está no Globo
Treze camadas em tempo real. **Dez delas não precisam de nada** — sem chave, sem conta, sem registo.
| Camada | O que obtém | Fonte | Auth |
|-------|--------------|--------|------|
| 🗺️ **Map Stack** | Google Photorealistic 3D, Bing aerial, OSM | Google / Ion / OSM | 🔴 Google (obrigatório) · 🟡 ion para Bing · 🟢 OSM |
| ✈️ **Live Flights** | Milhares de aeronaves em tempo real + histórico de rotas | OpenSky + adsb.lol | 🟢 (🟡 opcional para mais créditos de polling) |
| 🎖️ **Military Flights** | Tráfego militar ADS-B em âmbar | adsb.lol | 🟢 |
| 🚢 **Live Vessels** | Milhares de navios em todo o mundo | AISStream | 🟡 |
| 🛰️ **Satellites** | Um catálogo central de cerca de 840 objetos, codificado por cores por classe com uma legenda em tempo real — o chip **DENSE** adiciona toda a constelação Starlink | CelesTrak | 🟢 |
| 🌍 **Earthquakes** | Atividade sísmica global, últimas 24h | USGS | 🟢 |
| 🚗 **Traffic** | Congestionamento em tempo real a conduzir o fluxo por veículo ao nível da rua — desça abaixo de ~8 km e os pontos colorem-se com os congestionamentos reais. Sem chave é uma simulação aproximada | TomTom + OSM | 🟢 (🟡 TomTom torna-o real — obtenha uma) |
| 📹 **CCTV Mesh** | ~800 câmaras públicas projetadas *dentro* do espaço 3D — Austin · Califórnia (Caltrans) · Londres (TfL). As posições são publicadas; as poses são priors estimados **que calibra ao arrastar um gizmo na própria câmara** | APIs municipais | 🟢 |
| 📻 **Radio** | Rádio mundial geolocalizado com um **sintonizador analógico** — arraste a agulha por até 750 estações e o globo voa para cada emissora | Radio Browser / emissoras | 🟢 |
| 🚲 **Bikeshare** | Disponibilidade de estações em tempo real | GBFS | 🟢 |
| 🔥 **Active Fires** | Deteções FIRMS da NASA em tempo real, últimas 24h | NASA FIRMS | 🟡 |
| 🚀 **Space Missions** | Lançamentos contínuos de 30 dias com detalhe de carga útil, estágio e recuperação | Launch Library 2 | 🟢 (🟡 token opcional aumenta o limite) |
| 🎖️ **Mapped Installations** | Contexto de locais militares limitado à viewport a partir de mapeamento comunitário — incompleto por natureza, e rotulado dessa forma | OpenStreetMap | 🟢 |
**Também no globo:** sobreposições de bairros · um efeito de nuvens WX opcional no cockpit. **Infraestrutura estática incluída:** Datacenters (4.351), Barragens (704) e Cabos Submarinos (712).
**Falta uma camada que deseja?** Abra uma issue — ou adicione-a e envie o PR.
---
## 🎖️ Missões de Campo
Quando o básico fizer clique, execute estas:
| Missão | Como |
|---|---|
| **🚁 Pergunte ao planeta** | *"Porque estão todos estes helicópteros militares a voar em círculos?"* Selecione um rasto militar — ele preenche silenciosamente ~24 h de histórico de rasto real — e veja o que tem estado a fazer, resolvido como loops 3D empilhados. |
| **✈️ Aproximação final** | Clique e rastreie um avião de linha a alinhar para uma pista, salte para o **cockpit** e desça com ele. |
| **🌃 Vigília noturna** | Voe para a sua própria cidade, mude para **NVG** e deixe a malha de deteção e o HUD lerem a cena. |
| **🚢 Chamada de porto** | Navios sobre o Porto de Long Beach. Clique num petroleiro para o seu cartão tático e rasto de esteira — depois carregue em **NEAREST** no painel CCTV e olhe para a mesma água através de uma câmara pública. |
| **📻 Tokyo FM** | Orbite Shibuya com a camada **Radio** ligada — depois arraste a agulha do sintonizador analógico: cada posição encaixa numa estação real e o globo voa para quem estiver a transmitir. |
| **🔥 Linha de fogo** | FIRMS sobre a Califórnia. Clique numa deteção — a câmara mergulha até ela — leia a intensidade, depois carregue em **NEAREST** no painel CCTV para uma vista de solo. |
| **🚶 Peça uma rota a pé** *🎙️* | Diga ao mundo para onde quer ir e veja uma rota real que segue ruas a traçar-se pela cidade 3D — depois *"voe-a"*: curvas inclinadas, fins suavizados, uma câmara que lidera o caminho como um plano de drone. |
| **📏 Meça LAX a DFW** *🎙️* | *"Qual é a distância de LAX a DFW?"* — uma seta atravessa o país, a distância aparece na legenda e os pontos finais permanecem fixados no mundo real enquanto orbita. |
| **🚀 Repetição de lançamento** | Abra **Space Missions**, escolha um lançamento dos últimos 30 dias e acompanhe a contagem decrescente T-minus pela subida até à órbita — avance e recue a 0,25×–4×. Rotulado `RECONSTRUCTED ESTIMATE`, porque é exatamente isso. |
| **🪦 Caminhe pelo cemitério** | Voe do contexto regional para baixo, para filas densas e totalmente resolvidas de aeronaves retiradas. |
| **🏗️ Orbite Three Gorges** | Percorra a barragem e o seu terreno num relance — depois ligue a camada **Dams** e encontre mais 703. |
| **🌊 Trace a espinha dorsal** | Mergulhe nas Bahamas com **Submarine Cables** ligado — rotas rotuladas revelam-se sob a água, 712 delas em todo o mundo. |
*🎙️ = missões de voz — precisam de uma chave OpenAI.*
*Pergunte ao planeta: as últimas ~24 horas de histórico de rasto real de um contacto militar, resolvidas como loops 3D empilhados.*
*"Desenha a rota a pé… agora voa-a" — curvas inclinadas, fins suavizados, a câmara a liderar o caminho como um plano de drone.*
*Caminhe pelo cemitério: filas de fuselagens retiradas, totalmente resolvidas em 3D.*
*Repetição de lançamento: uma subida de Falcon 9, rotulada `RECONSTRUCTED ESTIMATE`, com avanço e recuo a 0,25×–4×.*
*Trace a espinha dorsal: as rotas de cabos submarinos sob as Bahamas.*
---
## 🔧 Sob o Capô
Parte da engenharia que o faz parecer real em vez de uma demonstração tecnológica:
- **Ícones estáveis no mundo.** Aeronaves e navios apontam ao longo do seu *rumo real verdadeiro* em cada ângulo de câmara — rastreados ou não, olhando diretamente para baixo ou através do horizonte — via projeção de curso em espaço de ecrã por fotograma. Sem rotações, sem bloqueio à viewport.
- **Movimento suave a partir de dados irregulares.** Os feeds em tempo real chegam a cada 15–30s; o globo renderiza um intervalo atrás do tempo real e interpola entre correções conhecidas. Navegação por estimativa preenche as lacunas.
- **Satélites honestos.** Propagação SGP4 com anéis de órbita que permanecem bloqueados aos seus satélites via realinhamento GMST — sem deriva, sem cintilação por segundo.
- **Assenta no solo real.** As alturas das entidades passam por um datum vertical real — ciente do geoide, amostrado contra a *malha de terreno renderizada* — para que as aeronaves estacionem nos pátios e as câmaras fiquem nos cantos das ruas em vez de flutuarem.
- **Gasta a sua quota como se fosse sua.** Os feeds pagos funcionam atrás de proxies em cache com orçamento governado — um governador de créditos OpenSky, um orçamento diário de blocos TomTom, TLEs em cache em disco — para que uma tarde de exploração não devaste um limite de API.
- **Tratamento de chaves local-first.** Fornecedores com segredos, como OpenAI, AISStream, OAuth OpenSky, TomTom e FIRMS, são intermediados no servidor. Os destinos dos proxies são fixos ou na allowlist, e os caminhos de maior risco adicionam pedidos limitados, timeouts, limites de resposta e erros sanitizados conforme apropriado. As únicas credenciais de fornecedor intencionalmente expostas ao navegador são Google Maps e Cesium ion; restrinja ambas no fornecedor.
- **Sem framework.** JavaScript vanilla, **CesiumJS** e **Vite** — além de **Google Photorealistic 3D Tiles** para o planeta e da **OpenAI Realtime API** para voz. Rápido de ler, rápido de hackear.```
src/
├── main.js # Bootstrap: Google 3D tiles, layer registration
├── ui.js # Runtime UI — panels, HUD, styles, control facade
├── hud.js # Intelligence HUD + AI scene summary
├── mapStackController.js # Google 3D / Bing / OSM switching
├── iconOrientation.js # Screen-projected world-space headings + horizon cull
├── voice/ # OpenAI Realtime session + 28 voice tools
├── data/ # One module per layer + management + context store
│ └── local_data/ # Bundled datasets (per-folder provenance)
└── scenes/ # Cinematic scene director
Vê docs/CURRENT-STATE.md para a referência de runtime autoritativa.
A legenda, mais uma vez: 🟢 sem registo — funciona de imediato · 🟡 chave gratuita — regista-te, cola, pronto · 🔴 medida — uma conta com faturação ativada; os custos são pequenos mas reais.
A maior parte do globo é 🟢: voos (anónimos), tráfego militar, satélites, terramotos, CCTV, rádio, bikeshare, missões espaciais, instalações mapeadas e todos os conjuntos de dados incluídos funcionam com zero chaves.
Cinco chaves cobrem a experiência totalmente equipada. Três oferecem atualmente acesso de programador sem custos; Google Maps e OpenAI são medidas por utilização. Os preços e limites dos fornecedores mudam, por isso usa as páginas de preços ligadas antes de confiares numa estimativa de orçamento:
| Chave | Porquê | Onde obter | |
|---|---|---|---|
| 🔴 | Google Maps (obrigatória) | O planeta 3D fotorrealista (Map Tiles API) | Google Cloud Console — medida; verifica os preços atuais e restringe-a por URL |
| 🔴 | OpenAI | 🎙️ A experiência de voz + resumo do HUD com IA. Queres outro fornecedor por trás do microfone? PRs são bem-vindos | platform.openai.com — medida; verifica os preços atuais da API |
| 🟡 | AISStream | 🚢 Navios globais em tempo real | aisstream.io — gratuita, a sério, é um registo de dois minutos |
| 🟡 | NASA FIRMS | 🔥 Incêndios ativos em tempo real | firms.modaps.eosdis.nasa.gov — gratuita |
| 🟡 | TomTom | 🚦 Tráfego real em vez de uma simulação aproximada | developer.tomtom.com — verifica o limite de programador atual para a tua conta |
O que a chave TomTom te dá: o passo 5 de Os Primeiros Cinco Minutos a sério — densidade real de hora de ponta pintada na cidade em vez de uma simulação aproximada.
| Chave | Porquê | Onde obter | |
|---|---|---|---|
| 🟡 | Cesium ion | 🗺️ Pilhas de mapas de imagens Bing (token público assets:read) | cesium.com/ion — verifica o plano que se adequa ao teu uso |
| 🟡 | OpenSky | ✈️ Mais créditos de consulta de voos (🟢 o anónimo funciona sem eles) | opensky-network.org |
| 🟡 | Launch Library 2 | 🚀 Limite de pedidos mais alto para missões espaciais (🟢 funciona sem ele) | thespacedevs.com |
Vale a pena obter todas. Nenhuma é obrigatória para começar.```bash
OPENAI_API_KEY="…" AISSTREAM_API_KEY="…" npm run dev -- --host localhost --port 4173
On macOS, também pode guardar qualquer chave no Keychain e o `./scripts/dev-fresh.sh` vai buscá-las — os nomes de serviço do `security add-generic-password` estão documentados no `.env.example`.
O OpenSky pode funcionar totalmente anónimo (`OPENSKY_AUTH_MODE=anon`), ou importar credenciais OAuth com `./scripts/opensky-import-client.sh /path/to/credentials.json`.
### 💸 Quanto custa, na prática
Números honestos, aproximadamente, a partir de meados de 2026 — verifique sempre as páginas de preços dos fornecedores:
| | Realidade de custos |
|---|---|
| **🟢 A maioria das camadas** | **$0, sem registo.** OpenSky anon, USGS, CelesTrak, adsb.lol, CCTV urbano, Radio Browser, GBFS, Launch Library 2, conjuntos de dados incluídos. |
| **🟡 Acesso opcional para developers** | AISStream, FIRMS, TomTom, Cesium ion e OpenSky autenticado podem oferecer acesso gratuito, mas os limites e usos permitidos diferem. O Cesium ion e o OpenSky, em particular, têm restrições de plano ou de utilização; verifique os termos atuais do fornecedor para a sua implementação. |
| **🔴 Google 3D tiles** | Mais generoso do que imagina: a faturação conta **pedidos de tileset raiz** — um pedido compra até **três horas** de renderização ilimitada de tiles — e os primeiros **1.000 por mês são gratuitos**, depois cerca de **$6 por 1.000** (preços nos EUA; [consulte a página atual](https://developers.google.com/maps/billing-and-pricing/pricing), os valores variam por região de faturação). Um utilizador individual raramente sai do nível gratuito. Ainda assim: restrinja a chave, defina quotas e configure um alerta de orçamento antes de uso prolongado. |
| **🔴 OpenAI voice** | O áudio em tempo real é medido por utilização e o total depende do modelo selecionado, da duração da conversa e do volume de áudio. A aplicação mostra uma estimativa de sessão em direto, avisa aos $2 e aplica um **limite de sessão de $5 dentro da app**; os limites de utilização do lado do fornecedor continuam a ser a salvaguarda de faturação. |
### 🧗 O piso é baixo de propósito
Tudo o que está acima é a base deliberadamente barata — suficiente para ter um gosto real de inteligência geoespacial, GEOINT e OSINT sem nunca falar com uma equipa de vendas. Também notará o teto: o AIS terrestre fica silencioso em pleno oceano e o AIS por satélite custa dinheiro real; imagens premium, SAR e os feeds comerciais mais profundos vivem atrás de contratos empresariais. Isso não é um limite da arquitetura — cada camada aqui é um padrão que pode apontar para as suas próprias fontes de dados. Este repositório entrega-lhe a fundação; o que fundir nela depende de si.
### 🔒 Partilhar uma instância
Por predefinição, mais ninguém consegue alcançar o seu servidor — ele está ligado ao localhost. Para partilhar na sua LAN, opte explicitamente (`npm run dev -- --host 0.0.0.0 --port 4173`, ou `HOST=0.0.0.0 ./scripts/dev-fresh.sh` em macOS/Linux) — mas saiba que ⚠️ **um servidor visível na LAN disponibiliza as suas chaves de API configuradas a qualquer pessoa que o alcance.** Defina os limites por IP (`GEV_RATELIMIT_OPENAI_PER_MIN`, `GEV_RATELIMIT_GOOGLE_PER_MIN` — veja o `.env.example`) e, antes de tudo o resto, **defina limites de orçamento do lado do fornecedor** (orçamentos do Google Cloud, limites de utilização da OpenAI): os limites são proteções ao nível da aplicação, não tetos de faturação. Modelo de ameaça completo em [SECURITY.md](https://github.com/bilawalsidhu/gods-eye-view/blob/main/SECURITY.md).
---
## 📋 Responsável & Aberto
O God's Eye View funciona com **dados públicos, fontes claras e execução local-first.** Sem segredos, sem conjuntos de dados privados, sem scraping misterioso — tudo o que envolve uma chave privada é intermediado no servidor. Tem a gramática visual de uma sala de operações classificada, construída inteiramente a partir de sinais abertos e código inspecionável.
**A linha.** Este projeto modela **eventos, ativos, infraestrutura e sistemas** — aeronaves, embarcações, satélites, incêndios, câmaras, cidades. Não cria funcionalidades para pesquisa de pessoas nomeadas, reconhecimento facial ou rastreio de indivíduos, e pull requests que cruzem essa linha não serão fundidos. Pessoas não são um tipo de consulta aqui.
**Venha construí-lo.** Este é o cliente 3D em direto canónico do projeto que deu início à recente vaga de ferramentas de inteligência espacial — e é uma tela: as camadas aqui são os sinais que uma pessoa poderia encontrar e fundir. Adicione um pacote de cidade, uma fonte de dados, um estilo, uma ferramenta de voz. É a janela através da qual vê o mundo; leve essa janela a outros.
**Estado:** Um cliente open-source em evolução para exploração e aprendizagem — uma fundação rápida e hackeável, não um serviço de produção endurecido. Publicado sob a **[Licença MIT](https://github.com/bilawalsidhu/gods-eye-view/blob/main/LICENSE)**. Os conjuntos de dados incluídos e em direto têm os seus próprios termos — veja **[DATA_SOURCES.md](https://github.com/bilawalsidhu/gods-eye-view/blob/main/DATA_SOURCES.md)**. Modelo de segurança: **[SECURITY.md](https://github.com/bilawalsidhu/gods-eye-view/blob/main/SECURITY.md)**. Quer contribuir? **[CONTRIBUTING.md](https://github.com/bilawalsidhu/gods-eye-view/blob/main/CONTRIBUTING.md)**.
<sub>Nota de media: Bilawal Sidhu criou e é dono dos 17 GIFs de captura nesta página. Ele também publicou os dois PNGs do README no projeto público existente e autorizou a sua inclusão continuada aqui. Qualquer aparição de Bilawal é incluída com a sua permissão. Estes ficheiros são documentação do projeto, não ativos autónomos sob licença MIT. Interfaces de plataformas, marcas comerciais, avatares, dados e imagens de terceiros visíveis neles permanecem sujeitos aos termos dos seus respetivos proprietários. Veja [proveniência de media](https://github.com/bilawalsidhu/gods-eye-view/blob/main/docs/media/README.md) e [termos das fontes](https://github.com/bilawalsidhu/gods-eye-view/blob/main/DATA_SOURCES.md).</sub>
> [!IMPORTANT]
> O God's Eye View é uma visualização exploratória de dados públicos e de terceiros.
> Os dados podem estar atrasados, incompletos, modelados, inferidos ou errados. Não os utilize
> para navegação aérea ou marítima, resposta a emergências, decisões médicas ou de saúde,
> decisões de investimento ou outros fins críticos de segurança ou operacionais.
> Verifique informações importantes com fontes autorizadas.
---
## 🧭 O Que Vem a Seguir
Primeiro — obrigado. A todos os que viram as demonstrações da vista God e foram construir as suas próprias, e a todos os que continuaram a pedir o código: estou grato. E quando perguntei se isto devia ser open source, vocês não foram subtis:
<img src="https://assets.kitploit.com/production/public/readmes/53672/d1eee944eaf04d9063d0251d21e1c8eb3b30471dc576044bab58917e35995924/aab0b9bd11b208c5db0f4e7b6c717c6c688fe22ca0c7996169f17b4a5c526b24-display-v1.webp" alt="Inquérito à comunidade sobre tornar o God's Eye View open source" width="460">
Então aqui está. Entre no cockpit de thriller de espionagem — exceto que os dados são reais — e vamos transformar isto na nossa sandbox partilhada para dar sentido ao mundo, e divertirmo-nos a fazê-lo. Este repositório é a base, permanece aberto, e o objetivo é precisamente partirem coisas e acrescentarem camadas que ainda não imaginámos.
Um aviso de quem está por dentro: construa neste espaço durante uma semana e aprende que **o presente é a parte barata**. No momento em que tenta recuar no tempo — dividir em tiles, servir e percorrer *o que aconteceu* e *o que mudou* a qualquer resolução real — os dados ficam caros e o processamento torna-se brutal. Para isso, estamos a construir algo fantástico. Mais no futuro — [halfpixel.ai](https://halfpixel.ai).
---
<div align="center">
▶️ [Veja a série God's Eye View](https://youtube.com/playlist?list=PL6qSg2I-7_koPbDnSMo0QeeHX_RknA2uv&si=nBGYMoHWQw41v93Q) · 📬 [Map the World](https://maptheworld.ai/) — a newsletter por trás do projeto
**🌐 God's Eye View. Nenhum lugar fica para trás.**
</div>