Skip to content

pinussen/mars-map

Repository files navigation

Mars Trilogy Interactive Map

An interactive map of Mars featuring locations from Kim Stanley Robinson's acclaimed Mars trilogy: Red Mars, Green Mars, and Blue Mars.

Features

  • Interactive Mars Map: Explore the surface of Mars using real Mars satellite imagery
  • Book Filtering: Filter locations by which book they appear in
  • Search Functionality: Search for specific locations by name or description
  • Color-coded Markers: Different colors for each book (Red, Green, Blue)
  • Detailed Information: Click on any location to see coordinates, book source, and description
  • Accurate Coordinates: Uses real Mars coordinates for authentic geographical locations

Locations Included

Red Mars (10 locations)

  • Underhill - First Martian city
  • Burroughs - Second Martian capital
  • Acheron Fossae - Biomedical research center
  • Sheffield - Space elevator terminus
  • Sabishii - University town
  • And more...

Green Mars (10 locations)

  • Dorsa Brevia - Underground conference center
  • Vishniac - Industrial mohole
  • Odessa - Hellas Sea port city
  • Da Vinci Crater - Research center
  • And more...

Blue Mars

  • Additional locations to be added

Technology

  • React - Frontend framework
  • Leaflet - Interactive mapping library
  • Proj4Leaflet - Mars coordinate system support
  • OpenPlanetaryMap - Mars satellite imagery tiles

Getting Started

Prerequisites

  • Node.js (version 14 or higher)
  • npm or yarn

Installation

  1. Clone the repository:
git clone [repository-url]
cd red-mars-map
  1. Install dependencies:
npm install
  1. Start the development server:
npm start
  1. Open http://localhost:3000 to view it in your browser.

Usage

  • Zoom and Pan: Use mouse wheel to zoom, click and drag to pan around Mars
  • Filter by Book: Use the dropdown to show only locations from specific books
  • Search: Type in the search bar to find locations by name or description
  • Location Details: Click on any marker to see detailed information about that location

About the Mars Trilogy

Kim Stanley Robinson's Mars trilogy is a landmark work of science fiction that chronicles the colonization and terraforming of Mars over several centuries. The books are renowned for their scientific accuracy and detailed world-building.

  1. Red Mars (1992) - The initial colonization
  2. Green Mars (1993) - The terraforming process begins
  3. Blue Mars (1996) - The completion of terraforming

Contributing

Contributions are welcome! Please feel free to submit a Pull Request. Areas where help is needed:

  • Adding more locations from Blue Mars
  • Improving coordinate accuracy
  • Adding more detailed descriptions
  • UI/UX improvements

License

This project is open source and available under the MIT License.

Acknowledgments

  • Kim Stanley Robinson for creating the Mars trilogy
  • OpenPlanetaryMap for providing Mars satellite imagery
  • The Leaflet community for excellent mapping tools

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published