Udostępnij przez


BKK Futar (niezależny wydawca) (wersja zapoznawcza)

Uzyskaj i przeszukaj informacje planowane i w czasie rzeczywistym z systemu BKK FUTAR - transportu publicznego Budapesztu - dotyczące podróży, pojazdów, przystanków i wiele innych!

Ten łącznik jest dostępny w następujących produktach i regionach:

Usługa Class Regions
Copilot Studio Premium Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Logic Apps Standard Wszystkie regiony usługi Logic Apps z wyjątkiem następujących:
     — Regiony platformy Azure Government
     — Regiony platformy Azure (Chiny)
     - Departament Obrony USA (DoD)
Power Apps Premium Wszystkie regiony usługi Power Apps z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Power Automate Premium Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Kontakt
Name Fördős András
Email fordosa90+ipc_bkk@gmail.com
Metadane łącznika
Publisher Fördős András
Witryna internetowa https://opendata.bkk.hu/data-sources
Zasady ochrony prywatności https://bkk.hu/en/about-bkk/data-management-information/
Kategorie Dane

Tworzenie połączenia

Łącznik obsługuje następujące typy uwierzytelniania:

Wartość domyślna Parametry tworzenia połączenia. Wszystkie regiony Nie można udostępniać

Domyślny

Dotyczy: wszystkie regiony

Parametry tworzenia połączenia.

Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.

Name Typ Description Wymagane
Klucz interfejsu API securestring Klucz interfejsu API dla tego interfejsu API Prawda

Limity ograniczania

Nazwa Wywołania Okres odnowienia
Wywołania interfejsu API na połączenie 100 60 sekund

Akcje

Pobieranie harmonogramu zatrzymania

Wyświetlanie listy harmonogramu dla wybranego zatrzymania

Pobieranie przystanków dla lokalizacji

Zatrzymanie listy dla wybranej lokalizacji lub wszystkie przystanki

Pobierz pojazdy do zatrzymania

Lista pojazdów, które znajdują się na trasie zawierającej wybrany przystanek

Uzyskaj przyjazdy i wyjazdy na przystanek

Wyświetlanie listy przylotów i odlotów dla wybranego przystanku

Uzyskaj stacje wypożyczania rowerów

Uzyskaj informacje o stacjach wypożyczania rowerów

Uzyskiwanie odwołań

Pobieranie odwołań opartych na identyfikatorach.

Wyszukaj alerty

Wykaz aktywnych zakłóceń odpowiadających kryteriom wyszukiwania

Pobieranie harmonogramu zatrzymania

Wyświetlanie listy harmonogramu dla wybranego zatrzymania

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator zatrzymania
stopId True string

Zatrzymaj identyfikator, aby wysyłać zapytania dotyczące danych, takich jak "BKK_F01227".

Date
date string

Żądana data w formacie RRRRMDD, takim jak 20230131, domyślnie ustawiona na dzisiaj.

Tylko wyjazdy
onlyDepartures boolean

Wskazuje, czy wyniki są zwracane z przylotami lub bez niego.

Dołącz odwołania
includeReferences string

Zdefiniuj typ odwołań.

Zwraca

Nazwa Ścieżka Typ Opis
Bieżący czas
currentTime TimeResponse

Bieżący czas serwera w milisekundach.

wersja
version VersionResponse

Wersja interfejsu API.

Status
status StatusResponse

Stan odpowiedzi.

Code
code CodeResponse

Kod stanu odpowiedzi.

Tekst
text TextResponse

Szczegółowy tekst odpowiedzi związany z kodem stanu.

Identyfikator zatrzymania
data.entry.stopId string

Unikatowy identyfikator żądanego zatrzymania.

Date
data.entry.date string

Data żądanego harmonogramu w formacie RRRRDD, takim jak 20230130.

Identyfikatory tras
data.entry.routeIds array of string

Tablica powiązanych identyfikatorów tras dla harmonogramu.

Identyfikatory przystanków znajdujących się w pobliżu
data.entry.nearbyStopIds array of string

Tablica identyfikatorów przystanków znajdujących się w pobliżu.

Identyfikatory alertów
data.entry.alertIds array of string

Tablica powiązanych identyfikatorów alertów dla zatrzymania

Schedule
data.entry.schedules array of object

Tablica harmonogramów związanych z zatrzymaniem.

Identyfikator trasy
data.entry.schedules.routeId string

Odpowiedni identyfikator trasy dla harmonogramu.

Identyfikatory alertów
data.entry.schedules.alertIds array of string

