BKK Futar （獨立發行商）（預覽版）

從 BKK FUTAR 系統（布達佩斯的公共交通）獲取和搜索有關行程、車輛、站點等的計劃和實時信息！

此連接器適用於以下產品和區域：

服務	Class	Regions
副駕駛工作室	進階	除下列區域外的所有 Power Automate 區域： - 美國政府（GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部（DoD）
邏輯應用程式	標準	所有 Logic Apps 區域，但下列區域除外： - Azure Government 區域 - Azure 中國區域 - 美國國防部（DoD）
Power Apps	進階	除下列區域外的所有 Power Apps 區域： - 美國政府（GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部（DoD）
Power Automate（自動化服務）	進階	除下列區域外的所有 Power Automate 區域： - 美國政府（GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部（DoD）

連絡人
名稱	Fördős András
Email	fordosa90+ipc_bkk@gmail.com

連接器中繼資料
Publisher	Fördős András
網站	https://opendata.bkk.hu/data-sources
隱私策略	https://bkk.hu/en/about-bkk/data-management-information/
類別	資料

正在建立連線

連接器支援下列驗證類型：


預設值	建立連線的參數。	所有區域	不可共享

預設

適用：所有地區

建立連線的參數。

這不是可共用的連線。如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。

名稱	類型	Description	為必填項目
API 金鑰	securestring	此 API 的 API 金鑰	對

節流限制

名稱	呼叫	續約期間
每個連線的 API 呼叫	100	60 秒

動作

取得參考資料	擷取以 ID 為基礎的參考。
取得自行車租賃站	獲取有關自行車租賃站的信息
搜尋警示	列出與搜尋條件相對應的主動干擾
獲取位置的停靠點	列出所選位置的停靠點或所有停靠點
獲取停車時間表	列出所選站點的時間表
獲取停車車輛	列出包含所選停靠點的路線上的車輛
獲取到達和出發停靠站	列出所選站點的到達和出發

取得參考資料

作業識別碼：: GetReferences

擷取以 ID 為基礎的參考。

參數

名稱	機碼	類型	Description
代理機構 ID	agencyId	string	代理機構的 ID，例如：“BKK”。
警示識別碼	alertId	string	警示的識別碼。
Rpute ID	routeId	string	路由的 ID。
停止識別碼	stopId	string	停靠點的 ID，例如：「BKK_F01227」。
包含參考	includeReferences	string	定義參照的類型。

傳回

名稱	路徑	類型	Description
當前時間	currentTime	TimeResponse	目前的伺服器時間（以毫秒為單位）。
版本	version	VersionResponse	API 的版本。
地位	status	StatusResponse	回應狀態。
Code	code	CodeResponse	回應狀態碼。
文字	text	TextResponse	與狀態碼相關的詳細回應文字。
代理機構 ID。	data.entry.errors.agencyIds	array of string	解決不成功的機構 ID 陣列。
警示識別碼	data.entry.errors.alertIds	array of string	解決失敗的警示識別碼陣列。
路由 ID	data.entry.errors.routeIds	array of string	解決不成功的機構 ID 陣列。
停止標識符	data.entry.errors.stopIds	array of string	解析失敗的停止 ID 陣列。
超出限制	data.limitExceeded	LimitExceededResponse	指示，回應是否包含超過定義限制的元素。
參考資料	data.references	ReferencesResponse	相關參考資料。

取得自行車租賃站

作業識別碼：: GetBicycleRentalStations

獲取有關自行車租賃站的信息

參數

名稱	機碼	必要	類型	Description
包含參考	includeReferences		string	定義參照的類型。

傳回

名稱	路徑	類型	Description
當前時間	currentTime	TimeResponse	目前的伺服器時間（以毫秒為單位）。
版本	version	VersionResponse	API 的版本。
地位	status	StatusResponse	回應狀態。
Code	code	CodeResponse	回應狀態碼。
文字	text	TextResponse	與狀態碼相關的詳細回應文字。
list	data.list	array of object
自行車站 ID	data.list.id	string	自行車站 ID。
緯度	data.list.lat	double	站點的緯度信息。
經度	data.list.lon	double	車站經度信息
名稱	data.list.name	string	自行車站的名稱。
Code	data.list.code	string	自行車站的代碼。
類型	data.list.type	string	自行車站的類型。
自行車	data.list.bikes	integer	車站可用自行車的數量。
超出限制	data.limitExceeded	LimitExceededResponse	指示，回應是否包含超過定義限制的元素。
參考資料	data.references	ReferencesResponse	相關參考資料。

