← 기술 블로그로

God's Eye View란? GitHub에서 화제인 ‘신의 시점’ 3D 지구 실측: 항공기·선박·위성을 실시간으로

God's Eye View: 실사 3D 지구의 실시간 항공기·선박·위성
편의 조종석, 항구 AIS, ISS 순. 공개 신호를 한 지구에.

2026년 9월 14일 기준 GitHub Trending을 탄 God's Eye View(bilawalsidhu/gods-eye-view)는 VFX도, 유료 정보 단말도 아니다. 브라우저의 실사 3D 지구에 공개 ADS-B 항공기, AIS 선박, CelesTrak 위성을 한 구에 겹친다. 데이터는 늦고, 빠지고, 때로 명시적으로 모델이다. README는 항법에 쓰지 말라고 먼저 적는다. 이 글은 실측 순서다. 무엇인지, 세 레이어의 출처, 5분 조작, 로컬 실행, 키 비용, 하면 안 되는 일.

God's Eye View가 실제로 하는 일

저장소 이름은 God's Eye View다. Bilawal Sidhu가 YouTube에서 실사 지구 시리즈(구 WorldView)를 먼저 올렸고, 2026년 8월 클라이언트를 오픈소스화한 뒤 GitHub 일간·주간 트렌딩에 올랐다. README 한 줄이면 충분하다. 브라우저의 첩보위성 시뮬레이터——다만 소스는 공개, 데이터는 진짜.

또 하나의 항공 추적 사이트가 아니다. FlightRadar24, MarineTraffic, CelesTrak은 각자 한 일만 잘한다. 여객기 아래 항구, 다음 ISS 통과, 공개 카메라를 같은 장면에서 보려면 탭을 네 개 연다. God's Eye View는 공개 신호를 들어갈 수 있는 장소로 바꾼다. 지형은 Google Photorealistic 3D, 엔진은 CesiumJS, 레이어 토글이 임무 패널이다.

스택은 얇다. Vanilla JS, CesiumJS, Vite. React 껍데기는 없다. 음성은 선택적 OpenAI Realtime. 키 없어도 지구는 돈다. 코드는 MIT, 번들 데이터는 각자 라이선스(해저 케이블은 CC BY-NC-SA, 상업용이면 제거). 출처는 bilawalsidhu/gods-eye-view.

한 줄: God's Eye View = 실사 3D 지구 + 공개 라이브 레이어. 기밀 조종석처럼 보인다. 피드는 전부 열어볼 수 있다.

만능 정보 데스크도 아니다. 육상 AIS는 대양 한가운데에서 끊긴다. 위성 AIS는 돈이다. TomTom 없는 교통은 근사 시뮬레이션으로 표시된다. 발사 재생은 RECONSTRUCTED ESTIMATE. 인명 검색, 얼굴 인식, 개인 추적 PR은 머지하지 않는다. 감사 가능한 GEOINT 샌드박스라면 맞다. 항법급·작전급이 필요하면 README 첫 페이지에서 거절당한다.

항공기·선박·위성 소스

「3D 지구에서 비행기·배·위성」검색이 원하는 것은 세 레이어다. 저장소는 열세 층 안팎, 열 층은 가입 없이 켜진다. 아래 표는 지도 스택과 이 세 층만. 백과사전으로 쓰지 않는다.

레이어보이는 것소스인증
실사 3D 지구계류장·선석까지 내려갈 수 있는 지형Google Photorealistic 3D Tiles. Bing / OSM 전환Google 키 필수(종량)
실시간 항공수천 대와 항적. 군용 ADS-B는 호박색OpenSky + adsb.lol익명 가능. OAuth로 폴링 증가
실시간 선박전 세계 AIS, 항적, 전술 카드AISStream무료 가입 키
위성약 840개 핵심 목표 색 구분. DENSE로 Starlink 껍질CelesTrak TLE + SGP4키 없음

