colincode0/earth-view
colincode0/earth-view has 418 GitHub stars and 52 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-21 20:19 UTC. Last push 2026-06-24.
측정된 스타 증가
- in 24h
- 0
- in 7 days
- 기록 수집 중
- in 15 days
- 기록 수집 중
- in 1 month
- 기록 수집 중
서로 겹치는 기간의 순증가량이며 일별 합계가 아닙니다. 측정값이 없으면 비워 둡니다. 스타는 관심도를 나타내며 품질을 보장하지 않습니다.
소개
Interactive 3D satellite imagery explorer pulling NASA GIBS and Copernicus Sentinel data onto a Three.js globe, with regional zoom, time lapses, and OpenAI/Anthropic view analysis
창작 및 미디어README.md
OriginalEarth View
Earth View is an open-source satellite imagery explorer built with React, Vite, Three.js, Tailwind CSS, and Zustand. It starts with a 3D NASA GIBS globe, lets you zoom into a detailed regional pass, and opens a modal workspace for higher-resolution inspection, Sentinel imagery, time lapses, Google Maps handoff, and optional AI-assisted image analysis.
Download for Windows
Not a developer? Grab the desktop app — no setup required:
⬇ Download Earth View for Windows
Run the installer (on first launch Windows may show a SmartScreen warning — click More info → Run anyway). The NASA globe works right away. To unlock Sentinel imagery and Ask AI, add your own free Copernicus keys (and optional OpenAI / Anthropic keys) in the app's Settings window. Build details: desktop/README.md.
This README is focused on getting a new copy running from scratch. For deeper architecture notes and feature details, see README-extended.md.
What Works Without API Keys
You can run the app immediately with no credentials. The no-key mode includes:
- NASA GIBS global globe imagery
- MODIS and VIIRS base layers
- GIBS analytic overlays
- borders, graticule, city labels, and activity overlays
- detailed max-zoom regional GIBS imagery
- modal pan/zoom, date/layer controls, GIBS time lapses, and Google Maps links
Optional credentials unlock:
- Copernicus Sentinel-2 and Sentinel-1 regional imagery, scene lists, Sentinel time lapses, and GIF export
- Ask AI chat in the modal through OpenAI and/or Anthropic
Requirements
- Node.js 18 or newer
- npm
- A modern browser with WebGL support
Quick Start
Clone the repo:
git clone <your-fork-or-repo-url>
cd earth-view
Install dependencies:
npm install
Create a local environment file:
cp .env.example .env
On Windows PowerShell:
Copy-Item .env.example .env
Start the dev server:
npm run dev
Open the app at:
http://127.0.0.1:5173
If you add or change .env values while the dev server is running, stop it and restart npm run dev.
Environment Variables
.env.example contains all supported local variables:
COPERNICUS_CLIENT_ID=
COPERNICUS_CLIENT_SECRET=
OPENAI_API_KEY=
ANTHROPIC_API_KEY=
All of these are optional for basic NASA GIBS usage. Do not prefix them with VITE_; they are read by the local/API server layer and should not be exposed to browser code.
Older Sentinel Hub variable names are still accepted:
SENTINELHUB_CLIENT_ID=
SENTINELHUB_CLIENT_SECRET=
Prefer COPERNICUS_CLIENT_ID and COPERNICUS_CLIENT_SECRET for new setups.
Copernicus Sentinel Setup
Sentinel support is optional, but it unlocks regional Sentinel-2 and Sentinel-1 imagery in the modal.
- Create a Copernicus Data Space Ecosystem account.
- Open the Copernicus Data Space Sentinel Hub Dashboard.
- Go to user settings and find the OAuth clients section.
- Create an OAuth client.
- Copy the client ID and client secret immediately. The secret may not be shown again after the dialog closes.
- Add them to
.env:
COPERNICUS_CLIENT_ID=your_client_id
COPERNICUS_CLIENT_SECRET=your_client_secret
The app uses these credentials server-side to request access tokens from the Copernicus Data Space token endpoint, then calls the Sentinel Hub Process and Catalog APIs. The official authentication guide is here: Sentinel Hub API authentication.
After saving .env, restart the dev server.
Ask AI Setup
Ask AI is optional. It appears inside the modal and can analyze the currently displayed image with view context such as coordinates, date, imagery provider, bbox, scene metadata, and follow-up chat history.
You can configure either provider or both.
OpenAI
- Create or open an OpenAI Platform account.
- Create an API key from the OpenAI API keys page.
- Add it to
.env:
OPENAI_API_KEY=your_openai_key
OpenAI's current quickstart is here: OpenAI developer quickstart.
Anthropic
- Create or open a Claude Console account.
- Create an API key from the Claude Console account settings.
- Add it to
.env:
ANTHROPIC_API_KEY=your_anthropic_key
Anthropic's current API overview is here: Claude API overview.
After saving .env, restart the dev server.
How To Use The App
On the globe:
- Drag to orbit Earth.
- Scroll or pinch to zoom around the cursor.
- Use the imagery panel to switch base layers and manage overlays.
- Toggle boundaries, labels, and activity overlays.
- Zoom close to enter the detailed regional view.
- Shift-click or right-click the globe or detailed view to open the modal.
In the modal:
- Drag to pan.
- Scroll to cursor-zoom.
- Shift-click to recenter.
- Change the date or imagery layer from the sidebar.
- Open Google Maps for the selected coordinate.
- Build GIBS or Sentinel time lapses.
- Use Ask AI when an OpenAI or Anthropic key is configured.
Available Scripts
npm run dev # Start Vite with local API middleware
npm run build # Type-check and build the production bundle
npm run preview # Preview the production build locally
npm run lint # Run ESLint
Data Sources
- NASA GIBS: global and regional MODIS/VIIRS imagery plus analytic overlays. No API key is required.
- Copernicus Data Space Ecosystem / Sentinel Hub APIs: optional Sentinel-2 and Sentinel-1 regional imagery. OAuth client credentials are required.
- USGS Earthquake Hazards Program: recent earthquake overlay.
- NASA EONET: volcano and severe-storm event overlays.
- Natural Earth: boundary context.
Deployment
The app is a Vite SPA with serverless-style API handlers in api/.
For a hosted deployment:
- Install dependencies with
npm install. - Build with
npm run build. - Serve the generated
dist/directory. - Configure the same environment variables on the host for Sentinel and Ask AI features.
- Make sure the host supports the API routes in
api/or adapt them to your server/runtime.
NASA GIBS-only functionality does not require server-side credentials, but Sentinel and Ask AI do.
Troubleshooting
The globe loads but Sentinel layers fail
Check that COPERNICUS_CLIENT_ID and COPERNICUS_CLIENT_SECRET are set in .env, then restart the dev server. Also confirm the OAuth client is active in the Copernicus Data Space Sentinel Hub Dashboard.
Ask AI is visible but requests fail
Set OPENAI_API_KEY or ANTHROPIC_API_KEY, restart the dev server, and verify the provider account has billing/API access enabled.
Environment variables are not being picked up
Restart npm run dev. Vite and the local API middleware read .env at server startup.
Imagery appears stale for the current day
Some public satellite products lag behind real time. The app intentionally defaults to a recent likely complete VIIRS day to avoid requesting incomplete current-day true-color imagery.
The browser is sluggish
The globe uses large WebGL textures and can be demanding on older hardware. Try closing other GPU-heavy tabs or reducing browser zoom.
Project Notes
The concise setup guide lives here in README.md. The fuller technical document is preserved as README-extended.md, including architecture notes, provider details, and implementation-oriented guidance.
관련 프로젝트 살펴보기
불러오는 중…