Skip to main content

​
AI-Powered Trip Planning

Development Status: AI-powered itinerary generation is currently planned but not yet implemented. MayTravel provides a complete REST API for manual trip planning, and AI features will be added in a future release.
MayTravel is designed to leverage Google Gemini AI with Retrieval-Augmented Generation (RAG) to transform your travel preferences into comprehensive, personalized itineraries. When implemented, the system will analyze your interests, destination, and travel dates to generate intelligent recommendations that match your travel style.

​
Current Capabilities

Right now, you can:
  • Create trips manually via the API
  • Add stops and activities to your trips
  • Associate interests with your profile
  • Manage points of interest
  • Store trip details with geospatial data
The AI integration will automate itinerary creation based on these same building blocks.

​
How AI Planning Works

1

Input Your Travel Details

Provide your destination, travel dates, accommodation location, and trip preferences to the platform.
2

Interest Analysis

The AI analyzes your saved interests and past travel patterns to understand your preferences.
3

Itinerary Generation

Google Gemini generates a day-by-day itinerary with activities, timing, and points of interest tailored to you.
4

Structured Output

The AI organizes your trip into a hierarchical structure: trips → days → stops → details.

​
Key Benefits

Personalized Recommendations

Every itinerary is unique, built around your specific interests and travel style.

Time Optimization

AI considers travel time, opening hours, and activity duration to create efficient daily plans.

Context-Aware Suggestions

RAG technology ensures recommendations are based on real, current information about destinations.

Dynamic Flexibility

The system adapts to changing preferences and can regenerate portions of your itinerary.

​
Creating an AI-Powered Trip

To create a new trip with AI assistance, send a request to the trips API with your travel details: 
POST /api/users/:id/trips

{
  "title": "Summer in Barcelona",
  "lat": 41.3874,
  "lng": 2.1686,
  "arrive_date": "2026-07-15",
  "leave_date": "2026-07-22"
}
The AI engine processes your request along with your user interests to generate a comprehensive itinerary.

​
Trip Structure

AI-generated trips follow a structured hierarchy:
1

Trip Level

Contains overall trip information: title, destination coordinates, arrival and departure dates.
2

Day Level

Each day is broken down into a logical sequence of activities and experiences.
3

Stop Level

Individual points of interest with arrival times, departure times, and visit order.
4

Detail Level

Rich information about each location including category, description, and practical details.

​
Retrieving Your AI-Generated Itinerary

Once your trip is created, you can retrieve the full itinerary with all AI-generated details: 
GET /api/trips/:id

Response:
{
  "title": "Summer in Barcelona",
  "shelter": { "type": "Point", "coordinates": [2.1686, 41.3874] },
  "arrive_date": "2026-07-15",
  "leave_date": "2026-07-22",
  "stops": [
    {
      "id": 1,
      "name": "Sagrada Familia",
      "category": "Architecture",
      "order": 1,
      "coming": "2026-07-15T09:00:00Z",
      "leaving": "2026-07-15T11:30:00Z"
    },
    {
      "id": 2,
      "name": "Park Güell",
      "category": "Parks & Gardens",
      "order": 2,
      "coming": "2026-07-15T12:30:00Z",
      "leaving": "2026-07-15T15:00:00Z"
    }
  ]
}

​
Interest-Based Planning

The AI tailors recommendations based on the interests stored in your profile. For example:

Culture Enthusiasts

Receives recommendations for museums, historical sites, galleries, and cultural events.

Adventure Seekers

Gets itineraries featuring outdoor activities, hiking trails, and adventure sports.

Food Lovers

Discovers local restaurants, food markets, cooking classes, and culinary experiences.

Relaxation Focus

Finds peaceful parks, spas, beaches, and leisurely activities.

​
Flexible Data Model

MayTravel’s database is designed to handle dynamic AI-generated content without breaking:
  • Extensible Schema: The system can store additional fields the AI generates without requiring schema changes.
  • JSONB Support: PostgreSQL’s JSONB capabilities allow for flexible, semi-structured data storage.
  • Graceful Handling: Unknown fields are preserved and returned in API responses.

​
Best Practices

The more interests you add to your profile, the better the AI can tailor recommendations. Add specific interests like “modern art”, “street food”, or “coastal hiking” rather than generic terms.
Give the AI enough time to work with. A 3-day trip allows for rich recommendations, while a single day may feel rushed.
The shelter coordinates help the AI optimize travel time between activities and your lodging.
AI suggestions are a starting point. Review the generated itinerary and make adjustments to match your exact preferences.

​
Learn More

User Profiles

Set up your profile to improve AI recommendations

Trip Management

Learn how to manage and organize your trips

Interests

Understand how interests shape your travel plans

AI Integration

Technical details about the AI architecture

Build docs developers (and LLMs) love

Get started for freeTalk to us