航空機、衛星、地震などの公開情報は、別々のサイトで見ると位置関係をつかみにくいことがあるで。同じ地球上のレイヤーとして見る表現を学べるプロジェクトやで。
bilawalsidhu/gods-eye-viewは、公開信号や地理データを3D地球上で可視化するブラウザーアプリやで。この記事は公式README、導入案内、LICENSEを確認した紹介やで。実機での実行・性能比較は行ってへんで。
地理情報の見方
地理情報の可視化やWebの3D表現を調べたい開発者に向いてるで。READMEでは航空機、船舶、衛星、地震などのレイヤーや、任意の音声操作を紹介してるで。ただし、データ源によって認証や利用料、更新間隔、利用可能な地域が違うで。
今回のゴールと環境
APIキーを入れずに3D地球を表示し、地図データの出典を確認する。
確認した範囲：2026年10月24日に公式READMEや導入資料を読み直して、以下の手順を具体化したで。この改訂でアプリのインストールから最終結果までを実機で通したわけやない。成功の目安は、手元で試すときのチェックとして使ってな。
準備
ここではWindows 11 x64とPowerShellで進めるで。スタートで「PowerShell」を検索して開いてな。Node.js公式ダウンロードで24系LTS・Windows・x64のInstaller（.msi）を選び、ダウンロードしたファイルを開いて画面に沿って入れてな。入れ終わったらPowerShellを開き直すんや。
node --version
npm.cmd --version両方にバージョンが出たら準備OKや。以下ではWindowsのスクリプト実行ポリシーで止まりにくいnpm.cmdとnpx.cmdを使うで。インストール済みなら入れ直す必要はないで。
Git公式のWindows用ページからx64 Setupをダウンロードし、インストーラーの案内に沿って入れてな。PowerShellを開き直し、git --versionでバージョンが出ることを確認するんや。
Node.jsは24系なら24.14.0以上を使うで。地図表示には外部の地図サービスへの通信が必要や。今回は音声操作や有料のキーは設定せえへん。
使い方
New-Item -ItemType Directory -Force "$env:USERPROFILE\github-practice\gods-eye-view" | Out-Null
Set-Location "$env:USERPROFILE\github-practice\gods-eye-view"git clone https://github.com/bilawalsidhu/gods-eye-view.git
Set-Location gods-eye-view
npm.cmd ci
npm.cmd run doctor
npm.cmd run dev- doctorでエラーが出たら、出力された不足条件を先に確認するんや。devを実行したPowerShellは閉じずに残すで。
- ブラウザーで
http://localhost:4173を開き、初回パネルのExplore Manuallyを選んでな。 - 地球が表示されたらマウスで回転・ズームし、どの地図データを使ってるかを確認するで。ライブ情報のレイヤーを加える前に、データ源の条件と更新時点を見るんや。
成功の目安：地球が表示され、操作に応じて位置や縮尺が変わることや。リアルタイム情報の完全性や精度を確認したわけやないで。地図取得が止まるならキーを増やす前に、ネット接続やdoctorの結果を見るんや。
3D画面とデータ取得の関係
トラブルシューティング
| 困ったこと | 確認すること |
|---|---|
| 地球が出ない | doctorの出力とブラウザー・起動ログのエラーを見るで。外部地図の通信が遮断されてへんか確認してな。 |
| ポートを使えない | 4173を使う別のプロセスと起動ログのURLを確認してな。 |
終了と再開
PowerShellでCtrl+Cを押してサーバーを止めるで。再開は同じgods-eye-viewフォルダーでnpm.cmd run devや。キーを使う場合の.envやキャッシュは別に残るから、共有前に中身を確認してな。
公式READMEと最新の導入案内も確認してな。配布版や外部サービスの変更で、手順が変わることがあるで。
使い方の流れ
作業のビフォーアフター
| これまでの作業 | 導入後に目指す進め方 |
|---|---|
| 別々の情報源を開き、場所や時刻を頭の中で対応付ける。 | 共通の地球上に重ね、位置関係と情報源の違いを確認する。 |
地図・データ・素材の利用条件
CSVの自動判定はNOASSERTIONですが、実際のLICENSEはコードにMITを適用し、第三者データやモデルを明確に除外してるで。海底ケーブルのデータや一部のイベント素材には非商用条件があり、他のデータにも表示義務や独自の規約があるで。
商用利用や公開展示では、使用するレイヤーごとにDATA_SOURCES.mdと素材の条件を確認し、適合しないデータは外すか許諾を得るで。公開情報でも個人の行動追跡や、安全に関わる即時判断に安易に利用しないでな。
公式資料と利用条件
ソースコードはMIT。第三者データ、配信サービス、同梱3Dモデルは別ライセンス・規約やで。この記事ではそれらの画像やデータの転載をしてへんで。
確認日：2026年10月24日。掲載対象はHysen Labsの30日間スター純増CSV（2026年9月23日〜10月23日）の上位20件から、過去掲載を除いて選定したで。Hysen Labsが追跡するリポジトリ内の順位であり、GitHub全体を網羅するランキングやないで。集計は期間末と期間初のスター数の差分。データ提供：Hysen Labs（CC BY 4.0）。機能や条件は公式資料に基づく話やけど、実際の動作や生成結果を本記事で検証したものやないで。