Utilisation 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: 'utilisation', is used to retrieve the utilisation 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 utilisation here here.
Example - daily utilisation 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="utilisation"
).to_df(columns=['key', 'value', 'count'])
| key | value | count | |
|---|---|---|---|
| 0 | 2022-04-26 00:00:00+00:00 | 215 | 215 |
| 1 | 2022-04-27 00:00:00+00:00 | 214 | 214 |
| 2 | 2022-04-28 00:00:00+00:00 | 211 | 211 |
| 3 | 2022-04-29 00:00:00+00:00 | 207 | 207 |
| 4 | 2022-04-30 00:00:00+00:00 | 211 | 211 |