Tablica odpowiednich identyfikatorów alertów

Direction
data.entry.schedules.directions array of object

Tablica zaplanowanych danych pogrupowanych według kierunku.

Identyfikator kierunku
data.entry.schedules.directions.directionId string

Identyfikacja kierunku.

Groups
data.entry.schedules.directions.groups object

Łączenie szczegółów zatrzymania docelowego i harmonogramu.

Czas zatrzymania
data.entry.schedules.directions.stopTimes array of object

Tablica czasów zatrzymania i powiązanych szczegółów w harmonogramie.

Czas zatrzymania
data.entry.schedules.directions.stopTimes object

Szczegóły czasu zatrzymania w harmonogramie.

Przekroczono limit
data.limitExceeded LimitExceededResponse

Wskazuje, czy odpowiedź zawiera więcej elementów niż zdefiniowany limit.

References
data.references ReferencesResponse

Istotne szczegóły referencyjne.

Pobieranie przystanków dla lokalizacji

Zatrzymanie listy dla wybranej lokalizacji lub wszystkie przystanki

Parametry

Nazwa Klucz Wymagane Typ Opis
Szerokość
lat float

Szerokość geograficzna żądanej lokalizacji, na przykład "47.497313". Jeśli jest pusty, zwraca wszystkie zatrzymane.

Długość
lon float

Długość geograficzna żądanej lokalizacji, na przykład "19.064639". Jeśli jest pusty, zwraca wszystkie zatrzymane.

Szerokość geograficzna
latSpan float

Szerokość geograficzna żądanej lokalizacji (lat +/- latSpan), na przykład "0.01336".

Długość geograficzna
lonSpan float

Długość geograficzna żądanej lokalizacji (lon +/- lonSpan), na przykład "0,0321".

Promień
radius integer

Jeśli brakuje latSpan lub lonSpan, obszar wyszukiwania jest definiowany przez dodanie promienia (metrów) do lokalizacji.

Minimalne wyniki
minResult integer

Minimalna liczba zwracanych elementów.

Dołącz odwołania
includeReferences string

Zdefiniuj typ odwołań.

Zwraca

Nazwa Ścieżka Typ Opis
Bieżący czas
currentTime TimeResponse

Bieżący czas serwera w milisekundach.

wersja
version VersionResponse

Wersja interfejsu API.

Status
status StatusResponse

Stan odpowiedzi.

Code
code CodeResponse

Kod stanu odpowiedzi.

Tekst
text TextResponse

Szczegółowy tekst odpowiedzi związany z kodem stanu.

list
data.list array of object
identyfikator
data.list.id string

Unikatowa identyfikacja zatrzymania.

Wierzchołek
data.list.vertex string

Identyfikacja przystanku przez planistę podróży.

Szerokość
data.list.lat double

Szerokość geograficzna zatrzymania.

Długość
data.list.lon double

Długość geograficzna zatrzymania.

Name
data.list.name string

Nazwa zatrzymania.

Code
data.list.code string

Kod zatrzymania.

Direction
data.list.direction string

Kierunek zatrzymania, na przykład "-47".

Kod platformy
data.list.platformCode string

Kod platformy zatrzymania.

Description
data.list.description string

Opis zatrzymania.

Typ lokalizacji
data.list.locationType integer

Typ lokalizacji zatrzymania.

Podtyp lokalizacji
data.list.locationSubType string

Podtyp lokalizacji zatrzymania.

Identyfikator stacji nadrzędnej
data.list.parentStationId string

Unikatowy identyfikator stacji nadrzędnej.

Wejście na wózki inwalidzkie
data.list.wheelchairBoarding boolean

Czy przystanek dla wózków inwalidzkich jest dostępny?

Identyfikatory tras
data.list.routeIds array of string

Tablica wszystkich tras zawierających zatrzymanie.

Identyfikatory alertów
data.list.alertIds array of string

Tablica aktywnych identyfikatorów alertów związanych z zatrzymaniem.

Przekroczono limit
data.limitExceeded LimitExceededResponse

Wskazuje, czy odpowiedź zawiera więcej elementów niż zdefiniowany limit.

References
data.references ReferencesResponse

Istotne szczegóły referencyjne.

Pobierz pojazdy do zatrzymania

Lista pojazdów, które znajdują się na trasie zawierającej wybrany przystanek

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator zatrzymania
stopId True string

Zatrzymaj identyfikator, aby wysyłać zapytania dotyczące danych, takich jak "BKK_F01227".

W przypadku modyfikacji od (unix)
ifModifiedSince integer