항공은 진짜 트랜스폰더다. 클릭한 여객기는 ADS-B를 보낸다. 클라이언트는 실제 시간보다 폴링 간격 하나 늦게 그려 알려진 점 사이를 보간한다. 15–30초 생점프는 끊겨 보인다. 군용은 adsb.lol의 호박색. 선택하면 약 24시간 항적이 3D 고리로 쌓인다. SNS에서 「기밀」로 보이는 클립의 정체는 공개 ADS-B 이력이다.

선박은 AIS. 항구와 해협은 빽빽하고 대양 한가운데는 성기다. 육상 수신의 물리이지 버그가 아니다. AISStream 키가 없으면 레이어는 비어 있다. 유조선을 눌러 카드와 항적, CCTV의 NEAREST로 같은 수면의 공개 카메라. Austin, Caltrans, TfL은 3D 도시에 투영된다. 공개 카메라가 없는 항구는 빈다. 앱은 지어내지 않는다.

위성은 CelesTrak 이행사각과 SGP4. ISS를 누르면 궤도 고도까지 올라가고 고리는 GMST로 본체에 잠겨 깜빡이지 않는다. 코어는 수백 기, DENSE로 Starlink. 레이더가 아니라 궤도 예보. 신선도는 캐시된 TLE에 달렸다.

나머지는 선택. USGS 지진(24시간), NASA FIRMS(무료 MAP_KEY), Launch Library 2(30일), Radio Browser, GBFS. TomTom 없는 교통은 근사로 표시. 번들 데이터센터·댐·케이블은 DATA_SOURCES.md를 읽고 상업 제품에 넣는다.

5분 실측: 조종석, 항구, ISS

최근 노트북이면 콜드 스타트는 수 초(PERFORMANCE.md의 M5/Chrome 중앙값 1.86초는 비교용이지 필수 사양이 아니다). 첫 카드는 Live Contacts, Space Missions, Environmental. 항공기·배·위성만 보면 열세 층을 다 만질 필요 없다.

1분——하늘을 켠다. Flights 또는 Live Contacts. 기를 클릭: 잠금, 항적, 텔레메트리. COCKPIT으로 기수에서 Google 3D 지형을 내려간다. 1–7로 CRT / NVG / FLIR. 이름이 마케팅이 아니게 되는 순간이다. 표가 아니라 실기 위에 타고 있다.

2분——혼잡 공항. 아는 공항을 검색하고 유도로 높이까지 내려 3D 모델을 켠다. 787, ATR-72, Citation, Bell 206, MQ-9는 다가가면 글리프에서 기체로 바뀐다. 3만 피트 점만 보면 또 하나의 레이더 사이트처럼 보인다.

3분——항구. Vessels를 Long Beach, 싱가포르, 부산에서. 연안은 살아 있고 대양은 조용하다. 키가 없으면 aisstream.io에서 2분, 무료 가입. CCTV NEAREST는 도시가 카메라를 공개한 곳에서만 의미가 있다.

4–5분——궤도. Satellites에서 ISS. Space Missions에서 최근 30일 발사. RECONSTRUCTED ESTIMATE, 0.25×–4×. 「라이브 로켓을 봤다」고 쓰지 말 것. 공개 일정과 궤도 기하의 재구성이다.

음성은 가산점. OpenAI 키로 「LAX로 가서 가장 가까운 공중 기를 골라」「텍사스 상공 편은 몇 대」가 통한다. 없으면 마이크는 unavailable이라고 말하고 지구는 멈추지 않는다. 도구 28개. 장기 키는 브라우저에 안 나온다.

실측 순서: 편의 조종석, 항구 AIS, ISS. 세 수로 이 3D 지구가 추적 사이트와 다른 이유가 보인다.

로컬 실행: Node와 Google 키

package.json은 Node.js 24.14.x 또는 26.x. 다르면 install에서 막힌다. .env.example을 .env로 복사하고 GOOGLE_MAPS_API_KEY를 넣는다. 입장료는 이것뿐이다. 실사 행성이 꺼진다. 항공과 위성만으로 이야기는 끝난다. 배는 AISStream을 더한다.

최소 로컬 (localhost만)
git clone https://github.com/bilawalsidhu/gods-eye-view.git
cd gods-eye-view
cp .env.example .env
# .env 편집: 최소 GOOGLE_MAPS_API_KEY

