Whether this specifies departure or arrival time
Whether to specify a departure or arrival time.
The instant to depart or arrive.
OptionallocalDateTime?: neverOptionaldate?: neverThe wall-clock time to depart or arrive, without a UTC offset.
localDateTime is a wall-clock time without an offset, read in the origin's time zone.
With arriveBy, it is read in the time zone of the route's final destination instead.
The response's summary.departureTime and summary.arrivalTime carry the instants it
resolved to. A past or unreachable time defaults to departing immediately, as with date.
Traffic conditions vary significantly by:
Specifying a departure or arrival time enables the router to:
// Depart at 08:15 in Tokyo, wherever the code runs
const departParams: DepartArriveParams = {
option: 'departAt',
localDateTime: '2026-10-19T08:15:00'
};
// Arrive by an instant (catch a flight)
const arriveParams: DepartArriveParams = {
option: 'arriveBy',
date: new Date('2025-10-20T14:00:00+02:00')
};
The departure or arrival time for route planning.
It sets either when to depart from the origin or when to arrive at the destination. The routing engine then optimises the route for that time window, considering traffic patterns for that time of day.
Pass exactly one of
date, an instant, andlocalDateTime, a wall-clock time the routing API reads in the local time zone of the place it applies to.