๐ŸŒโœจ Wanderverse โœจ๐ŸŒ

Submission for the Google Photorealistic 3D Maps Challenge

Welcome to Wanderverse, an immersive and Gemini-powered place-guessing game that redefines the way you explore the world. From iconic landmarks to hidden gems, Wanderverse blends thrilling competition, breathtaking 3D maps, and the power of AI to deliver an unforgettable journey.

๐ŸŒ Play Now: Wanderverse


๐Ÿš€ Project Overview

Wanderverse leverages the Google Maps Platform's Photorealistic 3D Maps and Gemini AI to create an engaging, lifelike experience. Players navigate real-world locations in stunning 3D, solve AI-generated clues, and climb the leaderboard in this unique exploration game.


๐Ÿ—๏ธ Features & Tech Stack

๐ŸŒŸ Key Features

  • Stunning 3D Visuals: Seamlessly explore lifelike locations using Googleโ€™s Photorealistic 3D Maps.
  • Smooth Animated Transitions: Dynamic animations like flyCameraTo and flyCameraAround bring scenes to life.
  • Bounded Exploration: Stay within defined boundaries while hunting for clues.
  • AI-Powered Clue System: Get dynamic hints from Gemini AI to guide your guesses.
  • Competitive Gameplay: Earn points based on accuracy and compete globally for the top spot.

๐Ÿ› ๏ธ Tech Stack

  • Google Maps Platform (Photorealistic 3D Maps via Maps JavaScript API)
  • Gemini AI for dynamic clue generation
  • Django Framework for robust backend development
  • Python 3.10 as the primary programming language

๐ŸŽฎ How to Play

  1. Visit Wanderverse: Play Now
  2. Explore the stunning 3D locations using intuitive controls.
  3. Solve AI-generated clues to guess the location.
  4. Submit your answer and earn points based on accuracy.
  5. Compete on the leaderboard with players worldwide!

๐Ÿ“ Why We Built This

The world is filled with incredible places waiting to be discovered. Wanderverse gamifies the experience of exploration by combining cutting-edge mapping technology with artificial intelligence. Our mission is to make learning about geography interactive, fun, and accessible while fostering a deeper appreciation for our planet's beauty.


๐Ÿ”ง How to Set Up Wanderverse

1. Get API Keys

2. Install Python

Ensure Python 3.10 or later is installed. Download it here.

3. Clone the Repository

git clone https://github.com/Harmanjit14/Wanderverse.git

Or download and extract the repository as a ZIP file.

4. Install Dependencies

pip install -r requirements.txt

5. Set Environment Variables

export GCP_GEMINI_API_KEY="YourGeminiAPIKey"
export GCP_MAPS_KEY="YourGoogleMapsAPIKey"

(Use set instead of export on Windows.)

6. Apply Migrations

python manage.py makemigrations
python manage.py migrate

7. Run the Server

python manage.py runserver

8. Play the Game

Visit http://localhost:8000 in your browser and start exploring!


๐ŸŒ Links & Resources


๐Ÿ† Join the Adventure

Explore, guess, and compete in Wanderverse! Experience the world in ways you've never imagined. Ready to start your journey? Let the games begin! ๐ŸŒโœจ


Share this project:

Updates