Zwraca dane, które zostały zmodyfikowane od sygnatury czasowej systemu UNIX.

Dołącz odwołania
includeReferences string

Zdefiniuj typ odwołań.

Zwraca

Nazwa Ścieżka Typ Opis
Bieżący czas
currentTime TimeResponse

Bieżący czas serwera w milisekundach.

wersja
version VersionResponse

Wersja interfejsu API.

Status
status StatusResponse

Stan odpowiedzi.

Code
code CodeResponse

Kod stanu odpowiedzi.

Tekst
text TextResponse

Szczegółowy tekst odpowiedzi związany z kodem stanu.

list
data.list array of object
Identyfikator pojazdu
data.list.vehicleId string

Identyfikacja pojazdu.

Identyfikator zatrzymania
data.list.stopId string

Identyfikacja zatrzymania.

Sekwencja zatrzymywania
data.list.stopSequence integer

Sekwencja bieżącego zatrzymania na trasie pojazdu.

Identyfikator trasy
data.list.routeId string

Identyfikacja trasy.

Łożysko
data.list.bearing float

Łożysko pojazdu.

Szerokość
data.list.location.lat float

Informacje o szerokości geograficznej pojazdu.

Długość
data.list.location.lon float

Informacje o długości geograficznej pojazdu

Rejestracyjnej
data.list.licensePlate string

Tablica rejestracyjna pojazdu.

Etykieta
data.list.label string

Informacje o etykiecie pojazdu.

Odchylenie
data.list.deviated boolean

Prawda, jeśli pojazd odchylił się od trasy.

Czas ostatniej aktualizacji
data.list.lastUpdateTime integer

Sygnatura czasowa (unix) ostatniej dostępnej danych w czasie rzeczywistym dla pojazdu.

Status
data.list.status string

Stan pojazdu, taki jak INCOMING_AT.

Procent odległości zatrzymania
data.list.stopDistancePercent integer

Gdzie jest pojazd między 2 przystankami, w procentach.

Dostępne dla wózków inwalidzkich
data.list.wheelchairAccessible boolean

Prawda, jeśli pojazd jest dostępny dla wózka inwalidzkiego.

Pojemność
data.list.capacity object

Szczegóły pojemności pojazdu.

Obłożenie
data.list.occupancy object

Szczegóły zajętości pojazdu.

Identyfikator podróży
data.list.tripId string

Unikatowa identyfikacja podróży.

Wierzchołek
data.list.vertex string

Unikatowa identyfikacja podróży na planistę podróży

Przekroczono limit
data.limitExceeded LimitExceededResponse

Wskazuje, czy odpowiedź zawiera więcej elementów niż zdefiniowany limit.

References
data.references ReferencesResponse

Istotne szczegóły referencyjne.

Uzyskaj przyjazdy i wyjazdy na przystanek

Wyświetlanie listy przylotów i odlotów dla wybranego przystanku

Parametry

Nazwa Klucz Wymagane Typ Opis
Minuty przed
minutesBefore integer

Początek odpowiedniego interwału czasu zapytania, odejmowany od parametru "time".

Minuty po
minutesAfter string

Koniec odpowiedniego interwału czasu zapytania dodanego do parametru "time".

Identyfikator zatrzymania
stopId True string

Zatrzymaj identyfikator, aby wysyłać zapytania dotyczące danych, takich jak "BKK_F01227".

Uwzględnij identyfikator trasy
includeRouteId string

Lista identyfikatorów tras rozdzielonych przecinkami w celu filtrowania wyników.

Time
time integer

Sygnatura czasowa (w sekundach) używana dla zapytania, domyślnie ustawiona na czas serwera.

Tylko wyjazdy
onlyDepartures boolean

Wskazuje, czy wyniki są zwracane z przylotami lub bez niego.

Ograniczenie
limit integer

Maksymalna liczba zwróconych wyników, domyślnie ustawiona na 60.

Szerokość
lat float

Informacje o szerokości geograficznej lokalizacji.

Długość
lon float

Informacje o długości geograficznej lokalizacji.

Promień
radius integer

Promień lokalizacji wokół współrzędnych lat i lon.

Query
query string

Wyrażenie zapytania używane do filtrowania wyników.

Minimalne wyniki
minResult integer

Minimalna liczba zwracanych elementów.

Dołącz odwołania
includeReferences string

Zdefiniuj typ odwołań.

Zwraca

Nazwa Ścieżka Typ Opis
Bieżący czas
currentTime TimeResponse

Bieżący czas serwera w milisekundach.

wersja
version VersionResponse

