TravelPlanner - Interactive Travel Itinerary Builder 🌍

A modern web application that helps users plan their travel itineraries with an interactive map interface, real-time weather updates, and smart itinerary management.

Features ✨

• Interactive Map Integration 🗺️

  • Real-time place search
  • Visual location markers
  • Detailed place information

• Smart Itinerary Builder 📅

  • Drag-and-drop scheduling
  • Time and date management
  • Automatic sorting by time

• Weather Updates ☀️

  • Real-time weather information
  • Weather forecasts for destinations
  • Temperature and condition details

• Responsive Design 📱

  • Works on desktop and mobile devices
  • Intuitive user interface
  • Modern, clean aesthetics

Technologies Used 🛠️

• HTML5, CSS3, JavaScript
• Tailwind CSS for styling
• Google Maps API
• Weather API
• Node.js & Express.js
• Geoapify API
• Unsplash API

Prerequisites 📋

Before running this project, make sure you have:

• Node.js (v14 or higher)
• npm (Node Package Manager)
• A code editor (VS Code recommended)
• API Keys for:
  • Google Maps
  • Weather API
  • Geoapify
  • Unsplash

Installation & Setup 🚀

1. Clone the repository
2. Install dependencies
3. Create environment variables Create a .env file in the root directory and add your API keys:
4. Start the server
5. Access the application Open your browser and navigate to:

API Setup Guide 🔑

Google Maps API

1. Go to Google Cloud Console
2. Create a new project
3. Enable Maps JavaScript API
4. Create credentials (API key)
5. Add restrictions to your API key

Weather API

1. Sign up at WeatherAPI
2. Get your API key
3. Add it to your .env file

Geoapify API

1. Register at Geoapify
2. Create a new project
3. Copy your API key
4. Add it to your .env file

Unsplash API

1. Register at Unsplash Developers
2. Create a new application
3. Get your API key
4. Add it to your .env file

Usage Guide 📖

1. Search for a Location

   • Enter a city or place name in the search bar
   • Select from the suggested locations

2. View Place Details

   • Click on map markers to see place information
   • View photos and basic details

3. Add to Itinerary

   • Click "Add to Itinerary"
   • Set date and time for the visit
   • Confirm to add to your schedule

4. Manage Itinerary

   • View your planned schedule
   • Modify times if needed
   • Remove items from itinerary

5. Check Weather

   • View current weather for locations
   • Check forecast for planned dates

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

Acknowledgments 🙏

• Google Maps Platform
• Weather API Team
• Geoapify Team
• Unsplash Team
• All contributors and supporters

---

Made with ❤️ by Jils