npm install
npm run dev -- --host localhost --port 4173
# http://localhost:4173

개발 서버는 localhost. 키는 이 머신에 남는다. macOS는 ./scripts/dev-fresh.sh로 Vite 캐시를 비우고 키체인에서 키를 읽는다. LAN 공개는 명시적 --host 0.0.0.0. 닿는 사람은 당신 쿼터를 쓴다. 먼저 공급자 예산 상한, 다음에 GEV_RATELIMIT_*. 앱 스로틀은 청구 퓨즈가 아니다.

로컬 Node 메모리 감각은 OpenCode Review 4GB / 8GB / 16GB가 가깝다. God's Eye View가 먹는 것은 WebGL과 타일 캐시이지 모델 가중치가 아니다. 8GB로 둘러볼 수 있고 16GB가 더 안정적이다. 병목은 GPU와 디스크이지 「DIMM을 더하면 데이터센터」가 아니다.

타일 규칙은 바뀐다. Map Tiles API를 읽고 키를 제한하고 예산 알림을 켠다. 실사 3D는 세션 과금. 무료 한도는 청구 지역마다 움직인다. 석 달 전 달러 액을 런북에 복사하지 말 것.

왜 부드러운가: 지연, SGP4, 접지

NASA 파란 구를 붙였기 때문에 실재감이 있는 것이 아니다. 지루한 선택의 결과다.

문제클라이언트가 하는 일체감
항공기·선박은 15–30초 갱신벽시계보다 간격 하나 늦게 보간, 빈 곳은 추측항법부드럽다. 항상 반 박자 늦다
카메라를 기울이면 아이콘이 돈다프레임마다 화면 공간 침로기수·선수이 진짜 침로를 가리킨다
궤도 고리가 흐르거나 깜빡인다SGP4 + GMST로 고리를 본체에 고정ISS 고리가 같이 움직인다
기체가 계류장 위에 뜬다지오이드 높이를 렌더 메시에 샘플주기 기체가 타일 위에 앉는다
오후에 OpenSky / TomTom을 태운다캐시·예산 있는 서버 프록시바로 429는 아니다. 무제한도 아니다

트리는 얕다. main.js가 타일과 레이어, data/는 피드마다, voice/가 Realtime, iconOrientation.js가 침로. 도시 팩이나 자체 피드는 기존 레이어 복사. 저자는 「해킹 가능한 학습 클라이언트」라고 쓰지 hardened ops라고 쓰지 않는다. 팀에서 24/7이면 인증·감사·쿼터는 직접 붙인다. npm run dev는 프로덕션 계획이 아니다.

WebGL과 실사 타일은 CPU보다 GPU와 RAM을 먼저 먹는다. 덮개를 닫고, 내장 GPU가 싸우고, Chrome 탭 쉰 장——프레임이 먼저 죽는다. 샌드박스를 깨운 채 키를 업무 노트북과 나누려면 잠들지 않는 Apple Silicon에 둔다. 통합 메모리 이야기는 Mac mini M4 부하 메모와 같은 대역을, 이쪽은 타일에 쓴다.

키, 비용, 금지 용도

범례는 고정. 🟢 가입 없음, 🟡 무료 개발자 키, 🔴 종량. 필수 🔴는 Google Maps뿐. OpenAI는 음성과 다섯 단어 HUD. AISStream, FIRMS, TomTom, Cesium ion, OpenSky OAuth는 「있으면 좋고 없어도 대부분 보인다」.

Key사는 것없을 때
Google Maps(필수)실사 행성제품이 성립하지 않는다
AISStream세계 선박선박 레이어가 빔
OpenAI음성 연출 + AI HUD지구는 돈다. 마이크는 꺼짐
TomTom실제 정체교통은 시뮬레이션 표시
FIRMS24시간 화점불 레이어가 빔

