API – trajektoria linii
Informacje o geograficznym przebiegu linii komunikacji miejskiej.
Zwracane są informacje wyłącznie dla linii, które danego dnia realizują kursy – i jedynie dla wariantów tras obowiązujących w danym dniu. Reset danych następuje każdego dnia o godz. 4:00.
- Endpoint:
GET https://www.zditm.szczecin.pl/api/v1/trajectories/{lineId}
(wartość parametru{lineId}
można uzyskać korzystając z API dla linii – poleid
) - Typ danych: application/json (GeoJSON)
- Częstotliwość aktualizacji: raz na dobę
Struktura danych
{
"type": "FeatureCollection",
"attributes": {
"line_id": 1,
"line_number": "1",
"line_type": "day",
"line_subtype": "normal",
"vehicle_type": "tram",
"updated_at": "2023-06-02T19:29:07.463152Z"
},
"features": [
{
"type": "Feature",
"properties": {
"route_variant_number": 11,
"route_variant_type": "default"
},
"geometry": {
"type": "LineString",
"coordinates": [
[
14.4884117153,
53.4571634728
],
...
]
}
},
...
]
}
- string
type
– zawsze wartośćFeatureCollection
- object
attributes
– obiekt zawierający informacje na temat danej linii komunikacji miejskiej- int
line_id
– identyfikator linii (niezmienny) - string
line_number
– oznaczenie (numer) linii (może ulegać zmianom) - string
line_type
– typ linii:day
– linia dziennanight
– linia nocna
- string
line_subtype
– podtyp linii:normal
– linia zwykłasemi-fast
– linia przyspieszonafast
– linia pospiesznareplacement
– linia zastępczaadditional
– linia dodatkowaspecial
– linia specjalnatourist
– linia turystyczna
- string
vehicle_type
– rodzaj trakcji:skm
– pociąg SKMtram
– tramwajbus
– autobus
- string
updated_at
– moment ostatniej aktualizacji danych
- int
- array
features
– tablica zawierająca przebieg poszczególnych tras linii- string
type
– zawsze wartośćFeature
- object
properties
– obiekt zawierający informacje na temat danej trasy- int
route_variant_number
– numer trasy dla linii (liczba nieparzysta oznacza kierunek TAM, a liczba parzysta – kierunek POWRÓT) - string
route_variant_type
– typ trasy:default
– trasa domyślna (podstawowa)normal
– trasa zwykłaother
– trasa inna (dojazd lub zjazd do zajezdni)
- int
- object
geometry
– obiekt zawierający trajektorię danej trasy- string
type
– zawsze wartośćLineString
- array
coordinates
– tablica zawierająca współrzędne geograficzne kolejnych punktów trasy (długość geograficzna, szerokość geograficzna)
- string
- string
Informacje ogólne
- Dane udostępniane są bezpłatnie, do wykorzystania w dowolnym celu, a ich użycie nie wymaga wcześniejszego zgłoszenia.
- Zarząd Dróg i Transportu Miejskiego w Szczecinie nie gwarantuje, że udostępniane dane są prawidłowe i kompletne. Nie ponosi również odpowiedzialności za szkody lub niewłaściwe decyzje podjęte na ich podstawie.
- W produkcie korzystającym z danych (aplikacja, strona internetowa, publikacja itp.) zalecane jest podanie źródła danych, tj. Zarząd Dróg i Transportu Miejskiego w Szczecinie lub – w formie skróconej – ZDiTM Szczecin.
- W produkcie korzystającym z danych (aplikacja, strona internetowa, publikacja itp.) zalecane jest – jeżeli jest to możliwe – umieszczenie odsyłacza do niniejszej strony lub do strony głównej.
- Klient powinien rozpoznawać i honorować nagłówki HTTP
Cache-Control
iETag
. - Liczba żądań do API jest limitowana. Limit jest wspólny dla wszystkich endpointów i wynosi 100 żądań na minutę na adres IP. Nagłówek
X-RateLimit-Remaining
zawiera liczbę żądań pozostałych w ramach dostępnego limitu. Po wyczerpaniu limitu zwracany jest kod odpowiedzi HTTP429
. Nagłówek odpowiedziX-RateLimit-Reset
zawiera wówczas uniksowy timestamp równy czasowi zresetowania limitu, a nagłówekRetry-After
zawiera liczbę sekund pozostałych do zresetowania limitu. - Jeżeli to możliwe, w nagłówku
User-Agent
żądania należy umieścić informację o podmiocie korzystającym z danych (np. nazwa aplikacji, strony internetowej, adres URL). - W przypadku nadmiernego obciążania serwera ZDiTM Szczecin zastrzega sobie prawo do częściowego lub całkowitego zablokowania dostępu do API.