Overview

The Route Events-Timeline API enables you to analyze and manage weather event impacts along multi‑segment routes. It is designed for sequential routes such as delivery operations, flight paths, logistics corridors, patrol missions, or infrastructure maintenance where each leg of the route may face unique weather conditions.

The API computes how weather insights apply over time and distance - highlighting when, where, and for how long certain conditions (e.g., heavy precipitation, strong winds, low visibility) are active. It supports multi‑leg structures and custom triggers, giving organizations a programmatic way to monitor risks, adjust schedules, and optimize operations in weather‑sensitive environments.

Use this API to: Track weather event activity along planned or live routes. Detect condition thresholds (e.g., crosswinds > 20 kt, precipitation > 2 mm/h) per route segment. Evaluate alternative routes based on forecast‑driven insights.

{
  "originTrigger": {"insightId": "1e8ffd82-a722-4c8c-a72c-5109725732b9"},
  "routeTrigger": {"insightId": "1e8ffd82-a722-4c8c-a72c-5109725732b9"},
  "destinationTrigger": {"insightId": "1e8ffd82-a722-4c8c-a72c-5109725732b9"},
  "route": {
    "id": "AB15036619_DRHK_GRDF",
    "start": "2025-07-28T14:58:00Z",
    "end": "2025-07-28T17:14:00Z",
    "attributes": {
      "aircraftType"        : "A321",
      "arrivalAirportIcao"  : "EDRR",
      "departureAirportIcao": "EFEE",
      "flightNumber"        : "ABC7FL",
      "status"              : "scheduled",
      "updateTime"          : "2025-07-28T11:50:08.655Z"
    },
    "legs": [
      {
        "id": 786362905625603,
        "min_altitude": 0,
        "max_altitude": 0,
        "object_key": "AB15036619_DRHK_GRDF_leg_786362905625603",
        "name": "",
        "start": "2025-07-28T14:58:00Z",
        "end": "2025-07-28T14:58:00Z",
        "locations": [
          {
            "geojsonGeometry": {
              "geometry": {
                "coordinates": [24.963300704956, 60.317199707031],
                "type": "Point"
              },
              "properties": {},
              "type": "Feature"
            }
          }
        ],
        "attributes": {"externalId": "EFHK", "legType": "origin"},
        "accountId": ""
      },
      {
        "id": 3281345181679183,
        "min_altitude": 10973,
        "max_altitude": 10973,
        "object_key": "AB15036619_DRHK_GRDF_leg_3281345181679183",
        "name": "",
        "start": "2025-07-28T15:05:00Z",
        "end": "2025-07-28T15:07:00Z",
        "locations": [
          {
            "geojsonGeometry": {
              "geometry": {
                "coordinates": [
                  [24.13888888888889,  59.73166666666667],
                  [23.951666666666668, 59.59916666666667]
                ],
                "type": "LineString"
              },
              "properties": {},
              "type": "Feature"
            }
          }
        ],
        "attributes": null,
        "accountId": ""
      },
      {
        "id": 1725818828208701,
        "min_altitude": 10973,
        "max_altitude": 10973,
        "object_key": "AB15036619_DRHK_GRDF_leg_1725818828208701",
        "name": "",
        "start": "2025-07-28T15:07:00Z",
        "end": "2025-07-28T15:08:00Z",
        "locations": [
          {
            "geojsonGeometry": {
              "geometry": {
                "coordinates": [
                  [23.951666666666668, 59.59916666666667],
                  [23.779444444444444, 59.47638888888889]
                ],
                "type": "LineString"
              },
              "properties": {},
              "type": "Feature"
            }
          }
        ],
        "attributes": null,
        "accountId": ""
      },
      {
        "id": 1480699009376008,
        "min_altitude": 0,
        "max_altitude": 0,
        "object_key": "AB15036619_DRHK_GRDF_leg_1480699009376008",
        "name": "",
        "start": "2025-07-28T17:16:00Z",
        "end": "2025-07-28T17:16:00Z",
        "locations": [
          {
            "geojsonGeometry": {
              "geometry": {
                "coordinates": [8.570556, 50.033333],
                "type": "Point"
              },
              "properties": {},
              "type": "Feature"
            }
          }
        ],
        "attributes": {"externalId": "GRDF", "legType": "destination"},
        "accountId": ""
      }
    ]
  }
}

{
  "route": {
    "id": "route_789",
    "start": "2025-10-05T06:00:00Z",
    "end": "2025-10-05T12:00:00Z",
    "attributes": {"mode": "road"},
    "legs": [
      {
        "id": "leg-1",
        "name": "Depot to Hub",
        "start": "2025-10-05T06:00:00Z",
        "end": "2025-10-05T09:00:00Z",
        "locations": [
          {
            "geojsonGeometry": {
              "type": "LineString",
              "coordinates": [[34.7818, 32.0853],[35.2137, 31.7683]]
            }
          }
        ],
        "attributes": {"speed_kph": 80}
      }
    ]
  },
  "routeTrigger": {
    "conditions": {
      "type": "all",
      "content": {},
      "children": [
        {
          "type": "threshold",
          "content": {"metric": "precipitation_rate", "op": ">=", "value": 2.0},
          "children": []
        }
      ]
    }
  }
}

{
  "data": {
    "calculatedEvents": [
      {
        "routeId": "route_789",
        "legId": "leg-1",
        "timeline": [
          {
            "from": "2025-10-05T06:00:00Z",
            "active": false,
            "activeValues": {"precipitation_rate": 0.0},
            "actualTriggerValues": {"precipitation_rate": 0.0}
          },
          {
            "from": "2025-10-05T07:00:00Z",
            "active": true,
            "activeValues": {"precipitation_rate": 2.6},
            "actualTriggerValues": {"precipitation_rate": 2.6}
          }
        ]
      }
    ]
  }
}