Wersja interfejsu API.

Status
status StatusResponse

Stan odpowiedzi.

Code
code CodeResponse

Kod stanu odpowiedzi.

Tekst
text TextResponse

Szczegółowy tekst odpowiedzi związany z kodem stanu.

Przekroczono limit
data.limitExceeded LimitExceededResponse

Wskazuje, czy odpowiedź zawiera więcej elementów niż zdefiniowany limit.

Identyfikator zatrzymania
data.entry.stopId string

Identyfikacja zatrzymania.

Identyfikatory tras
data.entry.routeIds array of string

Tablica identyfikatorów tras należących do zatrzymania.

Identyfikatory alertów
data.entry.alertIds array of string

Tablica identyfikatorów alertów należących do zatrzymania.

Identyfikatory przystanków znajdujących się w pobliżu
data.entry.nearbyStopIds array of string

Tablica pobliskich identyfikatorów zatrzymania.

Czas zatrzymania
data.entry.stopTimes array of object

Harmonogram zatrzymania odpowiedni dla danego zatrzymania.

Identyfikator zatrzymania
data.entry.stopTimes.stopId string

Identyfikacja zatrzymania.

Zatrzymaj nagłówek
data.entry.stopTimes.stopHeadsign string

Wskazane miejsce docelowe w zatrzymaniu.

Godzina przyjazdu
data.entry.stopTimes.arrivalTime integer

Planowany czas przybycia w sekundach epoki.

Godzina odlotu
data.entry.stopTimes.departureTime integer

Planowany czas odlotu w sekundach epoki

Przewidywany przyjazd
data.entry.stopTimes.predictedArrivalTime integer

Przewidywany czas przyjazdu w sekundach epoki, jeśli podróż zawiera dane czasu rzeczywistego.

Przewidywane odejście
data.entry.stopTimes.predictedDepartureTime integer

Przewidywany czas odlotu w sekundach epoki, jeśli podróż zawiera dane czasu rzeczywistego.

Niepewny
data.entry.stopTimes.uncertain boolean

Wskazuje, czy dane czasu rzeczywistego podróży są niepewne.

Identyfikator podróży
data.entry.stopTimes.tripId string

Odpowiedni identyfikator podróży dla tego wpisu.

Data usługi
data.entry.stopTimes.serviceDate string

Data usługi podróży wyrażona w formacie RRRRDD.

Dostępny dla wózków inwalidzkich
data.entry.stopTimes.wheelchairAccessible boolean

Wskazuje, czy podróż jest dostępna dla wózków inwalidzkich.

Może wymagać rezerwacji
data.entry.stopTimes.mayRequireBooking boolean

Wskazanie, czy co najmniej jeden z następnych przystanków podróży wymaga rezerwacji.

Identyfikatory alertów
data.entry.stopTimes.alertIds array of string

Odpowiednie identyfikatory alertów dla zatrzymania.

References
data.references ReferencesResponse

Istotne szczegóły referencyjne.

Uzyskaj stacje wypożyczania rowerów

Uzyskaj informacje o stacjach wypożyczania rowerów

Parametry

Nazwa Klucz Wymagane Typ Opis
Dołącz odwołania
includeReferences string

Zdefiniuj typ odwołań.

Zwraca

Nazwa Ścieżka Typ Opis
Bieżący czas
currentTime TimeResponse

Bieżący czas serwera w milisekundach.

wersja
version VersionResponse

Wersja interfejsu API.

Status
status StatusResponse

Stan odpowiedzi.

Code
code CodeResponse

Kod stanu odpowiedzi.

Tekst
text TextResponse

Szczegółowy tekst odpowiedzi związany z kodem stanu.

list
data.list array of object
Identyfikator stacji rowerowej
data.list.id string

Identyfikator stacji rowerowej.

Szerokość
data.list.lat double

Informacje o szerokości geograficznej stacji.

Długość
data.list.lon double

Informacje o długości geograficznej stacji

Name
data.list.name string

Nazwa stacji rowerowej.

Code
data.list.code string

Kod stacji rowerowej.

Typ
data.list.type string

Typ stacji rowerowej.

Rowery
data.list.bikes integer

Liczba dostępnych rowerów na stacji.

Przekroczono limit
data.limitExceeded LimitExceededResponse

Wskazuje, czy odpowiedź zawiera więcej elementów niż zdefiniowany limit.

References
data.references ReferencesResponse

Istotne szczegóły referencyjne.

Uzyskiwanie odwołań

Pobieranie odwołań opartych na identyfikatorach.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator agencji
agencyId string

