Average Distance 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: avg_distance, is used to retrieve the average distance 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 average distance here here.

Example - daily average distance of 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="avg_distance",
    breakdown_unit_operator="avg",
    ).to_df(columns=['key', 'value', 'count'])

	key	value	count
0	2022-04-26 00:00:00+00:00	132.232760	215
1	2022-04-27 00:00:00+00:00	124.233386	227
2	2022-04-28 00:00:00+00:00	124.277043	228
3	2022-04-29 00:00:00+00:00	131.150994	226
4	2022-04-30 00:00:00+00:00	128.443887	221