Example · all examples

Road trip

This Roadbook represents a four-day Tuscany road trip by rented electric car: a vehicles entry with plate and rental details, a daily route (distance, driving time, charging plan, vehicleId), charging items, a parking booking that registers the plate, a wine tasting for one traveler, hikes and viewpoints with fallbacks, and a logistics note summarizing the charging strategy.

file road-trip.roadbook.json format 1.2 days 4 items 22 bookings 7 validates ✓ schema + reference validator

⤓ Download road-trip.roadbook.json View raw JSON Validate Preview

What this example shows#

It illustrates everything a driving trip needs that calendar formats cannot express: the vehicle as an entity, energy logistics, coordinates on items for offline maps, and the difference between an item (the drive) and its structured transport (from, to, vehicle).

Features demonstrated#

Manifest tags: vehicles electric rental route charging parking plate tasting viewpoint hike apps logistics — see examples/index.json.

Excerpt#

Abridged — the full file is the reference.

{
  "vehicles": [
    {
      "id": "v1",
      "name": "Rental EV",
      "kind": "car",
      "energy": "electric",
      "plate": "EX 123 AB",
      "rental": {
        "company": "Example Rent",
        "ref": "RENT-EXAMPLE",
        "pickup": "Florence airport, May 20 09:00",
        "dropoff": "Florence airport, May 23 18:00"
      }
    }
  ],
  "days": [
    {
      "id": "d1",
      "index": 1,
      "date": "2027-05-20",
      "title": "Florence → Siena",
      "route": {
        "km": 75,
        "drive": "1 h 15",
        "charge": "Charge to 80 % at the airport before leaving",
        "vehicleId": "v1"
      },
      "stayBookingId": "b-siena",
      "items": [
        {
          "id": "i2",
          "time": "09:30",
          "endTime": "10:00",
          "title": "Fast charge at the airport hub",
          "type": "charging",
          "status": "planned",
          "desc": "CCS 150 kW",
          "price": 18,
          "priceEstimated": true
        },
        {
          "id": "i3",
          "time": "10:00",
          "endTime": "11:15",
          "title": "Drive to Siena via the Chiantigiana (SR222)",
          "type": "drive",
          "status": "planned",
          "stars": 2,
          "transport": {
            "from": {
              "name": "Florence airport"
            },
            "to": {
              "name": "Siena, Parcheggio Il Campo"
            },
            "vehicleId": "v1"
          }
        },
        {
          "id": "i4",
          "time": "11:30",
          "title": "Park at Il Campo",
          "type": "admin",
          "status": "planned",
          "bookingId": "b-parking"
        }
      ]
    }
  ]
}

Use it#