Skip to content

koraytuncer/Dynamic-AI-Map

Repository files navigation

🗺️ Dynamic Turkey Information Map

An interactive Turkey map and information system powered by artificial intelligence. Using Google's Gemini AI technology to provide dynamic information about cities and important locations in Turkey.

🇹🇷 Türkçe README

Demo

🚀 Features

  • 🤖 Natural language queries with Gemini AI
  • 🗺️ Interactive map view
  • 📱 Fully responsive design
  • 🎨 Modern and sleek interface
  • 🔍 Smart search system
  • 📍 Automatic location detection
  • 🖼️ Visual content with Wikipedia integration

🛠️ Technologies

  • Vue.js 3 - Frontend framework
  • Vite - Build tool
  • Tailwind CSS - Styling
  • Leaflet.js - Map library
  • OpenStreetMap - Map data provider
  • Google Gemini AI - AI API
  • Wikipedia API - Visual content

⚙️ Installation

  1. Clone the repository:

  2. Install dependencies:

  3. Copy .env.example to .env:

  4. Configure .env:

  • Add your Google Gemini API key to VITE_GOOGLE_MAPS_API_KEY
  • Customize other configuration values as needed
  1. Start development server:

🔑 Getting API Key

  1. Go to Google Cloud Console
  2. Create a new project
  3. Enable Gemini API
  4. Create API key
  5. Add the key to your .env file

🗺️ Map System

The project uses two main mapping components:

  • Leaflet.js: Map visualization and interaction library
  • OpenStreetMap: Open-source map data provider

This combination provides:

  • High-performance map rendering
  • Rich map interaction features
  • Reliable and up-to-date map data
  • Free and open-source infrastructure

📝 Usage

  1. Type your query in the search box:

    • Direct city name (e.g., "Istanbul")
    • Feature query (e.g., "City famous for apricots")
    • Location query (e.g., "Where is Ataturk's mausoleum?")
  2. Press Enter or click Search

  3. Results will be shown on the map and detailed information will appear in the side panel

🚀 Production Build

To create a production build:

Build files will be generated in the dist directory.

🤝 Contributing

  1. Fork the repository
  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

📄 License

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

👏 Acknowledgments

📞 Contact

Project Owner - Koray Tuncer

Project Link: https://github.com/koraytuncer/dynamic-turkey-map

Releases

No releases published

Packages

 
 
 

Contributors