搜尋警示

作業識別碼：: SearchAlerts

列出與搜尋條件相對應的主動干擾

參數

名稱	機碼	類型	Description
Query	query	string	與干擾標題、描述或識別相符的查詢字串。
開始	start	integer	搜尋的時間間隔（epoch 秒）的開始。
結束	end	integer	搜尋的時間間隔結束（紀元秒）。
最低結果	minResult	integer	傳回的最小元素數目。
包含參考	includeReferences	string	定義參照的類型。

傳回

名稱	路徑	類型	Description
當前時間	currentTime	TimeResponse	目前的伺服器時間（以毫秒為單位）。
版本	version	VersionResponse	API 的版本。
地位	status	StatusResponse	回應狀態。
Code	code	CodeResponse	回應狀態碼。
文字	text	TextResponse	與狀態碼相關的詳細回應文字。
超出限制	data.limitExceeded	LimitExceededResponse	指示，回應是否包含超過定義限制的元素。
停止標識符	data.entry.stopIds	array of string	找到的相關停止ID陣列。
路由 ID	data.entry.routeIds	array of string	找到的相關路由識別碼陣列。
警示識別碼	data.entry.alertIds	array of string	找到的相關警示識別碼陣列。
參考資料	data.references	ReferencesResponse	相關參考資料。

獲取位置的停靠點

作業識別碼：: GetStopsForLocation

列出所選位置的停靠點或所有停靠點

參數

名稱	機碼	類型	Description
緯度	lat	float	要求位置的緯度，例如 '47.497313'。如果為空，則傳回所有停靠點。
經度	lon	float	請求位置的經度，例如 '19.064639'。如果為空，則傳回所有停靠點。
緯度跨度	latSpan	float	要求位置的緯度範圍（緯度 +/- latSpan），例如 '0.01336'。
經度跨度	lonSpan	float	要求位置的經度跨度（lon +/- lonSpan），例如 '0.0321'。
Radius	radius	integer	如果缺少 latSpan 或 lonSpan，則搜尋區域是透過將半徑（公尺）新增至位置來定義。
最低結果	minResult	integer	傳回的最小元素數目。
包含參考	includeReferences	string	定義參照的類型。

傳回

名稱	路徑	類型	Description
當前時間	currentTime	TimeResponse	目前的伺服器時間（以毫秒為單位）。
版本	version	VersionResponse	API 的版本。
地位	status	StatusResponse	回應狀態。
Code	code	CodeResponse	回應狀態碼。
文字	text	TextResponse	與狀態碼相關的詳細回應文字。
list	data.list	array of object
ID	data.list.id	string	站點的唯一標識。
最高點	data.list.vertex	string	站點的旅程規劃器識別。
緯度	data.list.lat	double	停止的緯度。
經度	data.list.lon	double	停靠點的經度。
名稱	data.list.name	string	停靠點的名稱。
Code	data.list.code	string	停止代碼。
方向	data.list.direction	string	停止的方向，例如“-47”。
平台程式碼	data.list.platformCode	string	站台代碼。
Description	data.list.description	string	停靠點的描述。
位置類型	data.list.locationType	integer	停靠點的位置類型。
位置子類型	data.list.locationSubType	string	停靠點的位置子類型。
父站 ID	data.list.parentStationId	string	父站的唯一 ID。
輪椅寄宿	data.list.wheelchairBoarding	boolean	停靠站適合輪椅使用者嗎？
路由 ID	data.list.routeIds	array of string	包含停靠點的所有路線的陣列。
警示識別碼	data.list.alertIds	array of string	與停止相關的作用中警示識別碼陣列。
超出限制	data.limitExceeded	LimitExceededResponse	指示，回應是否包含超過定義限制的元素。
參考資料	data.references	ReferencesResponse	相關參考資料。

獲取停車時間表

作業識別碼：: GetScheduleForStop

列出所選站點的時間表

參數