비용은 자릿수까지. Google 3D는 세션 과금. 무료 한도는 지역마다 움직인다. OpenAI Realtime은 모델과 오디오. 앱은 약 2달러에서 경고, 5달러에서 세션 상한. 진짜 퓨즈는 공급자 쪽. 🟢——익명 OpenSky, USGS, CelesTrak, 도시 CCTV, 라디오——는 0원. 「무제한 정보 API」로 재판매하면 여러 라이선스를 깨고 첫 Google 청구서에서 수업료를 낸다.

저장소는 굵게 쓴다. 항공·해상 항법, 비상 대응, 의료, 투자, 그 밖의 안전 중요 용도에 쓰지 말 것. 데이터는 늦고, 빠지고, 모델되고, 틀린다. partial / delayed / simulated / unavailable은 글자 그대로. 인명 쿼리는 없다. 보도 확인, 교재, 자체 레이어는 범위 안. 사람을 노리거나 공식 레이더를 대체하는 일은 범위 밖. 이 글도 돕지 않는다.

Google 타일, OpenSky, AISStream이 닿지 않는 네트워크는 환경 문제이지 저장소 버그가 아니다. 닿는 머신에서 돌리고 키를 제한하고 LAN 바인드 전에 SECURITY.md를 읽는다.

잠들지 않는 Mac에 3D 지구를 둔다

God's Eye View는 동시에 셋이 필요하다. Node 24/26 프록시, WebGL 타일을 버티는 브라우저, 프론트에 쓰면 안 되는 API 키. 덮개를 닫으면 폴링이 멈추고 타일 캐시가 죽고 키가 Slack과 같은 머신에 남는다. Nuvcloud 클라우드 Mac mini는 전용 Apple Silicon 베어메탈. Cesium용 통합 메모리, 끊기지 않는 SSH, 저장소가 적는 키체인, 낮은 대기 전력. 업무 노트북에서 샌드박스를 떼어낼 수 있다.

항공기·선박·위성을 24/7로 데모나 포크에 쓰려면 Nuvcloud 요금과 거점부터, 잠들지 않는 Mac에서 지구를 돌리는 편이 비행마다 콜드 스타트하는 것보다 싸다.

더 읽기

자주 묻는 질문

공식 정보 소프트웨어인가요?

아닙니다. MIT 시각화 클라이언트이고 피드는 공개 소스뿐입니다. 조종석 피부는 인가가 아닙니다.

Google 키 없이 항공기와 위성을 볼 수 있나요?

피드 자체는 추가 인증이 적어도 됩니다. 실사 지구는 Google Map Tiles입니다. 키가 없으면 GIF에서 본 제품이 없습니다. OSM은 포스터 샷을 대체하지 않습니다.

선박 레이어가 빈 이유는?

Live Vessels는 무료 AISStream 키가 필요합니다. 그다음에도 연안은 빽빽하고 대양은 성깁니다. 육상 AIS 사정이지 새로고침 버그가 아닙니다.

기체는 초 단위 실시간인가요?

아닙니다. 소스는 15–30초, 클라이언트는 보간을 위해 간격 하나 늦습니다. 부드러운 근실시간이지 관제 레이더가 아닙니다.

항법이나 재난 지휘에 쓸 수 있나요?

없습니다. README는 항공·해상 항법, 비상 대응, 의료, 투자, 안전 중요 용도를 금합니다. 데이터는 틀리고, 늦고, 모델됩니다.

이름이나 얼굴로 검색할 수 있나요?

없습니다. 대상은 사건, 자산, 인프라, 시스템입니다. 인명 검색, 얼굴 인식, 개인 추적은 범위 밖이고 넘는 PR은 거절됩니다.

제한된 네트워크에서도 열리나요?

그 머신에서 Google 타일, OpenSky, AISStream이 해석될 때만입니다. 우회는 동봉되지 않습니다. 닿는 곳에서 돌리고 키를 제한하십시오.

새 Mac이 필요한가요?

아닙니다. 최근 노트북이면 콜드 스타트됩니다. 24/7 샌드박스를 업무 GPU와 나누려면 항상 켜 둔 클라우드 Mac mini가 전원 교체보다 쌉니다.

한정 혜택 →