Improved www.ttss.krakow.pl
Jacek Kowalski
2023-12-18 ee953eef09cc090dc98a09038ab97be55875a2a5
commit | author | age
896879 1 # TTSS KRK
JK 2
0782c8 3 This is a rewrite of http://www.ttss.krakow.pl/ website
JK 4 presenting predicted tram arrival times in Krakow.
896879 5
JK 6 Check https://mpk.jacekk.net/ for a live version.
7
7cbf51 8 Contact and suggestions: mpk_AT_jacekk.info
JK 9
61c1ee 10 [![Build Status](https://travis-ci.org/jacekkow/mpk-ttss.svg?branch=master)](https://travis-ci.org/jacekkow/mpk-ttss)
7e7221 11 [![Codacy Badge](https://api.codacy.com/project/badge/Grade/530c81cbab3449a9b24327591361bec8)](https://www.codacy.com/app/jacekkow/mpk-ttss)
61c1ee 12
896879 13 ## Differences
JK 14
15 * Presents tram delays.
16 * Lists lines passing through selected stop.
7cbf51 17 * Improved autocompletion.
JK 18
19 ## Usage
20
21 ### Changing language
22
23 You can change the interface language using the dropdown near "TTSS Kraków" header.
24 Currently only Polish (PL) and English (EN) translations are available.
25
26 ### Selecting the stop
27
28 Enter first letter of a stop name into the input field labeled as "Stop name".
29 Suggestions will be displayed in the dropdown located to the right.
30
31 Each name component is matched separately (case-insensitive), so:
32
33 - "ba" matches "Teatr Bagatela",
34 - "d g" matches "Dworzec Główny", "Dworzec Główny Tunel" and "Dworzec Główny Zachód",
35 - "aleja" matches "M1 Al. Pokoju" and "TAURON Arena Kraków Al. Pokoju",
36 - "święt" matches "Plac Wszystkich Świętych", "Św.Gertrudy" and "Św.Wawrzyńca".
37
38 When the selected suggestion in the dropdown matches the desired stop,
39 click the "Go" button or (alternatively) press the ENTER key.
40
41 ### Display
42
43 After selecting the stop, the following information are visible:
44
45 - Line - line number,
46 - Direction - final stop on the line,
47 - Time - predicted/scheduled departure time,
48 - Delay - calculated delay from the schedule.
49
50 Relative times (eg. 3 min) are real-time arrivals based on tram location data.
51 Absolute times (eg. 8:01) are scheduled departures, shown when the tram cannot be located.
52
53 To the left of the time is an icon representing the tram type:
54 ♿ - low-floor tram,
55 *♿ - partially low-floor tram,
56 ‐ - high-floor tram.
57 Hover over an icon to show the tooltip with tram identifier and vehicle type.
58
59 Rows have different background depending on the tram status:
60 - green - at the stop,
61 - white - en-route,
62 - yellow - delayed 4 or more minutes,
63 - red - delayed 10 or more minutes.
64
68aeb4 65 Clicking on the table row loads the schedule for the selected tram
JK 66 - listing next stops and predicted departure times for each one.
67
7cbf51 68 ### Auto-refresh
JK 69
70 The list is automatically updated every 20 seconds. It is possible to manually
71 reload the data using the "Refresh" button.
72
73 When an error occurs, automatic update is disabled and manual refresh is required.
74 This event is indicated by the red message box just over the stop name.
75
76 ### Bookmarks
77
78 Changing the language or selecting a stop causes the address to change.
79 You may bookmark the address to avoid entering the data each time.
896879 80
JK 81 ## License
82
83 Project is licensed under the BSD 3-Clause license.
84 Feel free to contribute!