Identyfikator agencji, np. "BKK".

Identyfikator alertu
alertId string

Identyfikator alertu.

Identyfikator rpute
routeId string

Identyfikator trasy.

Identyfikator zatrzymania
stopId string

Identyfikator zatrzymania, np. "BKK_F01227".

Dołącz odwołania
includeReferences string

Zdefiniuj typ odwołań.

Zwraca

Nazwa Ścieżka Typ Opis
Bieżący czas
currentTime TimeResponse

Bieżący czas serwera w milisekundach.

wersja
version VersionResponse

Wersja interfejsu API.

Status
status StatusResponse

Stan odpowiedzi.

Code
code CodeResponse

Kod stanu odpowiedzi.

Tekst
text TextResponse

Szczegółowy tekst odpowiedzi związany z kodem stanu.

Identyfikatory agencji.
data.entry.errors.agencyIds array of string

Tablica identyfikatorów agencji, których rozwiązanie nie powiodło się.

Identyfikatory alertów
data.entry.errors.alertIds array of string

Tablica identyfikatorów alertów, których rozwiązanie nie powiodło się.

Identyfikatory tras
data.entry.errors.routeIds array of string

Tablica identyfikatorów agencji, których rozwiązanie nie powiodło się.

Zatrzymywanie identyfikatorów
data.entry.errors.stopIds array of string

Tablica identyfikatorów zatrzymania, których rozwiązanie nie powiodło się.

Przekroczono limit
data.limitExceeded LimitExceededResponse

Wskazuje, czy odpowiedź zawiera więcej elementów niż zdefiniowany limit.

References
data.references ReferencesResponse

Istotne szczegóły referencyjne.

Wyszukaj alerty

Wykaz aktywnych zakłóceń odpowiadających kryteriom wyszukiwania

Parametry

Nazwa Klucz Wymagane Typ Opis
Query
query string

Ciąg zapytania dopasowany do tytułu zakłóceń, opisu lub identyfikacji.

Start
start integer

Początek interwału czasu (w sekundach epoki) dla wyszukiwania.

Koniec
end integer

Koniec interwału czasu (w sekundach epoki) dla wyszukiwania.

Minimalne wyniki
minResult integer

Minimalna liczba zwracanych elementów.

Dołącz odwołania
includeReferences string

Zdefiniuj typ odwołań.

Zwraca

Nazwa Ścieżka Typ Opis
Bieżący czas
currentTime TimeResponse

Bieżący czas serwera w milisekundach.

wersja
version VersionResponse

Wersja interfejsu API.

Status
status StatusResponse

Stan odpowiedzi.

Code
code CodeResponse

Kod stanu odpowiedzi.

Tekst
text TextResponse

Szczegółowy tekst odpowiedzi związany z kodem stanu.

Przekroczono limit
data.limitExceeded LimitExceededResponse

Wskazuje, czy odpowiedź zawiera więcej elementów niż zdefiniowany limit.

Zatrzymywanie identyfikatorów
data.entry.stopIds array of string

Tablica znalezionych odpowiednich identyfikatorów zatrzymania.

Identyfikatory tras
data.entry.routeIds array of string

Tablica znalezionych odpowiednich identyfikatorów tras.

Identyfikatory alertów
data.entry.alertIds array of string

Tablica znalezionych odpowiednich identyfikatorów alertów.

References
data.references ReferencesResponse

Istotne szczegóły referencyjne.

Definicje

TimeResponse

Bieżący czas serwera w milisekundach.

Bieżący czas serwera w milisekundach.

Bieżący czas
integer

VersionResponse

Wersja interfejsu API.

Wersja interfejsu API.

wersja
integer

StatusResponse

Stan odpowiedzi.

Stan odpowiedzi.

Status
string

CodeResponse

Kod stanu odpowiedzi.

Kod stanu odpowiedzi.

Code
integer

TextResponse

Szczegółowy tekst odpowiedzi związany z kodem stanu.

Szczegółowy tekst odpowiedzi związany z kodem stanu.

Tekst
string

LimitExceededResponse

Wskazuje, czy odpowiedź zawiera więcej elementów niż zdefiniowany limit.

Wskazuje, czy odpowiedź zawiera więcej elementów niż zdefiniowany limit.

Przekroczono limit
boolean

OdwołaniaResponse

Istotne szczegóły referencyjne.

Nazwa Ścieżka Typ Opis
Agencje
agencies object
routes
routes object
Zatrzymuje
stops object
TRIPS
trips object
alerts
alerts object