名稱	機碼	必要	類型	Description
停止識別碼	stopId	True	string	停止 ID 以查詢其資料，例如 'BKK_F01227'。
Date	date		string	YYYYMMDD 格式的請求日期（例如 20230131）預設為今天。
僅限出發	onlyDepartures		boolean	指出是否傳回有或沒有到達的結果。
包含參考	includeReferences		string	定義參照的類型。

傳回

名稱	路徑	類型	Description
當前時間	currentTime	TimeResponse	目前的伺服器時間（以毫秒為單位）。
版本	version	VersionResponse	API 的版本。
地位	status	StatusResponse	回應狀態。
Code	code	CodeResponse	回應狀態碼。
文字	text	TextResponse	與狀態碼相關的詳細回應文字。
停止識別碼	data.entry.stopId	string	所要求停靠點的唯一 ID。
Date	data.entry.date	string	YYYYMMDD 格式所要求排程的日期，例如 20230130。
路由 ID	data.entry.routeIds	array of string	排程的相關路由 ID 陣列。
附近的站點 ID	data.entry.nearbyStopIds	array of string	附近停靠點 ID 的陣列。
警示識別碼	data.entry.alertIds	array of string	停止的相關警示識別碼陣列
排程	data.entry.schedules	array of object	與停靠點相關的排程陣列。
路由 ID	data.entry.schedules.routeId	string	排程的相關路線 ID。
警示識別碼	data.entry.schedules.alertIds	array of string	相關警示識別碼陣列
方向	data.entry.schedules.directions	array of object	依方向分組的排程資料陣列。
方向 ID	data.entry.schedules.directions.directionId	string	方向的識別。
Groups	data.entry.schedules.directions.groups	object	結合目標停靠點和排程詳細資料。
停車時間	data.entry.schedules.directions.stopTimes	array of object	時間表中的停止時間和相關詳細資訊陣列。
停止時間	data.entry.schedules.directions.stopTimes	object	計劃內停止時間的詳細信息。
超出限制	data.limitExceeded	LimitExceededResponse	指示，回應是否包含超過定義限制的元素。
參考資料	data.references	ReferencesResponse	相關參考資料。

獲取停車車輛

作業識別碼：: GetVehiclesForStop

列出包含所選停靠點的路線上的車輛

參數

名稱	機碼	必要	類型	Description
停止識別碼	stopId	True	string	停止 ID 以查詢其資料，例如 'BKK_F01227'。
如果修改後（unix）	ifModifiedSince		integer	傳回自 UNIX 時間戳記以來已修改的資料。
包含參考	includeReferences		string	定義參照的類型。

傳回

名稱	路徑	類型	Description
當前時間	currentTime	TimeResponse	目前的伺服器時間（以毫秒為單位）。
版本	version	VersionResponse	API 的版本。
地位	status	StatusResponse	回應狀態。
Code	code	CodeResponse	回應狀態碼。
文字	text	TextResponse	與狀態碼相關的詳細回應文字。
list	data.list	array of object
車輛 ID	data.list.vehicleId	string	車輛的識別。
停止識別碼	data.list.stopId	string	站點的識別。
停止順序	data.list.stopSequence	integer	車輛路線上當前停靠點的順序。
路由 ID	data.list.routeId	string	路線的識別。
軸承	data.list.bearing	float	車輛的軸承。
緯度	data.list.location.lat	float	車輛的緯度資訊。
經度	data.list.location.lon	float	車輛經度信息
牌照	data.list.licensePlate	string	車輛的車牌。
標籤	data.list.label	string	車輛的標籤資訊。
偏離	data.list.deviated	boolean	如果車輛偏離路線，則為該。
上次更新時間	data.list.lastUpdateTime	integer	車輛最後可用即時資料的時間戳記（unix）。
地位	data.list.status	string	車輛的狀態，例如INCOMING_AT。
停止距離百分比	data.list.stopDistancePercent	integer	2 站之間的車輛在哪裡，以百分比表示。
無障礙通道	data.list.wheelchairAccessible	boolean	沒錯，如果車輛可供輪椅通行。
容量	data.list.capacity	object	車輛的容量詳細資料。
入住率	data.list.occupancy	object	車輛的佔用詳細信息。
行程 ID	data.list.tripId	string	旅行的唯一標識。
最高點	data.list.vertex	string	旅程規劃者旅行的唯一標識
超出限制	data.limitExceeded	LimitExceededResponse	指示，回應是否包含超過定義限制的元素。
參考資料	data.references	ReferencesResponse	相關參考資料。

