bilawalsidhu/gods-eye-view브라우저에서 실행되는 스파이 위성 시뮬레이터, 단 데이터는 실제입니다. 사실적인 3D 지구본에서 실시간 오픈소스 공간 정보를 제공합니다.
포토리얼리스틱 3D 지구본. 실시간 항공기, 선박, 위성, 지진, 교통, 공공 카메라가 표시되며, 실시간 영상이 없는 곳은 명확히 라벨이 붙은 모델링 뷰로 제공됩니다. 실시간 AI 에이전트가 지원하는 핸즈프리 음성 제어.
남겨진 곳이 없습니다.
▶️ 바이럴 영상 시리즈 God's Eye View를 만든 프로젝트에서 (구 WorldView) — YouTube 500만+ 조회수
여러분이 요청했기에, 이제 현실이 됩니다. God's Eye View는 오픈 소스입니다. 세계를 실시간으로 추적하세요. 말을 걸어보세요. 부숴보세요. 확장해보세요.
대부분의 오픈소스 인텔리전스는 브라우저 탭 더미에 불과합니다. 신호는 풍부하지만, 인터페이스가 병목입니다. God's Eye View는 그 신호들을 하나의 장소로 바꿉니다. 세계는 이미 방송 중입니다 — 항공기 트랜스폰더, 선박 비콘, 궤도 요소, 지진계, 공공 카메라 — 그리고 이것은 포토리얼리스틱 3D 지구 위에서 실시간으로 보이게 됩니다. 기밀 허가가 필요 없습니다. 끝까지 공개 신호일 뿐이며, 인터페이스는 브라우저에서 실행되어 여러분의 통제 아래 있습니다.
마법의 절반은 금지된 조종석처럼 보인다는 점입니다. 나머지 절반은 모든 코드 줄을 검사할 수 있다는 점입니다.
실시간 레이어는 공개 피드에 기반합니다. 화면을 가로지르는 여객기는 원격 측정을 보고하고 있고, 카메라는 공개된 위치에 설치되어 있으며, ISS 위치는 최신 궤도 요소에서 계산됩니다. 클라이언트는 의도적으로 항공기를 실시간보다 한 폴링 간격 뒤처지게 렌더링하여 부드럽게 보간할 수 있게 합니다. 일부 경험은 실시간이 아닌 모델링으로 제공됩니다. 키 없는 교통은 시뮬레이션으로 표시되고, 카메라 포즈는 보정될 때까지 추정되며, 발사 상승 재생은 RECONSTRUCTED ESTIMATE로 표시됩니다. 각 레이어는 부분, 지연, 시뮬레이션, 사용 불가 상태를 포함한 소스와 최신 상태를 계속 표시합니다.
Node.js 24.14.x 또는 26.x 필요 (package.json에서 강제).
.env.example → .env 복사 후 GOOGLE_MAPS_API_KEY 설정.3. **`http://localhost:4173`**을 엽니다. 최근 노트북에서 콜드 스타트는 2초 이내에 완료됩니다(특정 시점의 M5/Chrome 캡처 기준 중앙값 1.86초 — [docs/PERFORMANCE.md](https://github.com/bilawalsidhu/gods-eye-view/blob/main/docs/PERFORMANCE.md) 참조; 하드웨어 요구 사항이 아닌 비교 기준입니다). 첫 실행 카드에서 미션을 구성할 수 있습니다 — **Live Contacts**, **Space Missions**, **Environmental** — 또는 직접 탐색할 수도 있습니다.
> [!TIP]
> **코더가 아니신가요? AI에게 이 페이지 전체를 맡기세요.** 원클릭 설치 프로그램이 준비 중입니다 — 그때까지 코딩 에이전트([Claude Code](https://claude.com/claude-code), [Codex](https://openai.com/codex/), [Cursor](https://cursor.com), 또는 [Antigravity](https://antigravity.google))를 설치하고 다음을 붙여넣으세요:
>
> ```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.
> ```
**그 키 하나가 전체 입장료입니다.** 이 README의 모든 항목은 색상으로 구분되어 있습니다 — 🟢 필요 없음 · 🟡 무료 키 · 🔴 과금 — 그리고 Google Maps가 필요한 유일한 🔴입니다: 사실적인 3D 행성을 제공하며, 그 이후로 지구 대부분이 🟢로 켜집니다. 일반적인 개인 탐색의 경우 **대부분의 레이어에서 $0**, 과금되는 두 항목에서는 소액만 발생합니다: Google은 현재 **월 1,000회 무료 3D 타일 세션**을 제공하며 — 각 세션은 최대 3시간의 렌더링에 사용 가능해 한 사람이 모두 소진하기 매우 어렵습니다 — 음성에는 기본 제공 $5 세션 상한이 있습니다. 전체 지도는 [Keys & Costs](#-api-keys), 솔직한 전체 분석은 [What it actually costs](#-what-it-actually-costs)에서 확인하세요.
개발 서버는 **localhost**에 바인딩됩니다 — 키는 사용자 머신에만 유지됩니다. LAN에서 안전하게 공유하는 방법은 [Sharing an instance](#-sharing-an-instance)와 [SECURITY.md](https://github.com/bilawalsidhu/gods-eye-view/blob/main/SECURITY.md)에 설명되어 있습니다.
**macOS 단축키:** `./scripts/dev-fresh.sh`는 Vite 캐시를 지우고 Keychain에서 키를 직접 가져옵니다.
---
## 🕐 처음 5분
계정도, 가입도 없습니다. 첫 실행 카드에서 미션 구성을 제안하거나 — 직접 이 과정을 진행할 수 있습니다. 이 5분 중 어느 순간 데모가 아닌 실제 도구처럼 느껴지기 시작합니다:
1. **하늘을 밝히세요.** **Live Contacts** 미션을 선택하거나(또는 직접 **Flights**를 켜고) — 수천 대의 실시간 항공기가 실제 텔레메트리로 활공하고, 탐지 메시가 이미 장면을 읽고 있습니다. 하나를 클릭하면: 카메라가 고정되고, 뒤에 항적이 그려지며, 실시간 텔레메트리 카드가 표시됩니다.
2. **조종을 시작하세요.** 추적 중인 비행기에서 **COCKPIT**을 누르고 비행을 따라가며, 비행 중 센서를 전환하세요: NVG에서 Ironbow FLIR로. 조종석에는 자체 브리핑 스트립이 있습니다 — 주변 실시간 신호, 지역 헤드라인, 실제 지역 날씨, 그리고 항공기 주변의 실제 관측 데이터로 체적 구름을 렌더링하는 옵트인 **WX** 모드 — **Contacts**는 250km 명단을 한 번의 클릭(또는 한 문장)으로 유지합니다: 비행기에서 비행기로 점프해 다음 조종석으로 바로 들어가세요.
3. **혼잡한 공항으로 내려가세요.** 공항을 검색하고 **3D** 항공기를 켠 상태로 유도로까지 하강하세요 — 지상 접촉 항공기, 유도로 항적, 실시간으로 작동하는 전체 계류장.
4. **공공 카메라를 통해 보세요.** Austin, London 또는 California에서 **CCTV**를 켜세요. 피드는 웹캠 임베드가 아닙니다 — 3D 도시 *안에* 투사됩니다. 커버리지를 **VIEWSHED**로 전환하면 각 카메라가 추정 커버리지 볼륨을 그립니다 — 어디까지 도달하고, 어디가 사각지대인지.
5. **러시아워로 거리를 칠하세요.** **Traffic**을 켜고 약 8km 아래로 내려가세요 — 차량별 흐름이 실제 정체에 맞춰 색상으로 표시됩니다(TomTom 키 사용 시; 키 없이는 라벨이 붙은 시뮬레이션). 그런 다음 CCTV 패널에서 **NEAREST**를 누르고 그 정체를 향한 카메라로 지켜보세요.
6. **궤도의 무언가를 추적하세요.** **Satellites**를 켜고 ISS를 클릭하세요 — 궤도 거리에서 함께 이동하며, 궤도 링까지 표시됩니다.
7. **광학 장비를 전환하세요.** `1`–`7`을 누르세요 — CRT, NVG, FLIR — 전체 실시간 행성이 다른 센서로 다시 렌더링됩니다.
8. **말을 걸어보세요** *(OpenAI 키 필요)*: *"LAX로 데려가서 가장 가까운 공중 항공기를 선택해 줘."*
9. **집으로 돌아오세요.** **Reset Globe**을 누르거나 — 그냥 *"지구본 뷰로 축소해 줘"*라고 말하세요.
**키보드:** `1`–`7` 비주얼 스타일 · `H` HUD · `D` 탐지 · `C` 조종석 · `Esc` 종료.
---
## 🎙️ 말로 조종하기
> 음성에는 **OpenAI 키**가 필요합니다. 키가 없어도 전체 앱은 실행됩니다 — 마이크 버튼이 음성 사용 불가를 알릴 뿐입니다. 동일한 키가 **AI HUD 요약**도 구동합니다: 이동할 때마다 재생성되는 현재 뷰의 간결한 5단어 인텔리전스 스타일 요약입니다.
**GEV MIC**를 클릭하고 마이크 권한을 허용한 후 그냥 말하세요. 이는 단순한 음성 제어 리모컨 그 이상입니다:
- **🧠 보고 있는 것을 이해합니다.** 에이전트는 응답 전에 실시간 장면 컨텍스트를 가져옵니다 — 좌표, 도로명, 활성 레이어, 뷰 배율 포함. 비행 중 *"이 도시가 어디야?"*라고 물어보면 알고 있습니다.
- **🎯 개체 Q&A.** 비행기, 선박 또는 데이터센터를 클릭하고 *"이게 뭐야?"*라고 물어보세요. 개체의 실시간 텔레메트리를 사용해 답변합니다.
- **👁️ 시각적 근거.** 거리 레벨에서 뷰포트 스크린샷을 읽어 판독 가능한 간판과 건물 이름을 식별하며, 라벨을 환각하지 않도록 지시받습니다.
- **🎬 시네마틱 프레이밍.** *"위에 있는 비행기들을 보여줘"*라고 하면 카메라를 뒤로 당기고 각도를 조정해 마치 감독처럼 실시간 교통을 프레이밍합니다.
- **🔒 정직하고 안전합니다.** 에이전트는 성공한 작업만 확인합니다. `OPENAI_API_KEY`는 브라우저에 절대 노출되지 않으며, 클라이언트는 수명이 짧은 세션 토큰만 받습니다.
28개의 도구, 4가지 작업 — 아래 명령은 제품의 음성 테스트 스위트와 도구 플레이북에서 직접 가져온 것입니다:
**🎥 직접 조종** — 드론 운영자식 카메라 동사:
> 🗣️ *"도쿄로 데려가 줘."* · *"이 지역 주변을 천천히 공전해 줘."* · *"Capitol에서 Zilker Park까지 도보 경로를 그려 줘."* → *"방금 그린 경로를 비행해 줘."* · *"지구본 뷰로 축소해 줘."*
**🖊️ 주석 달기** — 실제 세계 위의 화이트보드:
> 🗣️ *"텍사스 주의 윤곽을 그려 줘."* · *"텍사스 주 의사당과 그 부지를 주석 처리해 줘"* — 원이 아닌 **실제 둘러싸는 경계**를 그립니다. · *"에펠탑에서 루브르까지 얼마나 멀어?"* — 연결 화살표가 나타나고 거리를 말로 알려줍니다. *"지도 지워 줘"*라고 말하기 전까지 모든 것이 유지됩니다.
**🔎 심문하기** — 실시간 레이어에 대한 분석가 질의:
> 🗣️ *"지금 텍사스 상공에 몇 대의 항공기가 있어?"* · *"오클랜드로 향하는 선박은 어느 것들이야?"* · *"로스앤젤레스 근처에서 가장 큰 화재는 뭐야?"* · *"4만 피트 이상을 비행하는 게 있나?"* · *"ISS가 다음에 언제 지나가?"*
**🎛️ 작동시키기** — 핸즈프리로 전체 콘솔:
> 🗣️ *"야간 투시경으로 전환하고 비행 레이어를 켜 줘."* · *"카메라 뷰세드를 켜 줘."* · *"Austin 근처의 뉴스 라디오 방송국을 틀어 줘."* · *"그 비행기를 추적해 줘."* → *"조종석 진입."*
**그리고 연속 발화 티어** — 각각 한 문장:
> 🗣️ *"전 세계 인프라를 보여줘."* (레이어를 구성하고 지구본으로 축소) · *"Orbital Watch 재생."* (전체 시네마틱 장면) · *"탐지 밀도를 50%로 설정해 줘."* · *"다음 접촉 — 헬리콥터만."* (조종석 중) · *"우주 미션을 보여줘."* · *"Bing 항공 뷰로 전환해 줘."* · *"이미지를 살짝 선명하게 해 줘."* · *"전술 레이아웃으로 전환해 줘."* · *"지금 뭐가 켜져 있어?"*
*어디든 라디오를 요청하면 지구본이 방송을 시작합니다 — 모든 방송국은 날아가 볼 수 있는 실제 장소입니다.*
---
## 🛰️ 지구본에 있는 것
13개의 실시간 레이어. **그중 10개는 아무것도 필요 없습니다** — 키도, 계정도, 가입도 없습니다.
| 레이어 | 제공 내용 | 소스 | 인증 |
|-------|--------------|--------|------|
| 🗺️ **Map Stack** | Google 사실적 3D, Bing 항공, OSM | Google / Ion / OSM | 🔴 Google (필수) · 🟡 Bing용 ion · 🟢 OSM |
| ✈️ **Live Flights** | 수천 대의 실시간 항공기 + 경로 이력 | OpenSky + adsb.lol | 🟢 (추가 폴링 크레딧용 🟡 선택) |
| 🎖️ **Military Flights** | 앰버색 ADS-B 군용 교통 | adsb.lol | 🟢 |
| 🚢 **Live Vessels** | 전 세계 수천 척의 선박 | AISStream | 🟡 |
| 🛰️ **Satellites** | 클래스별 색상 구분과 실시간 범례이 있는 약 840개체 핵심 카탈로그 — **DENSE** 칩은 전체 Starlink 셸을 추가합니다 | CelesTrak | 🟢 |
| 🌍 **Earthquakes** | 최근 24시간 전 세계 지진 활동 | USGS | 🟢 |
| 🚗 **Traffic** | 거리 레벨에서 차량별 흐름을 구동하는 실시간 정체 — 약 8km 아래로 내려가면 점들이 실제 정체에 맞춰 색상 표시. 키 없이는 근사 시뮬레이션 | TomTom + OSM | 🟢 (🟡 TomTom이 실제로 만듭니다 — 받아두세요) |
| 📹 **CCTV Mesh** | 3D 공간 *안에* 투사된 약 800대의 공공 카메라 — Austin · California (Caltrans) · London (TfL). 위치는 공개되고, 자세는 **카메라 자체의 기즈모를 드래그해 보정하는** 추정 사전값입니다 | City APIs | 🟢 |
| 📻 **Radio** | **아날로그 튜너**가 있는 지리 위치 기반 세계 라디오 — 최대 750개 방송국 사이로 바늘을 드래그하면 지구본이 각 방송사로 날아갑니다 | Radio Browser / broadcasters | 🟢 |
| 🚲 **Bikeshare** | 실시간 대여소 가용성 | GBFS | 🟢 |
| 🔥 **Active Fires** | 최근 24시간 실시간 NASA FIRMS 탐지 | NASA FIRMS | 🟡 |
| 🚀 **Space Missions** | 페이로드, 스테이지, 회수 상세가 포함된 최근 30일 발사 | Launch Library 2 | 🟢 (🟡 선택 토큰이 할당량을 늘립니다) |
| 🎖️ **Mapped Installations** | 커뮤니티 매핑의 뷰포트 범위 군사 시설 컨텍스트 — 본질적으로 불완전하며 그렇게 라벨링됨 | OpenStreetMap | 🟢 |
**지구본에도 있는 것:** 동네 오버레이 · 선택적 조종석 WX 구름 효과. **번들 정적 인프라:** 데이터센터(4,351), 댐(704), 해저 케이블(712).
**원하는 레이어가 없나요?** 이슈를 열거나 — 직접 추가하고 PR을 보내세요.
---
## 🎖️ 현장 미션
기본이 익숙해지면 다음을 실행해 보세요:
| 미션 | 방법 |
|---|---|
| **🚁 행성에 묻기** | *"왜 이 군용 헬리콥터들이 전부 원을 그리며 날고 있지?"* 군용 트랙을 선택하면 — 약 24시간의 실제 추적 이력을 자동으로 백필하고 — 무엇을 하고 있었는지, 겹겹이 쌓인 3D 루프로 확인할 수 있습니다. |
| **✈️ 최종 접근** | 활주로에 정렬 중인 여객기를 클릭 추적하고, **조종석**에 들어가 함께 착륙하세요. |
| **🌃 야간 감시** | 자신의 도시로 날아가 **NVG**로 전환하고 탐지 메시와 HUD가 장면을 읽게 하세요. |
| **🚢 기항** | Long Beach 항구 위로 선박들이 들어옵니다. 유조선을 클릭해 전술 카드와 항적을 확인한 다음 — CCTV 패널에서 **NEAREST**를 눌러 같은 수면을 공공 카메라로 보세요. |
| **📻 Tokyo FM** | **Radio** 레이어를 켠 상태로 Shibuya를 공전하세요 — 그런 다음 아날로그 튜너 바늘을 드래그: 각 위치가 실제 방송국에 스냅되고 지구본이 방송 중인 곳으로 날아갑니다. |
| **🔥 화재 전선** | California 상공의 FIRMS. 탐지를 클릭하면 — 카메라가 그곳으로 급강하합니다 — 강도를 읽은 다음 CCTV 패널에서 **NEAREST**를 눌러 지상 뷰를 확인하세요. |
| **🚶 도보 경로 요청** *🎙️* | 가고 싶은 곳을 말하면 실제 도로를 따라가는 경로가 3D 도시에 그려지는 것을 지켜보세요 — 그런 다음 *"비행해 줘"*: 뱅크 턴, 부드러운 종료, 드론 촬영처럼 경로를 이끄는 카메라. |
| **📏 LAX에서 DFW까지 측정** *🎙️* | *"LAX에서 DFW까지 얼마나 멀어?"* — 화살표가 나라를 가로지르고, 거리가 캡션에 표시되며, 공전하는 동안 끝점이 실제 세계에 고정됩니다. |
| **🚀 발사 재생** | **Space Missions**을 열고 최근 30일 중 발사를 선택한 다음 T-마이너스 카운트다운부터 궤도 진입까지 함께 타세요 — 0.25×–4×로 스크러빙 가능. 실제로 추정치이므로 `RECONSTRUCTED ESTIMATE`로 라벨링됩니다. |
| **🪦 항공기 묘지 산책** | 지역 컨텍스트에서 퇴역 항공기의 밀집되고 완전히 해상된 줄들로 내려가세요. |
| **🏗️ Three Gorges 공전** | 댐과 지형을 한눈에 훑은 다음 — **Dams** 레이어를 켜고 703개를 더 찾아보세요. |
| **🌊 백본 추적** | **Submarine Cables**를 켠 상태로 바하마로 잠수하세요 — 라벨이 붙은 경로가 수면 아래로 드러납니다, 전 세계 712개. |
*🎙️ = 음성 미션 — OpenAI 키가 필요합니다.*
*행성에 묻기: 군용 접촉의 최근 약 24시간 실제 추적 이력, 겹겹이 쌓인 3D 루프로 해상됨.*
*"도보 경로를 그려 줘… 이제 비행해 줘" — 뱅크 턴, 부드러운 종료, 드론 촬영처럼 경로를 이끄는 카메라.*
*항공기 묘지 산책: 3D로 완전히 해상된 퇴역 기체 줄들.*
*발사 재생: Falcon 9 상승, `RECONSTRUCTED ESTIMATE`로 라벨링, 0.25×–4× 스크러빙 가능.*
*백본 추적: 바하마 아래의 해저 케이블 경로.*
---
## 🔧 내부 구조
데모가 아닌 실제처럼 느껴지게 만드는 몇 가지 엔지니어링:
- **세계 안정 아이콘.** 항공기와 선박은 추적 여부, 수직으로 내려다보든 지평선을 가로지르든 모든 카메라 각도에서 *실제 실제 세계 방향*을 가리킵니다 — 프레임별 화면 공간 경로 투영을 통해. 회전도, 뷰포트 잠금도 없습니다.
- **불규칙한 데이터에서 부드러운 움직임.** 실시간 피드는 15–30초마다 도착합니다; 지구본은 실제 시간보다 한 간격 뒤에 렌더링하고 알려진 위치 사이를 보간합니다. 사선 항법이 간격을 채웁니다.
- **정직한 위성.** GMST 재정렬을 통해 위성에 고정된 궤도 링이 있는 SGP4 전파 — 드리프트도, 초당 깜빡임도 없습니다.
- **실제 지면 위에 위치.** 개체 높이는 실제 수직 기준면을 통과합니다 — 지오이드 인식, *렌더링된* 지형 메시에 대해 샘플링 — 항공기는 계류장에, 카메라는 거리 모서리에 서서 떠다니지 않습니다.
- **자체 할당량처럼 사용합니다.** 유료 피드는 캐시되고 예산이 관리되는 프록시 뒤에서 실행됩니다 — OpenSky 크레딧 거버너, TomTom 일일 타일 예산, 디스크 캐시 TLE — 오후 탐색이 API 할당량을 태우지 않도록.
- **로컬 우선 키 처리.** OpenAI, AISStream, OpenSky OAuth, TomTom, FIRMS 같은 비밀 보유 제공자는 서버 측에서 중개됩니다. 프록시 대상은 고정 또는 허용 목록에 있으며, 위험도가 높은 경로는 적절히 제한된 요청, 타임아웃, 응답 상한, 정화된 오류를 추가합니다. 브라우저에 의도적으로 노출되는 유일한 제공자 자격 증명은 Google Maps와 Cesium ion입니다; 제공자 측에서 둘 다 제한하세요.
- **프레임워크 없음.** 바닐라 JavaScript, **CesiumJS**, **Vite** — 행성용 **Google Photorealistic 3D Tiles**와 음성용 **OpenAI Realtime API** 포함. 읽기 쉽고, 해킹하기 쉽습니다.```
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
범례를 다시 한 번: 🟢 가입 불필요 — 바로 작동 · 🟡 무료 키 — 가입 후 붙여넣기만 하면 끝 · 🔴 과금제 — 결제가 활성화된 계정 필요. 비용은 적지만 실제로 청구됩니다.
전 세계 대부분은 🟢입니다: 항공편(익명), 군사 교통, 위성, 지진, CCTV, 라디오, 자전거 공유, 우주 임무, 매핑된 시설물, 그리고 모든 번들 데이터셋이 키 없이 실행됩니다.
완전한 키 기반 경험을 위해 다섯 개의 키가 필요합니다. 그중 세 개는 현재 무료 개발자 액세스를 제공하며, Google Maps와 OpenAI는 사용량 과금제입니다. 제공업체의 가격과 허용량은 변경될 수 있으므로, 예산을 산정하기 전에 링크된 가격 페이지를 확인하세요:
TomTom 키가 제공하는 것: The First Five Minutes의 5단계를 실제로 구현 — 근사 시뮬레이션 대신 실제 출퇴근 시간대 밀도가 도시 위에 표시됩니다.
모두 발급받을 가치가 있습니다. 시작하는 데 필수인 것은 없습니다.```bash
OPENAI_API_KEY="…" AISSTREAM_API_KEY="…" npm run dev -- --host localhost --port 4173
macOS에서는 Keychain에 키를 보관할 수도 있으며, `./scripts/dev-fresh.sh`가 이를 가져옵니다 — `security add-generic-password` 서비스 이름은 `.env.example`에 문서화되어 있습니다.
OpenSky는 완전히 익명으로 실행할 수 있으며(`OPENSKY_AUTH_MODE=anon`), `./scripts/opensky-import-client.sh /path/to/credentials.json`으로 OAuth 자격 증명을 가져올 수도 있습니다.
### 💸 실제 비용은 얼마인가
2026년 중반 기준 대략적인 정직한 수치입니다 — 항상 제공업체 요금 페이지를 확인하세요:
| | 비용 현실 |
|---|---|
| **🟢 대부분의 레이어** | **$0, 가입 불필요.** OpenSky anon, USGS, CelesTrak, adsb.lol, 도시 CCTV, Radio Browser, GBFS, Launch Library 2, 번들 데이터셋. |
| **🟡 선택적 개발자 액세스** | AISStream, FIRMS, TomTom, Cesium ion, 인증된 OpenSky는 무료 액세스를 제공할 수 있지만, 한도와 허용 용도는 다릅니다. 특히 Cesium ion과 OpenSky는 요금제 또는 사용 제한이 있습니다. 배포 환경에 맞는 현재 제공업체 약관을 확인하세요. |
| **🔴 Google 3D 타일** | 예상보다 관대합니다: 청구는 **루트 타일셋 요청**을 기준으로 합니다 — 한 번에 최대 **3시간**의 무제한 타일 렌더링을 구매하며, 첫 **월 1,000건은 무료**, 이후 약 **1,000건당 $6**입니다(미국 기준 가격, [현재 페이지 확인](https://developers.google.com/maps/billing-and-pricing/pricing), 요금은 청구 지역에 따라 다름). 개인 사용자는 거의 무료 등급을 벗어나지 않습니다. 그래도: 키를 제한하고, 할당량을 설정하고, 지속적인 사용 전에 예산 알림을 구성하세요. |
| **🔴 OpenAI 음성** | 실시간 오디오는 사용량에 따라 측정되며, 총 비용은 선택한 모델, 대화 길이, 오디오 볼륨에 따라 달라집니다. 앱은 실시간 세션 추정치를 표시하고, $2에서 경고하며, **앱 내 $5 세션 상한**을 적용합니다. 제공업체 측 사용 한도가 청구의 최종 안전장치로 남아 있습니다. |
### 🧗 진입 장벽은 의도적으로 낮게
위의 모든 것은 의도적으로 저렴한 기준선입니다 — 영업팀과 상담하지 않고도 지리공간 정보(GEOINT)와 OSINT의 실제 맛을 볼 수 있을 만큼 충분합니다. 또한 한계도 눈에 띌 것입니다: 지상 AIS는 대양 한가운데에서 조용해지고 위성 AIS는 실제 비용이 들며, 프리미엄 이미지, SAR, 더 깊은 상업용 피드는 엔터프라이즈 계약 뒤에 있습니다. 이는 아키텍처의 한계가 아닙니다 — 여기의 모든 레이어는 자신의 데이터 소스에 연결할 수 있는 패턴입니다. 이 저장소는 기반을 제공합니다. 무엇을 융합할지는 여러분의 몫입니다.
### 🔒 인스턴스 공유
기본적으로 다른 누구도 서버에 접근할 수 없습니다 — localhost에 바인딩됩니다. LAN에서 공유하려면 명시적으로 선택해야 합니다(`npm run dev -- --host 0.0.0.0 --port 4173`, 또는 macOS/Linux에서 `HOST=0.0.0.0 ./scripts/dev-fresh.sh`) — 단, ⚠️ **LAN에 노출된 서버는 접근 가능한 모든 사람에게 구성된 API 키를 중개합니다.** IP별 스로틀(`GEV_RATELIMIT_OPENAI_PER_MIN`, `GEV_RATELIMIT_GOOGLE_PER_MIN` — `.env.example` 참조)을 설정하고, 무엇보다 먼저 **제공업체 측 예산 상한을 설정하세요**(Google Cloud 예산, OpenAI 사용 한도): 스로틀은 앱 수준의 보호 장치일 뿐 청구 상한이 아닙니다. 전체 위협 모델은 [SECURITY.md](https://github.com/bilawalsidhu/gods-eye-view/blob/main/SECURITY.md)에 있습니다.
---
## 📋 책임과 개방
God's Eye View는 **공개 데이터, 명확한 출처, 로컬 우선 실행**으로 작동합니다. 비밀 없음, 개인 데이터셋 없음, 수수께끼 스크래핑 없음 — 개인 키가 관련된 모든 것은 서버 측에서 중개됩니다. 기밀 작전실의 시각적 문법을 갖추고 있지만, 전적으로 공개 신호와 검사 가능한 코드로 구축되었습니다.
**경계선.** 이 프로젝트는 **사건, 자산, 인프라, 시스템** — 항공기, 선박, 위성, 화재, 카메라, 도시 — 을 모델링합니다. 특정 인물 검색, 얼굴 인식, 개인 추적 기능은 구축하지 않으며, 그 경계를 넘는 풀 리퀘스트는 병합되지 않습니다. 사람은 여기서 쿼리 유형이 아닙니다.
**함께 만들어 가세요.** 이것은 최근 공간 정보 도구 물결을 시작한 프로젝트의 표준 라이브 3D 클라이언트입니다 — 그리고 그것은 캔버스입니다: 여기의 레이어는 한 사람이 찾아 융합할 수 있는 신호입니다. 도시 팩, 데이터 소스, 스타일, 음성 도구를 추가하세요. 그것은 세상을 보는 창입니다. 그 창을 다른 사람들에게도 가져가세요.
**상태:** 탐험과 학습을 위한 진화하는 오픈소스 클라이언트 — 빠르고 해킹 가능한 기반이지, 강화된 프로덕션 서비스가 아닙니다. **[MIT 라이선스](https://github.com/bilawalsidhu/gods-eye-view/blob/main/LICENSE)** 하에 출시되었습니다. 번들 및 라이브 데이터셋은 자체 약관을 따릅니다 — **[DATA_SOURCES.md](https://github.com/bilawalsidhu/gods-eye-view/blob/main/DATA_SOURCES.md)** 참조. 보안 모델: **[SECURITY.md](https://github.com/bilawalsidhu/gods-eye-view/blob/main/SECURITY.md)**. 기여하고 싶으신가요? **[CONTRIBUTING.md](https://github.com/bilawalsidhu/gods-eye-view/blob/main/CONTRIBUTING.md)**.
<sub>미디어 참고: Bilawal Sidhu가 이 페이지의 17개 캡처 GIF를 제작하고 소유합니다. 그는 또한 기존 공개 프로젝트의 두 README PNG를 게시했으며 여기에 계속 포함하는 것을 승인했습니다. Bilawal의 등장은 그의 허락을 받아 포함되었습니다. 이 파일들은 프로젝트 문서이지 MIT 라이선스 독립 자산이 아닙니다. 그 안에 보이는 플랫폼 인터페이스, 상표, 아바타, 데이터, 타사 이미지는 각 소유자의 약관을 따릅니다. [미디어 출처](https://github.com/bilawalsidhu/gods-eye-view/blob/main/docs/media/README.md) 및 [소스 약관](https://github.com/bilawalsidhu/gods-eye-view/blob/main/DATA_SOURCES.md) 참조.</sub>
> [!IMPORTANT]
> God's Eye View는 공개 및 타사 데이터의 탐색적 시각화입니다.
> 데이터는 지연되거나, 불완전하거나, 모델링되거나, 추론되거나, 잘못될 수 있습니다.
> 항공 또는 해상 항법, 긴급 대응, 의료 또는 건강 결정, 투자 결정,
> 기타 안전 필수 또는 운영 목적으로 사용하지 마세요. 중요한 정보는
> 권위 있는 출처로 확인하세요.
---
## 🧭 다음 단계
먼저 — 감사합니다. God-view 데모를 보고 각자 직접 구축하러 떠난 모든 분, 그리고 계속 코드를 요청해 주신 모든 분께 감사드립니다. 이 프로젝트를 오픈소스로 공개할지 설문했을 때, 여러분은 분명하지 않았습니다:
<img src="https://assets.kitploit.com/production/public/readmes/53672/d1eee944eaf04d9063d0251d21e1c8eb3b30471dc576044bab58917e35995924/aab0b9bd11b208c5db0f4e7b6c717c6c688fe22ca0c7996169f17b4a5c526b24-display-v1.webp" alt="God's Eye View 오픈소스화에 대한 커뮤니티 설문" width="460">
그래서 여기 있습니다. 스파이 스릴러 조종석 안으로 들어오세요 — 단, 데이터는 실제입니다 — 그리고 이것을 세상을 이해하기 위한 우리의 공유 샌드박스로 만들고, 즐겁게 해 봅시다. 이 저장소는 기준선이며, 계속 열려 있고, 핵심은 여러분이 무언가를 부수고 우리가 아직 생각하지 못한 레이어를 덧붙이는 것입니다.
내부에서 한 가지 알려드립니다: 이 공간에서 일주일만 구축하면 **현재가 가장 저렴한 부분**임을 배우게 됩니다. 과거로 돌아가려는 순간 — 실제 해상도로 *무슨 일이 있었는지*와 *무엇이 바뀌었는지*를 타일링, 서빙, 정리하는 것 — 데이터는 비싸지고 컴퓨팅은 가혹해집니다. 이를 위해 우리는 멋진 것을 구축하고 있습니다. 더 많은 것은 앞으로 — [halfpixel.ai](https://halfpixel.ai).
---
<div align="center">
▶️ [God's Eye View 시리즈 시청](https://youtube.com/playlist?list=PL6qSg2I-7_koPbDnSMo0QeeHX_RknA2uv&si=nBGYMoHWQw41v93Q) · 📬 [Map the World](https://maptheworld.ai/) — 프로젝트 뒤에 있는 뉴스레터
**🌐 God's Eye View. 남겨진 곳 없이.**
</div>
| 키 | 용도 | 발급처 |
|---|
| 🔴 | Google Maps (필수) | 사실적인 3D 행성 (Map Tiles API) | Google Cloud Console — 과금제. 현재 가격 확인 후 URL 제한을 걸 것 |
| 🔴 | OpenAI | 🎙️ 음성 경험 + AI HUD 요약. 다른 제공업체를 마이크 뒤에 쓰고 싶다면? PR 환영 | platform.openai.com — 과금제. 현재 API 가격 확인 |
| 🟡 | AISStream | 🚢 실시간 전 세계 선박 | aisstream.io — 무료입니다. 정말로, 2분이면 가입 완료 |
| 🟡 | NASA FIRMS | 🔥 실시간 활성 화재 | firms.modaps.eosdis.nasa.gov — 무료 |
| 🟡 | TomTom | 🚦 근사 시뮬레이션 대신 실제 교통 정보 | developer.tomtom.com — 계정의 현재 개발자 허용량 확인 |
| 키 | 용도 | 발급처 |
|---|
| 🟡 | Cesium ion | 🗺️ Bing 이미지 맵 스택 (공개 assets:read 토큰) | cesium.com/ion — 용도에 맞는 요금제 확인 |
| 🟡 | OpenSky | ✈️ 더 많은 항공편 폴링 크레딧 (🟢 익명으로도 작동) | opensky-network.org |
| 🟡 | Launch Library 2 | 🚀 더 높은 우주 임무 요청 허용량 (🟢 없이도 작동) | thespacedevs.com |