Požiadavka
POST https://opendata.zilina.sk/api/datasets/v1/public-transport/stops/list?outputType=xml
Parametre
{
"stopId": "12345",
"location": {
"type": "Polygon",
"coordinates": [
[
[18.730000, 49.210000],
[18.760000, 49.210000],
[18.760000, 49.230000],
[18.730000, 49.230000],
[18.730000, 49.210000]
]
]
},
"extras": {
"departures": true,
"routes": true
}
}
stopId (string, nepovinný) – Identifikátor zastávky. Ak je uvedený, výsledok bude obmedzený na konkrétnu zastávku.
location (object, nepovinný) – Geografická oblasť, v ktorej sa majú zastávky vyhľadať.
location.type (string) – Typ geometrie. Podporovaná hodnota je "Polygon".
location.coordinates (array) – Súradnice oblasti vo formáte [zemepisná dĺžka, zemepisná šírka].
extras (object, nepovinný) – Nastavenie doplnkových údajov vo výstupe.
extras.departures (boolean, nepovinný) – Ak je hodnota false, výstup nebude obsahovať aktuálne odchody. Predvolená hodnota je true.
extras.routes (boolean, nepovinný) – Ak je hodnota false, výstup nebude obsahovať zoznam liniek obsluhujúcich zastávku. Predvolená hodnota je true.
mandatoryFields (array of string, nepovinné) – Zoznam polí, ktoré musia byť pri zastávke vyplnené. Používa sa na filtrovanie neúplných záznamov.
Odpoveď
<root>
<item>
<stopId>1</stopId>
<name>Asanačný podnik</name>
<locationType>Stop</locationType>
<position>
<coordinates>
<item>18.8255</item>
<item>49.19102</item>
</coordinates>
<type>Point</type>
</position>
<zone>100</zone>
<departures></departures>
<vehicleType>
<item>Bus</item>
</vehicleType>
<routes>
<item>
<agency>Dopravný podnik mesta Žiliny s.r.o.</agency>
<color>EC7014</color>
<longName>Asanačný p. - Pietna,Krematórium a späť</longName>
<routeId>660_31</routeId>
<shortName>31</shortName>
<vehicleType>Bus</vehicleType>
</item>
</routes>
</item>
</root>
stopId (string) – Identifikátor zastávky.
name (string) – Názov zastávky.
position (object) – Geografická poloha zastávky.
position.type (string) – Typ geometrie polohy, napr. "Point".
position.coordinates (array of numbers) – Súradnice zastávky vo formáte [zemepisná dĺžka, zemepisná šírka].
vehicleType (array) – Typy dopravných prostriedkov, ktoré zastávku obsluhujú.
routes (array) – Zoznam liniek obsluhujúcich zastávku. Pole je dostupné, ak nie je vypnuté cez extras.routes.
routes.routeId (string) – Identifikátor linky.
routes.shortName (string) – Skrátený názov alebo číslo linky.
routes.longName (string) – Dlhý názov linky.
routes.vehicleType (string) – Typ dopravného prostriedku.
routes.agency (string) – Dopravca alebo prevádzkovateľ linky.
routes.color (string) – Farba linky, ak je dostupná.
departures (array) – Najbližšie odchody zo zastávky. Pole je dostupné, ak nie je vypnuté cez extras.departures.
departures.direction (string) – Smer jazdy.
departures.vehicleType (string) – Typ dopravného prostriedku.
departures.routeShortName (string) – Skrátený názov alebo číslo linky.
departures.routeId (string) – Identifikátor linky.
departures.tripId (string) – Identifikátor spoja.
departures.scheduleTime (string) – Plánovaný čas odchodu.
departures.realTime (string) – Odhadovaný aktuálny čas odchodu podľa dostupných údajov.
departures.deviation (number) – Odchýlka od cestovného poriadku v minútach.
departures.info (string|null) – Doplnková informácia k odchodu, ak je dostupná.
Poznámka
Výsledok obsahuje zastávky verejnej dopravy podľa zadaných filtrov.
Ak nie je zadaný žiadny filter, vrátia sa všetky dostupné zastávky.
Aktuálne odchody sú zoradené podľa najbližšieho odchodu a pre každú zastávku sa vracia najviac 10 najbližších odchodov.
Odchody staršie ako približne 2 minúty sa vo výstupe nezobrazujú.