獲取到達和出發停靠站

作業識別碼：: GetArrivalsAndDeparturesForStop

列出所選站點的到達和出發

參數

名稱	機碼	必要	類型	Description
幾分鐘前	minutesBefore		integer	查詢相關時間間隔的開始，從「時間」參數中減去。
幾分鐘後	minutesAfter		string	查詢相關時間間隔的結束，新增至 'time' 參數。
停止識別碼	stopId	True	string	停止 ID 以查詢其資料，例如 'BKK_F01227'。
包括路由 ID	includeRouteId		string	以逗號分隔的路由 ID 清單，以篩選結果。
Time	time		integer	用於查詢的時間戳記（紀元秒），預設為伺服器時間。
僅限出發	onlyDepartures		boolean	指出是否傳回有或沒有到達的結果。
限制	limit		integer	傳回的結果數目上限，預設為 60。
緯度	lat		float	位置的緯度資訊。
經度	lon		float	位置的經度資訊。
Radius	radius		integer	緯度和經度坐標周圍的位置半徑。
Query	query		string	用來篩選結果的查詢運算式。
最低結果	minResult		integer	傳回的最小元素數目。
包含參考	includeReferences		string	定義參照的類型。

傳回

名稱	路徑	類型	Description
當前時間	currentTime	TimeResponse	目前的伺服器時間（以毫秒為單位）。
版本	version	VersionResponse	API 的版本。
地位	status	StatusResponse	回應狀態。
Code	code	CodeResponse	回應狀態碼。
文字	text	TextResponse	與狀態碼相關的詳細回應文字。
超出限制	data.limitExceeded	LimitExceededResponse	指示，回應是否包含超過定義限制的元素。
停止識別碼	data.entry.stopId	string	停止的識別。
路由 ID	data.entry.routeIds	array of string	屬於停靠點的路線 ID 陣列。
警示識別碼	data.entry.alertIds	array of string	屬於停止的警示識別碼陣列。
附近的站點 ID	data.entry.nearbyStopIds	array of string	附近停靠點 ID 的陣列。
停止時間	data.entry.stopTimes	array of object	與給定停靠點相關的停靠排程。
停止識別碼	data.entry.stopTimes.stopId	string	停止的識別。
停止頭標	data.entry.stopTimes.stopHeadsign	string	停靠點中指示的目的地。
抵達時間	data.entry.stopTimes.arrivalTime	integer	計劃到達時間（以紀元秒為單位）。
出發時間	data.entry.stopTimes.departureTime	integer	計劃出發時間（以紀元秒為單位）
預計到來	data.entry.stopTimes.predictedArrivalTime	integer	預測的抵達時間（以紀元秒為單位）（如果行程有即時資料）。
預測離職	data.entry.stopTimes.predictedDepartureTime	integer	預測的出發時間（以紀元秒為單位）（如果行程有即時資料）。
㪎	data.entry.stopTimes.uncertain	boolean	指示，行程的實時數據是否不確定。
行程 ID	data.entry.stopTimes.tripId	string	此項目的相關行程 ID。
服務日期	data.entry.stopTimes.serviceDate	string	旅行的服務日期，以 YYYYMMDD 格式表示。
無障礙通道	data.entry.stopTimes.wheelchairAccessible	boolean	指示，行程是否適合輪椅使用者。
可能需要預訂	data.entry.stopTimes.mayRequireBooking	boolean	指示，行程的下一站是否至少需要預訂。
警示識別碼	data.entry.stopTimes.alertIds	array of string	停止的相關警示 ID。
參考資料	data.references	ReferencesResponse	相關參考資料。

定義

時間回應

目前的伺服器時間（以毫秒為單位）。

當前時間: integer

版本回應

API 的版本。

版本: integer

狀態回應

回應狀態。

地位: string

程式碼回應

回應狀態碼。

Code: integer

文字回應

與狀態碼相關的詳細回應文字。

文字: string

LimitExceeded回應

指示，回應是否包含超過定義限制的元素。

超出限制: boolean

參考回應

相關參考資料。

名稱	路徑	類型
代理機構	agencies	object
路線	routes	object
停靠站	stops	object
行程	trips	object
alerts	alerts	object

共用方式為

BKK Futar （獨立發行商） （預覽版）