🚗 Road Trip Rest Planner

Instantly plan safe, optimized road trips with automatic hotel suggestions based on your personal driving limits.

Driving while tired is dangerous. The Road Trip Rest Planner solves this by calculating exactly where you need to stop for the night based on your specific driving limit (e.g., 8 hours per day). Instead of giving you random coordinates in the middle of nowhere, it intelligently scans the area for the highest-rated hotels and builds your itinerary around them.

---

🌟 Key Features

• ⏱️ Smart Rest Logic: You set the limit (e.g., "I only want to drive 6 hours a day"). We calculate exactly where you will be on the route when that time runs out.
• 🏨 Intelligent Hotel Finder: The tool automatically searches for 4+ star hotels near your calculated stop location and suggests the best one as your primary stop.
• 📍 Real-World Accuracy: Uses the Google Maps Directions API (not straight-line distance) to account for traffic patterns, highway speeds, and actual road paths.
• 🆓 Instant Demo Mode: Want to test the JSON format? Run it without an API key to see a sample itinerary instantly.
• 🔗 Ready-to-Click Links: Returns direct Google Maps links for every hotel, so you can book or navigate immediately.

---

📋 Input Parameters

Field	Type	Description	Default
origin	String	The city or specific address where you are starting.	New York, NY
destination	String	The city or specific address where you want to go.	Boston, MA
hrs_per_day	Number	Maximum number of hours you want to drive before sleeping.	8
google_api_key	String	Required for real results. Your Google Maps API Key. (Leave empty to run in Demo Mode).	None

⚠️ Important: To get real data, you must provide a valid Google Maps API Key with the Directions API and Places API (New) enabled.

---

💾 Data Output Reference

The results are saved in a structured dataset. You can download them as JSON, CSV, XML, or Excel.

Root Fields

Field	Type	Description
status	String	Result status (SUCCESS or DEMO_MODE).
origin	String	The starting point of the trip.
destination	String	The final destination.
total_trip_hours	Number	Total pure driving time (excluding stops) calculated by Google Maps.
stops_required	Number	The number of overnight stops needed based on your daily limit.
itinerary	Array	A list of daily stops (see below).

Itinerary Object (Daily Stops)

Inside the itinerary list, each "stop" contains:

Field	Type	Description
day_number	Number	The sequential day of the trip (1, 2, 3...).
stop_location	String	The name of the best hotel or city where the day ends.
approx_driving_hours	Number	How many hours of driving are scheduled for this specific day.
suggested_hotels	Array	A list of alternative top-rated hotels found nearby.

Hotel Object

Inside suggested_hotels, each hotel contains:

Field	Type	Description
name	String	The official name of the hotel.
rating	Number	Google Maps user rating (e.g., 4.5).
address	String	The local address or vicinity.
map_link	String	A direct, clickable URL to open this hotel in Google Maps.

---

📊 Sample Output (JSON)

{
  "status": "SUCCESS",
  "origin": "Delhi, India",
  "destination": "Bangalore, Karnataka, India",
  "total_trip_hours": 37.3,
  "stops_required": 4,
  "itinerary": [
    {
      "day_number": 1,
      "stop_location": "Country Inn & Suites by Radisson, Kota",
      "approx_driving_hours": 8.1,
      "suggested_hotels": [
        {
          "name": "Country Inn & Suites by Radisson",
          "rating": 4.5,
          "address": "Jhalawar Road, Kota",
          "map_link": "http://googleusercontent.com/maps..."
        }
      ]
    }
  ]
}