59 lines
2.9 KiB
Python
59 lines
2.9 KiB
Python
from datetime import datetime
|
|
from typing import Union
|
|
from pyrmv.classes.Journey import Journey
|
|
from pyrmv.errors.not_ready import NotReadyYetError
|
|
from pyrmv.enums.rt_mode import RealTimeMode
|
|
from pyrmv.raw.journey_detail import journey_detail as raw_journey_detail
|
|
from pyrmv.utility.find_exception import find_exception
|
|
|
|
try:
|
|
from typing import Literal
|
|
except ImportError:
|
|
from typing_extensions import Literal
|
|
|
|
def journey_detail(
|
|
|
|
access_id: str,
|
|
id: str,
|
|
date: Union[str, datetime] = None,
|
|
real_time_mode: Literal[RealTimeMode.FULL, RealTimeMode.INFOS, RealTimeMode.OFF, RealTimeMode.REALTIME, RealTimeMode.SERVER_DEFAULT] = None,
|
|
from_id: str = None,
|
|
from_index: int = None,
|
|
to_id: str = None,
|
|
to_index: int = None
|
|
) -> Journey:
|
|
"""The journey_detail method will deliver information about the complete route of a vehicle. The journey
|
|
identifier is part of a trip or `board_departure` response. It contains a list of all stops/stations of this journey
|
|
including all departure and arrival times (with real-time data if available) and additional information like
|
|
specific attributes about facilities and other texts.
|
|
|
|
More detailed request is available as `raw.journey_detail()`, however returns `dict` instead of `Journey`.
|
|
|
|
### Args:
|
|
* access_id (`str`): Access ID for identifying the requesting client. Get your key on [RMV website](https://opendata.rmv.de/site/start.html).
|
|
* id (`str`): Specifies the internal journey id of the journey shall be retrieved. Maximum length 512.
|
|
* date (`Union[str, datetime]`, **optional**): Day of operation. Represented in the format `YYYY-MM-DD` or as a datetime object. By default the current server date is used. Defaults to `None`.
|
|
* real_time_mode (`Literal[RealTimeMode.FULL, RealTimeMode.INFOS, RealTimeMode.OFF, RealTimeMode.REALTIME, RealTimeMode.SERVER_DEFAULT]`, **optional**): Set the realtime mode to be used. Read more about this in HAFAS ReST Documentation. Defaults to `None`.
|
|
* from_id (`str`, **optional**): Specifies the station/stop ID the partial itinerary shall start from. Defaults to `None`.
|
|
* from_index (`int`, **optional**): Specifies the station/stop index the partial itinerary shall start from. Defaults to `None`.
|
|
* to_id (`str`, **optional**): Specifies the station/stop ID the partial itinerary shall end at. Defaults to `None`.
|
|
* to_index (`int`, **optional**): Specifies the station/stop index the partial itinerary shall end at. Defaults to `None`.
|
|
|
|
### Returns:
|
|
* Journey: Instance of Journey object.
|
|
"""
|
|
|
|
journey_raw = raw_journey_detail(
|
|
accessId=access_id,
|
|
id=id,
|
|
date=date,
|
|
rtMode=real_time_mode.code,
|
|
fromId=from_id,
|
|
fromIdx=from_index,
|
|
toId=to_id,
|
|
toIdx=to_index
|
|
)
|
|
|
|
find_exception(journey_raw)
|
|
|
|
return Journey(journey_raw) |