Tonne Days Time Series

Please note: you will require a subscription to our Freight module to access this endpoint.

The Voyages Time Series Endpoint, using breakdown_property: ‘quantity, is used to retrieve the tonne days data as a time series. You can find detailed information regarding the Voyages Time Series Endpoint here.

You can find more information regarding the methodology for tonne days here here.

Example - daily tonne days for vessels leaving Rotterdam between 26th and 30th April 2022:

from vortexasdk import VoyagesTimeseries, Geographies
from datetime import datetime
rotterdam = [g.id for g in Geographies().search("rotterdam").to_list() if "port" in g.layer]
search_result = VoyagesTimeseries().search(
   origins=rotterdam,
   time_min=datetime(2022, 4, 26),
   time_max=datetime(2022, 4, 30, 23, 59),
   breakdown_property="cargo_quantity"
).to_df(columns=['key', 'value', 'count'])

	key	value	count
0	2022-04-26 00:00:00+00:00	2368640	173
1	2022-04-27 00:00:00+00:00	2483391	175
2	2022-04-28 00:00:00+00:00	2452820	174
3	2022-04-29 00:00:00+00:00	2540542	166
4	2022-04-30 00:00:00+00:00	2523616	161