Otwarte dane ZTM w Gdańsku - Baza pojazdów ZTM w Gdańsku

Zasób zawiera informacje o pojazdach należących do operatorów, realizujących rozkłady jazdy przygotowane przez ZTM w Gdańsku. Umożliwia pobranie pliku w formacie .json.

Od marca 2022 r. wprowadzono możliwość korzystania z dwóch wersji. Informację o niej należy podać w postaci wartości parametru v:

2 (https://files.cloudgdansk.pl/d/otwarte-dane/ztm/baza-pojazdow.json?v=2) - wersja druga wprowadza m.in.: metadane opisujące zasób, zmieniono nazwy pól na język angielski. Szczegóły w opisie poniżej.
1 (https://files.cloudgdansk.pl/d/otwarte-dane/ztm/baza-pojazdow.json?v=1) - wersja pierwsza pozostawiona została w celu zachowania kompatybilności. Termin wyłączenia planowany jest za ok. 2 lata. W międzyczasie, w przypadku odpytania zasobu bez podania parametru v, zacznie być zwracana odpowiedź w fromacie jak dla wersji 2.

Wersja 2 - zasób został podzielony na dwie struktury:

opisującą dane (https://files.cloudgdansk.pl/d/otwarte-dane/ztm/baza-pojazdow.header.json?v=2):
- description – opis. Obiekt składa się z następujących pól:
  - version: "2.0" – numer wersji zasobu,
  - title: "Baza pojazdów ZTM” – tytuł zasobu,
  - language: "pl" – w zasobie użyto języka polskiego,
  - country: "Polska" - kraj pochodzenia,
  - city: "Gdańsk" - miasto pochodzenia,
  - province: "pomorskie" - województwo pochodzenia,
  - sourceDate – data aktualizacji pliku źródłowego podana w formacie ISO-8601 (UTC),
  - generationDate – data aktualizacji zasobu podana w formacie ISO-8601 (UTC),
  - owner: „Zarząd Transportu Miejskiego, ul. Na Stoku 49, 80-874 Gdańsk” – nazwa oraz adres właściciela danych,
  - apiUrlData: "https://files.cloudgdansk.pl/d/otwarte-dane/ztm/baza-pojazdow.json?v=2" – adres wskazujący zasób zawierający dane właściwe;
  - licence: "CCA" - rodzaj licencji wykorzystywany w ramach projektu Otwarty Gdańsk,
- columnNames – lista pól z krótkim opisem. Wartości można wykorzystać jako nazwy kolumn:
  - photo: "foto" - pole zawierające oddzielone przecinkami nazwy plików ze zdjęciami pojazdów, bez rozszerzenia; odpowiednie zdjęcia w formacie *.jpg zamieszczone są w lokalizacji https://files.cloudgdansk.pl/f/otwarte-dane/ztm/baza-pojazdow/{nazwa_pliku}.jpg; dla pojazdów bez zdjęć pole przyjmuje wartość „no-foto”;
  - vehicleCode: "nr inwentarzowy" - unikalny w sieci komunikacyjnej Organizatora (tj. ZTM w Gdańsku), czterocyfrowy numer pojazdu, eksponowany również w pojeździe (na ścianach zewnętrznych oraz wewnątrz pojazdu).
    Odpowiednik pola o nazwie: VehicleCode w zasobie „Pozycja GPS pojazdów”;
  - carrier: "operator/przewoźnik" - właściciel lub dysponent pojazdu, z którym Organizator transportu miejskiego zawarł odpowiednią umowę na realizację przewozów w sieci Organizatora;
  - transportationType: "rodzaj pojazdu” - możliwe wartości: „autobus” lub „tramwaj”;
  - vehicleCharacteristics: "typ pojazdu" - pole przyjmuje wartości:
    - Minibus,
    - Midibus,
    - Standardowy,
    - Wielkopojemny,
    - Przegubowy.
      Wartość "Przegubowy" wskazuje pojazdy, zarówno autobusy jak i tramwaje, złożone z dwóch lub większej liczby sekcji (członów), połączonych elastycznie, nierozłącznych w warunkach typowej eksploatacji. Pozostałe wartości dotyczą wyłącznie pojazdów złożonych z jednej sekcji (członu) i w przypadku autobusów bezpośrednio zależą od długości pojazdu, a pośrednio – od pojemności pasażerskiej. "Minibus" – ma długość poniżej 8 m, "Midibus" - ok. 8 - 11 m; "Standardowy" - ok. 12 m; "Wielkopojemny" - ok. 18 m.
      Dla tramwajów jednosekcyjnych (jednoczłonowych) stosuje się wyłącznie wartość "Standardowy";
  - bidirectional: "pojazd dwukierunkowy" - pole przyjmuje wartość zależną od rodzaju pojazdów:
    - "false": dla autobusów,
    - "true" lub "false": dla tramwajów.
      Pojazd dwukierunkowy to tramwaj, który posiada dwie kabiny motorniczego oraz drzwi pasażerskie z dwóch stron. Pojazd taki dostosowany jest do obsługi tras niezakończonych pętlą;
  - historicVehicle: "pojazd zabytkowy" - pojazd o walorach historycznych i marketingowych, zazwyczaj eksploatowany okazjonalnie;
  - length: "długość [m]" - całkowita długość pojazdu określona w metrach;
  - brand: "marka" - marka pojazdu, zazwyczaj powiązana z nazwą producenta pojazdu lub producenta istotnych jego elementów (podwozia, nadwozia);
  - model: ”model" - model pojazdu, zwykle nadawany przez producenta, łączy w sobie wszystkie lub prawie wszystkie cechy techniczno-eksploatacyjne pojazdu. Różnice w parametrach poszczególnych egzemplarzy danego modelu, jeżeli występują, wynikają zwykle z modyfikacji projektu wraz z upływem czasu – m.in. ze względu na postęp technologiczny lub zmianę oczekiwań użytkowników;
  - productionYear: "rok produkcji" - rok produkcji pojazdu;
  - seats: " liczba miejsc siedzących" - całkowita liczba miejsc siedzących pasażerskich, w tym również składanych;
  - standingPlaces: " liczba miejsc stojących" - całkowita liczba miejsc stojących;
  - airConditioning: "klimatyzacja" - informacja o wyposażeniu pojazdu w klimatyzację przestrzeni pasażerskiej;
  - monitoring: "monitoring" - informacja o wyposażeniu pojazdu w monitoring przestrzeni pasażerskiej;
  - internalMonitor: "monitor wewnętrzny" – informacja o wyposażeniu pojazdu w monitory LCD, prezentujące informacje dla pasażerów, m.in. o numerze linii i kolejnych przystankach na trasie kursu;
  - floorHeight: "wysokość podłogi" - pole przyjmuje wartości:
    - "pojazd niskopodłogowy", jeżeli we wszystkich wejściach do pojazdu oraz w przejściu wzdłuż pojazdu nie ma stopni;
    - "pojazd częściowo niskopodłogowy", jeżeli w niektórych wejściach i/lub w przejściu wzdłuż pojazdu występują stopnie;
    - „pojazd wysokopodłogowy”, jeżeli w każdym wejściu do pojazdu znajdują się stopnie;
  - kneelingMechanism: "przyklęk" – informacja o możliwości obniżenia podłogi pojazdu przez osobę prowadzącą pojazd, w celu ułatwienia wejścia/wyjścia osobom o ograniczonej mobilności. Dotyczy wyłącznie autobusów;
  - wheelchairsRamp: "rampa dla wózków" - rozkładane ręcznie lub automatycznie urządzenie, montowane przy drzwiach pojazdu, umożlwiające zajęcie miejsca w pojeździe lub opuszczenie pojazdu na wózku inwalidzkim, bez konieczności podnoszenia lub przenoszenia wózka;
  - usb: "USB" - informacja o wyposażeniu pojazdu w ładowarki urządzeń mobilnych USB, dostępne nieodpłatnie dla pasażerów;
  - voiceAnnouncements: "zapowiedzi głosowe” - informacja o wyposażeniu pojazdu w zapowiedzi głosowe kolejnych przystanków, a także możliwość emisji innych informacji fonicznych w przestrzeni pasażerskiej;
  - aed: "AED" - informacja o wyposażeniu pojazdu w defibrylator;
  - bikeHolders: "mocowanie rowerów" - pole określające całkowitą liczbę miejsc na rowery;
  - ticketMachine: "biletomat" - informacja o wyposażeniu pojazdu w biletomat (biletomaty).;
  - patron: "patron" - imię, nazwisko, ewentualnie także inne elementy wskazujące osobę, na cześć której w pojeździe eksponowane są odpowiednie informacje. Dla pojazdów bez "patrona" pole przyjmuje wartość "brak";
  - url: "link" - lokalizacja w Internecie, w której prezentowane są wszystkie lub prawie wszystkie informacje o pojeździe, zawarte w „Bazie pojazdów”;
  - passengersDoors: "drzwi pasażerskie" – liczba drzwi udostępnianych pasażerom.
    Nie jest stosowane rozróżnienie wejść i wyjść, każde drzwi pełnią jednocześnie obie te funkcje. Dla pojazdów dwustronnych, tj. posiadających drzwi z prawej oraz z lewej strony, podano całkowitą liczbę drzwi, łącznie dla obu stron pojazdu. W pojazdach takich drzwi są udostępniane pasażerom naprzemiennie, z prawej lub z lewej strony, w zależności od lokalizacji peronu przystankowego. Teoretycznie, w szczególnych przypadkach możliwe jest jednoczesne udostępnienie drzwi z obu stron, jeżeli przystanek wyposażony jest w dwa perony. Obecnie (wg stanu na lipiec 2021 r.) takie rozwiązanie nie jest stosowane;
- fieldTypes - informacja na temat używanych typów pól:
  - photo: "string",
  - vehicleCode: "string",
  - carrirer: "string",
  - transportationType: "string",
  - vehicleCharacteristics: "string",
  - bidirectional: "boolean",
  - historicVehicle: "boolean",
  - length: "number",
  - brand: "string",
  - model: "string",
  - productionYear: "number",
  - seats: "number",
  - standingPlaces: "number",
  - airConditioning: "boolean",
  - monitoring: "boolean",
  - internalMonitor: "boolean",
  - floorHeight: "string",
  - kneelingMechanism: "boolean",
  - wheelchairsRamp: "boolean",
  - usb: "boolean",
  - voiceAnnouncements: "boolean",
  - aed: "boolean",
  - bikeHolders: "number",
  - ticketMachine: "boolean",
  - patron: "string",
  - url: "string",
  - passengersDoors: "number";
zawierającą dane (https://files.cloudgdansk.pl/d/otwarte-dane/ztm/baza-pojazdow.json?v=2):
- metadata – obiekt składa się z następujących pól:
  - title: "Baza pojazdów ZTM” – tytuł zasobu,
  - sourceDate: – data aktualizacji pliku źródłowego podana w formacie ISO-8601 (UTC),
  - generationDate: data aktualizacji zasobu podana w formacie ISO-8601 (UTC),
  - apiUrlHeader: https://files.cloudgdansk.pl/d/otwarte-dane/ztm/baza-pojazdow.header.json?v=2;
- count - pole wskazujące liczbę pojazdów opisanych w zasobie „Baza pojazdów”; wartość: liczba całkowita;
- results - zawiera obiekty reprezentujące każdy z pojazdów, według listy pól dostępnej w zasobie opisującym (https://files.cloudgdansk.pl/d/otwarte-dane/ztm/baza-pojazdow.header.json?v=2 ).

Wersja 1 zawiera następujące dane:

description – obiekt zawierający opis zasobu:
- title: "Baza pojazdów ZTM” – tytuł zasobu,
- language: "pl" – w zasobie użyto języka polskiego,
- sourceDate: „[YYYY-MM-DD HH:MM:SS]” – data aktualizacji pliku źródłowego,
- generationDate: „[YYYY-MM-DD HH:MM:SS]” – data aktualizacji zasobu,
- owner: „Zarząd Transportu Miejskiego, ul. Na Stoku 49, 80-874 Gdańsk” – nazwa oraz adres właściciela danych,
- source: „https://ckan.multimediagdansk.pl” – adres wskazujący cały zbiór danych udostępnianych w ramach projektu Otwarty Gdańsk;
columns – lista pól opisujących pojazdy:
- foto: "foto" - pole zawierające oddzielone przecinkami nazwy plików ze zdjęciami pojazdów, bez rozszerzenia; odpowiednie zdjęcia w formacie *.jpg zamieszczone są w lokalizacji https://files.cloudgdansk.pl/f/otwarte-dane/ztm/baza-pojazdow/{foto.jpg}; dla pojazdów bez zdjęć pole przyjmuje wartość „no-foto”;
- nr_inwentarzowy: "nr inwentarzowy" - unikalny w sieci komunikacyjnej Organizatora (tj. ZTM w Gdańsku), czterocyfrowy numer pojazdu, eksponowany również w pojeździe (na ścianach zewnętrznych oraz wewnątrz pojazdu). Odpowiednik pola o nazwie: VehicleCode w zasobie „Pozycja GPS pojazdów”;
- operator_przewoznik: "operator/przewoźnik" - właściciel lub dysponent pojazdu, z którym Organizator transportu miejskiego zawarł odpowiednią umowę na realizację przewozów w sieci Organizatora;
- rodzaj_pojazdu: "rodzaj pojazdu” - możliwe wartości: „autobus” lub „tramwaj”;
- typ_pojazdu: "typ pojazdu" - pole przyjmuje wartości:
  - Minibus,
  - Midibus,
  - Standardowy,
  - Wielkopojemny,
  - Przegubowy.
    Wartość "Przegubowy" wskazuje pojazdy, zarówno autobusy jak i tramwaje, złożone z dwóch lub większej liczby sekcji (członów), połączonych elastycznie, nierozłącznych w warunkach typowej eksploatacji. Pozostałe wartości dotyczą wyłącznie pojazdów złożonych z jednej sekcji (członu) i w przypadku autobusów bezpośrednio zależą od długości pojazdu, a pośrednio – od pojemności pasażerskiej. "Minibus" – ma długość poniżej 8 m, "Midibus" - ok. 8 - 11 m; "Standardowy" - ok. 12 m; "Wielkopojemny" - ok. 18 m.
    Dla tramwajów jednosekcyjnych (jednoczłonowych) stosuje się wyłącznie wartość "Standardowy";
- pojazd_dwukierunkowy: "pojazd dwukierunkowy" - pole przyjmuje wartość zależną od rodzaju pojazdów:
  - "nie": dla autobusów,
  - "tak" lub "nie": dla tramwajów.
    Pojazd dwukierunkowy to tramwaj, który posiada dwie kabiny motorniczego oraz drzwi pasażerskie z dwóch stron. Pojazd taki dostosowany jest do obsługi tras niezakończonych pętlą;
- pojazd_zabytkowy: "pojazd zabytkowy" - pojazd o walorach historycznych i marketingowych, zazwyczaj eksploatowany okazjonalnie. Pole przyjmuje wartości: „tak” lub „nie”;
- dlugosc: "długość [m]" - całkowita długość pojazdu określona w metrach. Pole określone wartością liczbową;
- marka: "marka" - marka pojazdu, zazwyczaj powiązana z nazwą producenta pojazdu lub producenta istotnych jego elementów (podwozia, nadwozia);
- model: ”model" - model pojazdu, zwykle nadawany przez producenta, łączy w sobie wszystkie lub prawie wszystkie cechy techniczno-eksploatacyjne pojazdu. Różnice w parametrach poszczególnych egzemplarzy danego modelu, jeżeli występują, wynikają zwykle z modyfikacji projektu wraz z upływem czasu – m.in. ze względu na postęp technologiczny lub zmianę oczekiwań użytkowników;
- rok_produkcji: "rok produkcji" - rok produkcji pojazdu;
- liczba_miejsc_siedzacych: " liczba miejsc siedzących" - całkowita liczba miejsc siedzących pasażerskich, w tym również składanych. Pole określone liczbą całkowitą;
- liczba_miejsc_stojacych: " liczba miejsc stojących" - całkowita liczba miejsc stojących. Pole określone liczbą całkowitą;
- klimatyzacja: "klimatyzacja" - informacja o wyposażeniu pojazdu w klimatyzację przestrzeni pasażerskiej. Pole przyjmuje wartości: „tak” lub „nie”;
- monitoring: "monitoring" - informacja o wyposażeniu pojazdu w monitoring przestrzeni pasażerskiej. Pole przyjmuje wartości: „tak” lub „nie”;
- monitor_wewnetrzny: "monitor wewnętrzny" – informacja o wyposażeniu pojazdu w monitory LCD, prezentujące informacje dla pasażerów, m.in. o numerze linii i kolejnych przystankach na trasie kursu. Pole przyjmuje wartości: „tak” lub „nie”;
- wysokosc_podlogi: "wysokość podłogi" - pole przyjmuje wartości:
  - "pojazd niskopodłogowy", jeżeli we wszystkich wejściach do pojazdu oraz w przejściu wzdłuż pojazdu nie ma stopni;
  - "pojazd częściowo niskopodłogowy", jeżeli w niektórych wejściach i/lub w przejściu wzdłuż pojazdu występują stopnie;
  - „pojazd wysokopodłogowy”, jeżeli w każdym wejściu do pojazdu znajdują się stopnie;
- przyklek: "przyklęk" – informacja o możliwości obniżenia podłogi pojazdu przez osobę prowadzącą pojazd, w celu ułatwienia wejścia/wyjścia osobom o ograniczonej mobilności. Dotyczy wyłącznie autobusów. Pole przyjmuje wartości: „tak” lub „nie”;
- rampa_dla_wozkow: "rampa dla wózków" - rozkładane ręcznie lub automatycznie urządzenie, montowane przy drzwiach pojazdu, umożlwiające zajęcie miejsca w pojeździe lub opuszczenie pojazdu na wózku inwalidzkim, bez konieczności podnoszenia lub przenoszenia wózka. Pole przyjmuje wartości: „tak” lub „nie”;
- USB: "USB" - informacja o wyposażeniu pojazdu w ładowarki urządzeń mobilnych USB, dostępne nieodpłatnie dla pasażerów. Pole przyjmuje wartości: „tak” lub „nie”;
- zapowiedzi_glosowe: "zapowiedzi głosowe” - informacja o wyposażeniu pojazdu w zapowiedzi głosowe kolejnych przystanków, a także możliwość emisji innych informacji fonicznych w przestrzeni pasażerskiej. Pole przyjmuje wartości: „tak” lub „nie”;
- AED: "AED" - informacja o wyposażeniu pojazdu w defibrylator. Pole przyjmuje wartości: „tak” lub „nie”;
- mocowanie_rowerow: "mocowanie rowerów" - pole określające całkowitą liczbę miejsc na rowery. Pole wyrażone liczbą całkowitą;
- biletomat: "biletomat" - informacja o wyposażeniu pojazdu w biletomat (biletomaty). Pole przyjmuje wartości: „tak” lub „nie”;
- patron: "patron" - imię, nazwisko, ewentualnie także inne elementy wskazujące osobę, na cześć której w pojeździe eksponowane są odpowiednie informacje. Dla pojazdów bez "patrona" pole przyjmuje wartość "brak";
- link: "link" - lokalizacja w Internecie, w której prezentowane są wszystkie lub prawie wszystkie informacje o pojeździe, zawarte w „Bazie pojazdów”;
- drzwi_pasazerskie: "drzwi pasażerskie" – liczba drzwi udostępnianych pasażerom.
  Nie jest stosowane rozróżnienie wejść i wyjść, każde drzwi pełnią jednocześnie obie te funkcje. Dla pojazdów dwustronnych, tj. posiadających drzwi z prawej oraz z lewej strony, podano całkowitą liczbę drzwi, łącznie dla obu stron pojazdu. W pojazdach takich drzwi są udostępniane pasażerom naprzemiennie, z prawej lub z lewej strony, w zależności od lokalizacji peronu przystankowego. Teoretycznie, w szczególnych przypadkach możliwe jest jednoczesne udostępnienie drzwi z obu stron, jeżeli przystanek wyposażony jest w dwa perony. Obecnie (wg stanu na lipiec 2021 r.) takie rozwiązanie nie jest stosowane;
count - pole wskazujące liczbę pojazdów opisanych w zasobie „Baza pojazdów”; wartość: liczba całkowita;
results - obiekt zawierający opis dla każdego z pojazdów, według listy pól dostępnej w sekcji „columns”.

Pole	Wartość
Data last updated	12 sierpnia 2021
Metadata last updated	12 sierpnia 2021
Created	12 sierpnia 2021
Format	JSON
Licencja	Creative Commons Attribution
Datastore active	False
Has views	False
Id	fff34d32-885d-4622-a9a2-c2d18ccf68c1
Package id	c24aa637-3619-4dc2-a171-a23eec8f2172
Position	12
State	active

Baza pojazdów ZTM w Gdańsku

Dodatkowe informacje