# Find On Map

Find On Map

Find on Map is an open-source, map-based location guessing game. Players are shown a random street-level image and must guess the correct location on the map.
The closer the guess, the higher the score. Simple, fun, and educational!
Explore the docs »

Play Game · Report Bug · Request Feature

Table of Contents

1. About The Project
   • Built With
2. Getting Started
   • Prerequisites
   • Installation
3. Usage
4. Roadmap
5. Contributing
6. License
7. Contact
8. Acknowledgments

About The Project

Find on Map is a fun and educational map-based guessing game. The main idea is simple: you are shown a random street-level image from anywhere in the world, and your task is to find its location on the map.

The game combines exploration, geography, and observation skills into a single experience:

• 🌍 Explore the world from your screen through real street imagery
• 🧠 Train your brain by recognizing landmarks, signs, and landscapes.
• 🎮 Challenge yourself to guess as close as possible and score higher points.

The project was built as an experiment in combining open data (via Mapillary API ) with interactive mapping tools. It’s designed to be lightweight, open-source, and easy to extend—perfect for developers, educators, or anyone who enjoys map-based games.

(back to top)

Built With

• 
• 
• 
• 
• 
• 
• 
• 

(back to top)

Getting Started

Follow these steps to run the project locally:

Prerequisites

• Node.js >= 18
• npm >= 9
• API key from Mapillary

Installation

1. Clone the repo

git clone https://github.com/your-username/mapillary-geoguessr-clone.git
cd mapillary-geoguessr-clone

2. Install dependencies

npm install

3. Get a free API Key at https://www.mapillary.com/developer
4. Create a .env file in the project root:

VITE_MAPILLARY_TOKEN=/api

Executing Program

Run locally:

npm run dev

(back to top)

Usage

• Open the app in your browser
• Explore the panorama through MapillaryJS
• Try to guess where in the world you are 🌍
• Mark your prediction on the map within the 2-minute time limit

(back to top)

Roadmap

• Random location generator
• Street-view viewer with MapillaryJS
• Guessing mechanic with interactive map
• Scoring system
• Multiplayer support

See the open issues for a full list of proposed features (and known issues).

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Top contributors:

(back to top)

Contact

Ayşe Demirel Deniz - Linkedln - aysedemirel - aysedemireldeniz@gmail.com

(back to top)