Urban Explorer: Discover Hidden Gems 🗺️

Urban Explorer is an interactive web application that transforms city exploration into an engaging, gamified experience. Using Google Maps Platform's Photorealistic 3D Maps, it helps users discover hidden gems and cultural landmarks while earning points and achievements.

Features ✨

• Immersive 3D City Exploration:

  • Experience cities in stunning detail with Photorealistic 3D Maps
  • Auto-orbit for 360° views
  • Toggle map labels
  • Custom 3D markers
  • World view from outer space as default perspective

• AI-Powered Discovery:

  • Natural language search for locations
  • AI-generated location descriptions and fun facts
  • Automatic tour generation based on user preferences
  • Smart location recommendations

• Tour Features:

  • Create custom tours manually
  • AI-generated themed tours
  • Interactive tour playback with camera controls
  • Smooth transitions between locations
  • Duration control for each stop

• 2024 Maps Unwrapped:

  • Yearly location summary
  • Interactive 3D timeline of visited places
  • Trip statistics and insights
  • Shareable travel highlights
  • Distance traveled calculations

• Social Features:

  • Compete on the leaderboard
  • Share discoveries
  • Profile customization
  • Achievement tracking

• Cultural Insights:

  • Dynamic fun facts about locations
  • Historical information
  • Local recommendations
  • Points of interest

Tech Stack 🛠️

• React + TypeScript
• Google Maps Platform
  • Photorealistic 3D Maps
  • Places API
  • Maps JavaScript API
• Google Gemini AI
• Framer Motion
• Tailwind CSS
• Zustand
• React Query
• React Router
• React Hook Form

Getting Started 🚀

1. Clone the repository:

   git clone https://github.com/yourusername/urban-explorer.git

2. Install dependencies:

   cd urban-explorer
   npm install

3. Create a .env file in the root directory and add your API keys:

   VITE_GOOGLE_MAPS_API_KEY=your_maps_api_key_here
   VITE_GEMINI_API_KEY=your_gemini_api_key_here

4. Start the development server:

   npm run dev

Usage 🎮

1. Sign up for an account
2. Select a city from the supported locations
3. Use the map controls to explore in 3D
4. Click on markers to discover locations
5. Create or generate tours
6. Track your yearly exploration progress
7. Share your discoveries

Contributing 🤝

We welcome contributions! Please follow these steps:

1. Fork the repository
2. Create a feature branch
3. Commit your changes
4. Push to the branch
5. Open a Pull Request

License 📄

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments 🙏

• Google Maps Platform for their amazing 3D mapping technology
• Google Gemini AI for intelligent content generation
• The open-source community for the fantastic tools and libraries
• All contributors who helped make this project possible

Contact 📧

For questions or feedback, please open an issue or contact the maintainers:

• GitHub Issues
• Email: contact@urbanexplorer.com

Screenshots 📸

Roadmap 🗓️

• Augmented reality features
• Enhanced social features
• Seasonal events and challenges
• Guided tours with local experts
• Mobile app development
• Advanced AI recommendations
• Virtual reality support

Stay tuned for more exciting features and improvements!