Skip to content

Flask-based backend API fetching and serving live NASA EPIC Earth imagery with automated refresh, caching, and JSON endpoints.

Notifications You must be signed in to change notification settings

Neo9Phoenix/earth-telemetry

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🌍 Earth Telemetry API

A Python + Flask backend service that fetches and serves live NASA EPIC Earth imagery.
It automatically refreshes data, caches the latest images, and exposes clean JSON + image endpoints.


🚀 Features

  • Flask API with GET /api/latest and /images/<file> routes
  • Automated NASA EPIC fetch every few hours via APScheduler
  • CORS-enabled for frontend access (Vercel)
  • Persistent caching of image + metadata in /data
  • Manual refresh endpoint (/api/refresh) to trigger fetch on demand

🔗 Live Deployment

Render: https://earth-telemetry-api.onrender.com


🧭 API Endpoints

Endpoint Method Description
/ GET Health check + endpoint list
/api/latest GET Returns the latest metadata.json (Earth image + date/time)
/api/refresh GET/POST Manually triggers an image refresh
/images/<file> GET Serves cached image from /data/images

Example:

curl https://earth-telemetry-api.onrender.com/api/latest

🧩 Tech Stack

Python 3.10+ Flask Flask-CORS APScheduler Render Web Service

⚙️ Local Development

git clone https://github.com/Neo9Phoenix/earth-telemetry.git
cd earth-telemetry
python -m venv venv
venv\Scripts\activate
pip install -r requirements.txt
python backend/app.py

Then open → http://127.0.0.1:5000/api/latest

🛰️ Credits

Data provided by NASA EPIC API Developed by Neo

About

Flask-based backend API fetching and serving live NASA EPIC Earth imagery with automated refresh, caching, and JSON endpoints.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published