{ "openapi": "3.0.1", "info": { "title": "公共運輸-公車", "description": "本平臺提供涵蓋全國尺度之交通旅運資料服務API,歡迎各產政學單位介接使用。\n
利用本平臺開放資料進行各項應用服務開發時,請考量不同特性使用者(如:性別/身心障礙/老幼等)的需求,並歡迎回饋寶貴意見。\n
計費方式:\n
計次:1,500次/1點\n
計量:150MB/1點\n---\n##### API使用說明與注意事項:\n1. 如您尚未註冊平臺會員帳號,或未以帳號登入,您將僅能以「訪客模式」使用平臺服務,包含:限以瀏覽器存取,限使用`【基礎服務】`,且限制每個呼叫來源端IP每日存取至多20次。。\n2. 如您已註冊平臺會員帳號,請務必確保在存取服務(包含瀏覽器、程式呼叫API)時帶入您的API金鑰,方能以「會員模式」使用完整平臺服務,包含平臺各類資料服務,如`【基礎服務】`、`【進階服務】`、`【加值服務】`、`【歷史服務】`、`【圖資服務】`、`【第三方服務】`等。\n3. 建議您立即[註冊平臺會員帳號](/register),依您用量需求訂閱服務方案,並於[【會員中心->資料服務->API金鑰】](/user/dataservice/key)取得API金鑰(即Client Id和Client Secret資訊)。\n4. 會員訂閱服務方案之級別不同,將決定其API金鑰之存取頻率有不同限制,各個方案的存取頻率限制說明請參考[訂閱收費](/pricing)。\n5. 以瀏覽器帶入API金鑰之操作方式:請點選Swagger UI上的Authorize按鈕,依指示填入Client Id和Client Secret資訊並進行驗證,驗證完成後可開始於Swagger UI使用API。\n6. 以程式呼叫API帶入API金鑰之操作方式:請參考[範例程式](https://github.com/tdxmotc/SampleCode)。\n7. 不論您是以瀏覽器或是以程式呼叫API,所有服務存取行為均將被記錄並定期檢視,以確保系統資源使用的合理分配與避免遭受濫用。\n\nAPI OAS文本 :[請點我](https://tdx.transportdata.tw/webapi/File/Swagger/V3/2998e851-81d0-40f5-b26d-77e2f5ac4118)", "version": "v2" }, "servers": [ { "url": "https://tdx.transportdata.tw/api/basic" } ], "paths": { "/v2/Bus/RealTimeByFrequency/Streaming/City/{City}": { "get": { "tags": [ "CityBus" ], "summary": "取得指定[縣市]的公車動態定時資料(A1)[逐筆更新]", "description": "### 市區公車之定時資料(A1) ###\n- [逐筆更新]與[批次更新]之差異請詳見運輸資料使用指引([連結](https://motc-ptx.gitbook.io/tdx-zi-liao-shi-yong-kui-hua-bao-dian/data_notice/public_transportation_data/bus_dynamic_data))", "operationId": "CityBusApi_RealTimeByFrequency_UDP_2046", "parameters": [ { "name": "City", "in": "path", "description": "欲查詢縣市", "required": true, "schema": { "title": "String", "enum": [ "Hsinchu", "HsinchuCounty", "MiaoliCounty", "ChanghuaCounty", "NantouCounty", "YunlinCounty", "ChiayiCounty", "Chiayi", "PingtungCounty", "YilanCounty", "HualienCounty", "TaitungCounty", "PenghuCounty", "Keelung" ], "type": "string", "xml": { } } }, { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA1Data" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA1Data" }, "xml": { "name": "ArrayOfBusA1Data", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/RealTimeByFrequency/Streaming/City/{City}/{RouteName}": { "get": { "tags": [ "CityBus" ], "summary": "取得指定[縣市],[路線名稱]的公車動態定時資料(A1)[逐筆更新]", "description": "### 市區公車之定時資料(A1) ###\n- [逐筆更新]與[批次更新]之差異請詳見運輸資料使用指引([連結](https://motc-ptx.gitbook.io/tdx-zi-liao-shi-yong-kui-hua-bao-dian/data_notice/public_transportation_data/bus_dynamic_data))", "operationId": "CityBusApi_RealTimeByFrequency_UDP_2046_1", "parameters": [ { "name": "City", "in": "path", "description": "欲查詢縣市", "required": true, "schema": { "title": "String", "enum": [ "Hsinchu", "HsinchuCounty", "MiaoliCounty", "ChanghuaCounty", "NantouCounty", "YunlinCounty", "ChiayiCounty", "Chiayi", "PingtungCounty", "YilanCounty", "HualienCounty", "TaitungCounty", "PenghuCounty", "Keelung" ], "type": "string", "xml": { } } }, { "name": "RouteName", "in": "path", "description": "繁體中文路線名稱,如'307'", "required": true, "schema": { "title": "String", "type": "string", "xml": { } } }, { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA1Data" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA1Data" }, "xml": { "name": "ArrayOfBusA1Data", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/RealTimeNearStop/Streaming/City/{City}": { "get": { "tags": [ "CityBus" ], "summary": "取得指定[縣市]的公車動態定點資料(A2)[逐筆更新]", "description": "### 市區公車之定點資料(A2) ###\n- [逐筆更新]與[批次更新]之差異請詳見運輸資料使用指引([連結](https://motc-ptx.gitbook.io/tdx-zi-liao-shi-yong-kui-hua-bao-dian/data_notice/public_transportation_data/bus_dynamic_data))", "operationId": "CityBusApi_RealTimeNearStop_UDP_2047", "parameters": [ { "name": "City", "in": "path", "description": "欲查詢縣市", "required": true, "schema": { "title": "String", "enum": [ "Hsinchu", "HsinchuCounty", "MiaoliCounty", "ChanghuaCounty", "NantouCounty", "YunlinCounty", "ChiayiCounty", "Chiayi", "PingtungCounty", "YilanCounty", "HualienCounty", "TaitungCounty", "PenghuCounty", "Keelung" ], "type": "string", "xml": { } } }, { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA2Data" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA2Data" }, "xml": { "name": "ArrayOfBusA2Data", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/RealTimeNearStop/Streaming/City/{City}/{RouteName}": { "get": { "tags": [ "CityBus" ], "summary": "取得指定[縣市],[路線名稱]的公車動態定點資料(A2)[逐筆更新]", "description": "### 市區公車之定點資料(A2) ###\n- [逐筆更新]與[批次更新]之差異請詳見運輸資料使用指引([連結](https://motc-ptx.gitbook.io/tdx-zi-liao-shi-yong-kui-hua-bao-dian/data_notice/public_transportation_data/bus_dynamic_data))", "operationId": "CityBusApi_RealTimeNearStop_UDP_2047_1", "parameters": [ { "name": "City", "in": "path", "description": "欲查詢縣市", "required": true, "schema": { "title": "String", "enum": [ "Hsinchu", "HsinchuCounty", "MiaoliCounty", "ChanghuaCounty", "NantouCounty", "YunlinCounty", "ChiayiCounty", "Chiayi", "PingtungCounty", "YilanCounty", "HualienCounty", "TaitungCounty", "PenghuCounty", "Keelung" ], "type": "string", "xml": { } } }, { "name": "RouteName", "in": "path", "description": "繁體中文路線名稱,如'307'", "required": true, "schema": { "title": "String", "type": "string", "xml": { } } }, { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA2Data" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA2Data" }, "xml": { "name": "ArrayOfBusA2Data", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/EstimatedTimeOfArrival/Streaming/City/{City}": { "get": { "tags": [ "CityBus" ], "summary": "取得指定[縣市]的公車預估到站資料(N1)[逐筆更新]", "description": "### 市區公車之預估到站資料(N1) ###\n- [部分縣市] 當 StopStatus = 1(尚未發車) 且 EstimateTime > 0 (有值) 的情形, 屬正常情形, 雖目前尚未發車, 但提供EstimateTime值為預計多久後開始發車之時間。\n- [逐筆更新]與[批次更新]之差異請詳見運輸資料使用指引([連結](https://motc-ptx.gitbook.io/tdx-zi-liao-shi-yong-kui-hua-bao-dian/data_notice/public_transportation_data/bus_dynamic_data))\n- N1僅於該路線上有任一車輛離站時,來源端才會重新計算並發佈,因此使用者需自行處理時間遞減機制,或以EstimateTime-(收到資料時間-SrcTrasTime)(秒)作為實際預估抵達時間。", "operationId": "CityBusApi_EstimatedTimeOfArrival_UDP_2048", "parameters": [ { "name": "City", "in": "path", "description": "欲查詢縣市", "required": true, "schema": { "title": "String", "enum": [ "Hsinchu", "HsinchuCounty", "MiaoliCounty", "ChanghuaCounty", "NantouCounty", "YunlinCounty", "ChiayiCounty", "Chiayi", "PingtungCounty", "YilanCounty", "HualienCounty", "TaitungCounty", "PenghuCounty", "Keelung" ], "type": "string", "xml": { } } }, { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusN1EstimateTime" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusN1EstimateTime" }, "xml": { "name": "ArrayOfBusN1EstimateTime", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/EstimatedTimeOfArrival/Streaming/City/{City}/{RouteName}": { "get": { "tags": [ "CityBus" ], "summary": "取得指定[縣市],[路線名稱]的公車預估到站資料(N1)[逐筆更新]", "description": "### 市區公車之預估到站資料(N1) ###\n- [部分縣市] 當 StopStatus = 1(尚未發車) 且 EstimateTime > 0 (有值) 的情形, 屬正常情形, 雖目前尚未發車, 但提供EstimateTime值為預計多久後開始發車之時間。\n- [逐筆更新]與[批次更新]之差異請詳見運輸資料使用指引([連結](https://motc-ptx.gitbook.io/tdx-zi-liao-shi-yong-kui-hua-bao-dian/data_notice/public_transportation_data/bus_dynamic_data))\n- N1僅於該路線上有任一車輛離站時,來源端才會重新計算並發佈,因此使用者需自行處理時間遞減機制,或以EstimateTime-(收到資料時間-SrcTrasTime)(秒)作為實際預估抵達時間。", "operationId": "CityBusApi_EstimatedTimeOfArrival_UDP_2048_1", "parameters": [ { "name": "City", "in": "path", "description": "欲查詢縣市", "required": true, "schema": { "title": "String", "enum": [ "Hsinchu", "HsinchuCounty", "MiaoliCounty", "ChanghuaCounty", "NantouCounty", "YunlinCounty", "ChiayiCounty", "Chiayi", "PingtungCounty", "YilanCounty", "HualienCounty", "TaitungCounty", "PenghuCounty", "Keelung" ], "type": "string", "xml": { } } }, { "name": "RouteName", "in": "path", "description": "繁體中文路線名稱,如'307'", "required": true, "schema": { "title": "String", "type": "string", "xml": { } } }, { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusN1EstimateTime" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusN1EstimateTime" }, "xml": { "name": "ArrayOfBusN1EstimateTime", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/RealTimeByFrequency/City/{City}": { "get": { "tags": [ "CityBus" ], "summary": "取得指定[縣市]的公車動態定時資料(A1)[批次更新]", "description": "### 市區公車之定時資料(A1) ###\n- [逐筆更新]與[批次更新]之差異請詳見運輸資料使用指引([連結](https://motc-ptx.gitbook.io/tdx-zi-liao-shi-yong-kui-hua-bao-dian/data_notice/public_transportation_data/bus_dynamic_data))", "operationId": "CityBusApi_RealTimeByFrequency_2030", "parameters": [ { "name": "City", "in": "path", "description": "欲查詢縣市", "required": true, "schema": { "title": "String", "enum": [ "Taipei", "NewTaipei", "Taoyuan", "Taichung", "Tainan", "Kaohsiung", "Keelung", "Hsinchu", "HsinchuCounty", "MiaoliCounty", "ChanghuaCounty", "NantouCounty", "YunlinCounty", "ChiayiCounty", "Chiayi", "PingtungCounty", "YilanCounty", "HualienCounty", "TaitungCounty", "KinmenCounty", "PenghuCounty", "LienchiangCounty" ], "type": "string", "xml": { } } }, { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA1Data" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA1Data" }, "xml": { "name": "ArrayOfBusA1Data", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/RealTimeByFrequency/City/{City}/{RouteName}": { "get": { "tags": [ "CityBus" ], "summary": "取得指定[縣市],[路線名稱]的公車動態定時資料(A1)[批次更新]", "description": "### 市區公車之定時資料(A1) ###\n- [逐筆更新]與[批次更新]之差異請詳見運輸資料使用指引([連結](https://motc-ptx.gitbook.io/tdx-zi-liao-shi-yong-kui-hua-bao-dian/data_notice/public_transportation_data/bus_dynamic_data))", "operationId": "CityBusApi_RealTimeByFrequency_2030_1", "parameters": [ { "name": "City", "in": "path", "description": "欲查詢縣市", "required": true, "schema": { "title": "String", "enum": [ "Taipei", "NewTaipei", "Taoyuan", "Taichung", "Tainan", "Kaohsiung", "Keelung", "Hsinchu", "HsinchuCounty", "MiaoliCounty", "ChanghuaCounty", "NantouCounty", "YunlinCounty", "ChiayiCounty", "Chiayi", "PingtungCounty", "YilanCounty", "HualienCounty", "TaitungCounty", "KinmenCounty", "PenghuCounty", "LienchiangCounty" ], "type": "string", "xml": { } } }, { "name": "RouteName", "in": "path", "description": "繁體中文路線名稱,如'307'", "required": true, "schema": { "title": "String", "type": "string", "xml": { } } }, { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA1Data" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA1Data" }, "xml": { "name": "ArrayOfBusA1Data", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/RealTimeNearStop/City/{City}": { "get": { "tags": [ "CityBus" ], "summary": "取得指定[縣市]的公車動態定點資料(A2)[批次更新]", "description": "### 市區公車之定點資料(A2) ###\n- [逐筆更新]與[批次更新]之差異請詳見運輸資料使用指引([連結](https://motc-ptx.gitbook.io/tdx-zi-liao-shi-yong-kui-hua-bao-dian/data_notice/public_transportation_data/bus_dynamic_data))", "operationId": "CityBusApi_RealTimeNearStop_2031", "parameters": [ { "name": "City", "in": "path", "description": "欲查詢縣市", "required": true, "schema": { "title": "String", "enum": [ "Taipei", "NewTaipei", "Taoyuan", "Taichung", "Tainan", "Kaohsiung", "Keelung", "Hsinchu", "HsinchuCounty", "MiaoliCounty", "ChanghuaCounty", "NantouCounty", "YunlinCounty", "ChiayiCounty", "Chiayi", "PingtungCounty", "YilanCounty", "HualienCounty", "TaitungCounty", "KinmenCounty", "PenghuCounty", "LienchiangCounty" ], "type": "string", "xml": { } } }, { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA2Data" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA2Data" }, "xml": { "name": "ArrayOfBusA2Data", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/RealTimeNearStop/City/{City}/{RouteName}": { "get": { "tags": [ "CityBus" ], "summary": "取得指定[縣市],[路線名稱]的公車動態定點資料(A2)[批次更新]", "description": "### 市區公車之定點資料(A2) ###\n- [逐筆更新]與[批次更新]之差異請詳見運輸資料使用指引([連結](https://motc-ptx.gitbook.io/tdx-zi-liao-shi-yong-kui-hua-bao-dian/data_notice/public_transportation_data/bus_dynamic_data))", "operationId": "CityBusApi_RealTimeNearStop_2031_1", "parameters": [ { "name": "City", "in": "path", "description": "欲查詢縣市", "required": true, "schema": { "title": "String", "enum": [ "Taipei", "NewTaipei", "Taoyuan", "Taichung", "Tainan", "Kaohsiung", "Keelung", "Hsinchu", "HsinchuCounty", "MiaoliCounty", "ChanghuaCounty", "NantouCounty", "YunlinCounty", "ChiayiCounty", "Chiayi", "PingtungCounty", "YilanCounty", "HualienCounty", "TaitungCounty", "KinmenCounty", "PenghuCounty", "LienchiangCounty" ], "type": "string", "xml": { } } }, { "name": "RouteName", "in": "path", "description": "繁體中文路線名稱,如'307'", "required": true, "schema": { "title": "String", "type": "string", "xml": { } } }, { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA2Data" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA2Data" }, "xml": { "name": "ArrayOfBusA2Data", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/EstimatedTimeOfArrival/City/{City}": { "get": { "tags": [ "CityBus" ], "summary": "取得指定[縣市]的公車預估到站資料(N1)[批次更新]", "description": " ### 市區公車之預估到站資料(N1) ###\n- [部分縣市] 當 StopStatus = 1(尚未發車) 且 EstimateTime > 0 (有值) 的情形, 屬正常情形, 雖目前尚未發車, 但提供EstimateTime值為預計多久後開始發車之時間。\n- [逐筆更新]與[批次更新]之差異請詳見運輸資料使用指引([連結](https://motc-ptx.gitbook.io/tdx-zi-liao-shi-yong-kui-hua-bao-dian/data_notice/public_transportation_data/bus_dynamic_data))", "operationId": "CityBusApi_EstimatedTimeOfArrival_2032", "parameters": [ { "name": "City", "in": "path", "description": "欲查詢縣市", "required": true, "schema": { "title": "String", "enum": [ "Taipei", "NewTaipei", "Taoyuan", "Taichung", "Tainan", "Kaohsiung", "Keelung", "Hsinchu", "HsinchuCounty", "MiaoliCounty", "ChanghuaCounty", "NantouCounty", "YunlinCounty", "ChiayiCounty", "Chiayi", "PingtungCounty", "YilanCounty", "HualienCounty", "TaitungCounty", "KinmenCounty", "PenghuCounty", "LienchiangCounty" ], "type": "string", "xml": { } } }, { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusN1EstimateTime" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusN1EstimateTime" }, "xml": { "name": "ArrayOfBusN1EstimateTime", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/EstimatedTimeOfArrival/City/{City}/{RouteName}": { "get": { "tags": [ "CityBus" ], "summary": "取得指定[縣市],[路線名稱]的公車預估到站資料(N1)[批次更新]", "description": " ### 市區公車之預估到站資料(N1) ###\n- [部分縣市] 當 StopStatus = 1(尚未發車) 且 EstimateTime > 0 (有值) 的情形, 屬正常情形, 雖目前尚未發車, 但提供EstimateTime值為預計多久後開始發車之時間。\n- [逐筆更新]與[批次更新]之差異請詳見運輸資料使用指引([連結](https://motc-ptx.gitbook.io/tdx-zi-liao-shi-yong-kui-hua-bao-dian/data_notice/public_transportation_data/bus_dynamic_data))", "operationId": "CityBusApi_EstimatedTimeOfArrival_2032_1", "parameters": [ { "name": "City", "in": "path", "description": "欲查詢縣市", "required": true, "schema": { "title": "String", "enum": [ "Taipei", "NewTaipei", "Taoyuan", "Taichung", "Tainan", "Kaohsiung", "Keelung", "Hsinchu", "HsinchuCounty", "MiaoliCounty", "ChanghuaCounty", "NantouCounty", "YunlinCounty", "ChiayiCounty", "Chiayi", "PingtungCounty", "YilanCounty", "HualienCounty", "TaitungCounty", "KinmenCounty", "PenghuCounty", "LienchiangCounty" ], "type": "string", "xml": { } } }, { "name": "RouteName", "in": "path", "description": "繁體中文路線名稱,如'307'", "required": true, "schema": { "title": "String", "type": "string", "xml": { } } }, { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusN1EstimateTime" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusN1EstimateTime" }, "xml": { "name": "ArrayOfBusN1EstimateTime", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/DataVersion/City/{City}": { "get": { "tags": [ "CityBus" ], "summary": "取得指定[縣市]目前資料的最新版本資訊", "description": "版本詳細資訊", "operationId": "CityBusApi_DataVersion_2033", "parameters": [ { "name": "City", "in": "path", "description": "欲查詢縣市", "required": true, "schema": { "title": "String", "enum": [ "Taipei", "NewTaipei", "Taoyuan", "Taichung", "Tainan", "Kaohsiung", "Keelung", "Hsinchu", "HsinchuCounty", "MiaoliCounty", "ChanghuaCounty", "NantouCounty", "YunlinCounty", "ChiayiCounty", "Chiayi", "PingtungCounty", "YilanCounty", "HualienCounty", "TaitungCounty", "KinmenCounty", "PenghuCounty", "LienchiangCounty" ], "type": "string", "xml": { } } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusVersion" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusVersion" } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/Operator/City/{City}": { "get": { "tags": [ "CityBus" ], "summary": "取得指定[縣市]的市區公車營運業者資料", "description": "市區公車之營運業者資料", "operationId": "CityBusApi_Operator_2034", "parameters": [ { "name": "City", "in": "path", "description": "欲查詢縣市", "required": true, "schema": { "title": "String", "enum": [ "Taipei", "NewTaipei", "Taoyuan", "Taichung", "Tainan", "Kaohsiung", "Keelung", "Hsinchu", "HsinchuCounty", "MiaoliCounty", "ChanghuaCounty", "NantouCounty", "YunlinCounty", "ChiayiCounty", "Chiayi", "PingtungCounty", "YilanCounty", "HualienCounty", "TaitungCounty", "KinmenCounty", "PenghuCounty", "LienchiangCounty" ], "type": "string", "xml": { } } }, { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.Operator" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.Operator" }, "xml": { "name": "ArrayOfOperator", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/Route/City/{City}": { "get": { "tags": [ "CityBus" ], "summary": "取得指定[縣市]的市區公車路線資料", "description": "市區公車之路線資料", "operationId": "CityBusApi_Route_2035", "parameters": [ { "name": "City", "in": "path", "description": "欲查詢縣市", "required": true, "schema": { "title": "String", "enum": [ "Taipei", "NewTaipei", "Taoyuan", "Taichung", "Tainan", "Kaohsiung", "Keelung", "Hsinchu", "HsinchuCounty", "MiaoliCounty", "ChanghuaCounty", "NantouCounty", "YunlinCounty", "ChiayiCounty", "Chiayi", "PingtungCounty", "YilanCounty", "HualienCounty", "TaitungCounty", "KinmenCounty", "PenghuCounty", "LienchiangCounty" ], "type": "string", "xml": { } } }, { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRoute" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRoute" }, "xml": { "name": "ArrayOfBusRoute", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/Route/City/{City}/{RouteName}": { "get": { "tags": [ "CityBus" ], "summary": "取得指定[縣市],[路線名稱]的路線資料", "description": "市區公車之路線資料", "operationId": "CityBusApi_Route_2035_1", "parameters": [ { "name": "City", "in": "path", "description": "欲查詢縣市", "required": true, "schema": { "title": "String", "enum": [ "Taipei", "NewTaipei", "Taoyuan", "Taichung", "Tainan", "Kaohsiung", "Keelung", "Hsinchu", "HsinchuCounty", "MiaoliCounty", "ChanghuaCounty", "NantouCounty", "YunlinCounty", "ChiayiCounty", "Chiayi", "PingtungCounty", "YilanCounty", "HualienCounty", "TaitungCounty", "KinmenCounty", "PenghuCounty", "LienchiangCounty" ], "type": "string", "xml": { } } }, { "name": "RouteName", "in": "path", "description": "繁體中文路線名稱,如'307'", "required": true, "schema": { "title": "String", "type": "string", "xml": { } } }, { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRoute" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRoute" }, "xml": { "name": "ArrayOfBusRoute", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/Stop/City/{City}": { "get": { "tags": [ "CityBus" ], "summary": "取得指定[縣市]的市區公車站牌資料", "description": "市區公車之站牌資料", "operationId": "CityBusApi_Stop_2036", "parameters": [ { "name": "City", "in": "path", "description": "欲查詢縣市", "required": true, "schema": { "title": "String", "enum": [ "NewTaipei", "Taoyuan", "Taichung", "Tainan", "Kaohsiung", "Keelung", "Hsinchu", "HsinchuCounty", "MiaoliCounty", "ChanghuaCounty", "NantouCounty", "YunlinCounty", "ChiayiCounty", "Chiayi", "PingtungCounty", "YilanCounty", "HualienCounty", "TaitungCounty", "KinmenCounty", "PenghuCounty", "LienchiangCounty", "Taipei" ], "type": "string", "xml": { } } }, { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusStop" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusStop" }, "xml": { "name": "ArrayOfBusStop", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/Station/City/{City}": { "get": { "tags": [ "CityBus" ], "summary": "取得指定[縣市]的市區公車站位資料", "description": "市區公車之各站牌所屬的站位資料", "operationId": "CityBusApi_Station_2037", "parameters": [ { "name": "City", "in": "path", "description": "欲查詢縣市", "required": true, "schema": { "title": "String", "enum": [ "Taipei", "NewTaipei", "Kaohsiung", "Hsinchu", "HsinchuCounty", "MiaoliCounty", "ChanghuaCounty", "NantouCounty", "YunlinCounty", "ChiayiCounty", "Chiayi", "PingtungCounty", "YilanCounty", "HualienCounty", "TaitungCounty", "PenghuCounty", "Tainan", "KinmenCounty", "Taoyuan", "Taichung", "Keelung" ], "type": "string", "xml": { } } }, { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusStation" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusStation" }, "xml": { "name": "ArrayOfBusStation", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/DisplayStopOfRoute/City/{City}": { "get": { "tags": [ "CityBus" ], "summary": "取得指定[縣市]的市區公車顯示用路線站序資料", "description": "市區公車之顯示用路線站序資料", "operationId": "CityBusApi_DisplayStopOfRoute_2038", "parameters": [ { "name": "City", "in": "path", "description": "欲查詢縣市", "required": true, "schema": { "title": "String", "enum": [ "Taipei", "Tainan", "NewTaipei", "Taoyuan", "Taichung" ], "type": "string", "xml": { } } }, { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusDisplayStopOfRoute" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusDisplayStopOfRoute" }, "xml": { "name": "ArrayOfBusDisplayStopOfRoute", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/DisplayStopOfRoute/City/{City}/{RouteName}": { "get": { "tags": [ "CityBus" ], "summary": "取得指定[縣市],[路線名稱]的市區公車顯示用路線站序資料", "description": "市區公車之顯示用路線站序資料", "operationId": "CityBusApi_DisplayStopOfRoute_2038_1", "parameters": [ { "name": "City", "in": "path", "description": "欲查詢縣市", "required": true, "schema": { "title": "String", "enum": [ "Taipei", "Tainan", "NewTaipei", "Taoyuan", "Taichung" ], "type": "string", "xml": { } } }, { "name": "RouteName", "in": "path", "description": "繁體中文路線名稱,如'307'", "required": true, "schema": { "title": "String", "type": "string", "xml": { } } }, { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusDisplayStopOfRoute" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusDisplayStopOfRoute" }, "xml": { "name": "ArrayOfBusDisplayStopOfRoute", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/StopOfRoute/City/{City}": { "get": { "tags": [ "CityBus" ], "summary": "取得指定[縣市]的市區公車路線站序資料", "description": "市區公車之路線站序資料", "operationId": "CityBusApi_StopOfRoute_2039", "parameters": [ { "name": "City", "in": "path", "description": "欲查詢縣市", "required": true, "schema": { "title": "String", "enum": [ "Taipei", "NewTaipei", "Taoyuan", "Taichung", "Tainan", "Kaohsiung", "Keelung", "Hsinchu", "HsinchuCounty", "MiaoliCounty", "ChanghuaCounty", "NantouCounty", "YunlinCounty", "ChiayiCounty", "Chiayi", "PingtungCounty", "YilanCounty", "HualienCounty", "TaitungCounty", "KinmenCounty", "PenghuCounty", "LienchiangCounty" ], "type": "string", "xml": { } } }, { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusStopOfRoute" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusStopOfRoute" }, "xml": { "name": "ArrayOfBusStopOfRoute", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/StopOfRoute/City/{City}/{RouteName}": { "get": { "tags": [ "CityBus" ], "summary": "取得指定[縣市],[路線名稱]的市區公車路線站序資料", "description": "市區公車之路線站序資料", "operationId": "CityBusApi_StopOfRoute_2039_1", "parameters": [ { "name": "City", "in": "path", "description": "欲查詢縣市", "required": true, "schema": { "title": "String", "enum": [ "Taipei", "NewTaipei", "Taoyuan", "Taichung", "Tainan", "Kaohsiung", "Keelung", "Hsinchu", "HsinchuCounty", "MiaoliCounty", "ChanghuaCounty", "NantouCounty", "YunlinCounty", "ChiayiCounty", "Chiayi", "PingtungCounty", "YilanCounty", "HualienCounty", "TaitungCounty", "KinmenCounty", "PenghuCounty", "LienchiangCounty" ], "type": "string", "xml": { } } }, { "name": "RouteName", "in": "path", "description": "繁體中文路線名稱,如'307'", "required": true, "schema": { "title": "String", "type": "string", "xml": { } } }, { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusStopOfRoute" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusStopOfRoute" }, "xml": { "name": "ArrayOfBusStopOfRoute", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/Schedule/City/{City}": { "get": { "tags": [ "CityBus" ], "summary": "取得指定[縣市]的市區公車路線班表資料", "description": "市區公車之班表及班距資料。一般市區公車班次較多時會採用【班距】式時刻表;班次較少時會採用【班表】式時刻表", "operationId": "CityBusApi_Schedule_2040", "parameters": [ { "name": "City", "in": "path", "description": "欲查詢縣市", "required": true, "schema": { "title": "String", "enum": [ "Taipei", "NewTaipei", "Tainan", "Keelung", "Hsinchu", "HsinchuCounty", "MiaoliCounty", "ChanghuaCounty", "NantouCounty", "YunlinCounty", "ChiayiCounty", "Chiayi", "PingtungCounty", "YilanCounty", "HualienCounty", "TaitungCounty", "KinmenCounty", "PenghuCounty", "Taoyuan", "Taichung", "Kaohsiung", "LienchiangCounty" ], "type": "string", "xml": { } } }, { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusSchedule" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusSchedule" }, "xml": { "name": "ArrayOfBusSchedule", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/Schedule/City/{City}/{RouteName}": { "get": { "tags": [ "CityBus" ], "summary": "取得指定[縣市],[路線名稱]的市區公車路線班表資料", "description": "市區公車之預定班表及班距資料。一般市區公車班次較多時會採用【班距】式時刻表;班次較少時會採用【班表】式時刻表", "operationId": "CityBusApi_Schedule_2040_1", "parameters": [ { "name": "City", "in": "path", "description": "欲查詢縣市", "required": true, "schema": { "title": "String", "enum": [ "Taipei", "NewTaipei", "Tainan", "Keelung", "Hsinchu", "HsinchuCounty", "MiaoliCounty", "ChanghuaCounty", "NantouCounty", "YunlinCounty", "ChiayiCounty", "Chiayi", "PingtungCounty", "YilanCounty", "HualienCounty", "TaitungCounty", "KinmenCounty", "PenghuCounty", "Taoyuan", "Taichung", "Kaohsiung", "LienchiangCounty" ], "type": "string", "xml": { } } }, { "name": "RouteName", "in": "path", "description": "繁體中文路線名稱,如'307'", "required": true, "schema": { "title": "String", "type": "string", "xml": { } } }, { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusSchedule" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusSchedule" }, "xml": { "name": "ArrayOfBusSchedule", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/Vehicle/City/{City}": { "get": { "tags": [ "CityBus" ], "summary": "取得指定[縣市]的市區公車車輛資料", "description": "市區公車之車輛資料", "operationId": "CityBusApi_Vehicle_2041", "parameters": [ { "name": "City", "in": "path", "description": "欲查詢縣市", "required": true, "schema": { "title": "String", "enum": [ "Taipei", "NewTaipei", "Taoyuan", "Taichung", "Tainan", "Kaohsiung" ], "type": "string", "xml": { } } }, { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusVehicleInfo" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusVehicleInfo" }, "xml": { "name": "ArrayOfBusVehicleInfo", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/Shape/City/{City}": { "get": { "tags": [ "CityBus" ], "summary": "取得指定[縣市]的市區公車線型資料", "description": "市區公車之線型資料", "operationId": "CityBusApi_Shape_2042", "parameters": [ { "name": "City", "in": "path", "description": "欲查詢縣市", "required": true, "schema": { "title": "String", "enum": [ "Taipei", "NewTaipei", "Taoyuan", "Taichung", "Tainan", "Kaohsiung", "Keelung", "KinmenCounty", "Hsinchu", "HsinchuCounty", "MiaoliCounty", "ChanghuaCounty", "NantouCounty", "YunlinCounty", "ChiayiCounty", "Chiayi", "PingtungCounty", "YilanCounty", "HualienCounty", "TaitungCounty", "PenghuCounty", "LienchiangCounty" ], "type": "string", "xml": { } } }, { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusShape" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusShape" }, "xml": { "name": "ArrayOfBusShape", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/Shape/City/{City}/{RouteName}": { "get": { "tags": [ "CityBus" ], "summary": "取得指定[縣市],[路線名稱]的市區公車線型資料", "description": "市區公車之線型資料", "operationId": "CityBusApi_Shape_2042_1", "parameters": [ { "name": "City", "in": "path", "description": "欲查詢縣市", "required": true, "schema": { "title": "String", "enum": [ "Taipei", "NewTaipei", "Taoyuan", "Taichung", "Tainan", "Kaohsiung", "Keelung", "KinmenCounty", "Hsinchu", "HsinchuCounty", "MiaoliCounty", "ChanghuaCounty", "NantouCounty", "YunlinCounty", "ChiayiCounty", "Chiayi", "PingtungCounty", "YilanCounty", "HualienCounty", "TaitungCounty", "PenghuCounty", "LienchiangCounty" ], "type": "string", "xml": { } } }, { "name": "RouteName", "in": "path", "description": "繁體中文路線名稱,如'307'", "required": true, "schema": { "title": "String", "type": "string", "xml": { } } }, { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusShape" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusShape" }, "xml": { "name": "ArrayOfBusShape", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/RouteFare/City/{City}": { "get": { "tags": [ "CityBus" ], "summary": "取得指定[縣市]的市區公車路線票價資料", "description": "市區公車路線票價資料", "operationId": "CityBusApi_RouteFare_2043", "parameters": [ { "name": "City", "in": "path", "description": "欲查詢縣市", "required": true, "schema": { "title": "String", "enum": [ "Taipei", "NewTaipei", "Taoyuan", "Taichung", "Kaohsiung", "Hsinchu", "HsinchuCounty", "MiaoliCounty", "ChanghuaCounty", "NantouCounty", "YunlinCounty", "ChiayiCounty", "Chiayi", "PingtungCounty", "YilanCounty", "HualienCounty", "TaitungCounty", "KinmenCounty", "PenghuCounty" ], "type": "string", "xml": { } } }, { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRouteFare" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRouteFare" }, "xml": { "name": "ArrayOfBusRouteFare", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/RouteFare/City/{City}/{RouteName}": { "get": { "tags": [ "CityBus" ], "summary": "取得指定[縣市],[路線名稱]的的市區公車路線票價資料", "description": "市區公車路線票價資料", "operationId": "CityBusApi_RouteFare_2043_1", "parameters": [ { "name": "City", "in": "path", "description": "欲查詢縣市", "required": true, "schema": { "title": "String", "enum": [ "Taipei", "NewTaipei", "Taoyuan", "Taichung", "Kaohsiung", "Hsinchu", "HsinchuCounty", "MiaoliCounty", "ChanghuaCounty", "NantouCounty", "YunlinCounty", "ChiayiCounty", "Chiayi", "PingtungCounty", "YilanCounty", "HualienCounty", "TaitungCounty", "KinmenCounty", "PenghuCounty" ], "type": "string", "xml": { } } }, { "name": "RouteName", "in": "path", "description": "繁體中文路線名稱,如'307'", "required": true, "schema": { "title": "String", "type": "string", "xml": { } } }, { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRouteFare" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRouteFare" }, "xml": { "name": "ArrayOfBusRouteFare", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/News/City/{City}": { "get": { "tags": [ "CityBus" ], "summary": "取得指定[縣市]的市區公車最新消息資料", "description": "市區公車最新消息資料", "operationId": "CityBusApi_News_2044", "parameters": [ { "name": "City", "in": "path", "description": "欲查詢縣市", "required": true, "schema": { "title": "String", "enum": [ "Keelung", "Tainan", "KinmenCounty", "Hsinchu", "HsinchuCounty", "MiaoliCounty", "ChanghuaCounty", "NantouCounty", "YunlinCounty", "ChiayiCounty", "Chiayi", "PingtungCounty", "YilanCounty", "HualienCounty", "TaitungCounty", "PenghuCounty", "Taichung", "Kaohsiung", "Taipei", "NewTaipei", "Taoyuan" ], "type": "string", "xml": { } } }, { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusNews" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusNews" }, "xml": { "name": "ArrayOfBusNews", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/StationGroup/City/{City}": { "get": { "tags": [ "CityBus" ], "summary": "取得指定[縣市]的市區公車組站位資料", "description": "市區公車之各站牌所屬的組站位資料", "operationId": "CityBusApi_StationGroup_2050", "parameters": [ { "name": "City", "in": "path", "description": "欲查詢縣市", "required": true, "schema": { "title": "String", "enum": [ "Hsinchu", "HsinchuCounty", "MiaoliCounty", "ChanghuaCounty", "NantouCounty", "YunlinCounty", "ChiayiCounty", "Chiayi", "PingtungCounty", "YilanCounty", "HualienCounty", "TaitungCounty", "PenghuCounty", "Keelung" ], "type": "string", "xml": { } } }, { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusStationGroup" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusStationGroup" }, "xml": { "name": "ArrayOfBusStationGroup", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/FirstLastTripInfo/City/{City}": { "get": { "tags": [ "CityBus" ], "summary": "取得指定[縣市]的市區公車路線首末班車資料", "description": "市區公車之路線首末班車資料", "operationId": "CityBusApi_FirstLastTripInfo_2052", "parameters": [ { "name": "City", "in": "path", "description": "欲查詢縣市", "required": true, "schema": { "title": "String", "enum": [ "KinmenCounty", "Taichung", "Taoyuan", "Keelung", "Hsinchu", "HsinchuCounty", "MiaoliCounty", "ChanghuaCounty", "NantouCounty", "YunlinCounty", "ChiayiCounty", "Chiayi", "PingtungCounty", "YilanCounty", "HualienCounty", "TaitungCounty", "PenghuCounty", "Kaohsiung" ], "type": "string", "xml": { } } }, { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusFirstLastTripInfo" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusFirstLastTripInfo" }, "xml": { "name": "ArrayOfBusFirstLastTripInfo", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/FirstLastTripInfo/City/{City}/{RouteName}": { "get": { "tags": [ "CityBus" ], "summary": "取得指定[縣市],[路線名稱]的路線首末班車資料", "description": "市區公車之路線首末班車資料", "operationId": "CityBusApi_FirstLastTripInfo_2052_1", "parameters": [ { "name": "City", "in": "path", "description": "欲查詢縣市", "required": true, "schema": { "title": "String", "enum": [ "KinmenCounty", "Taichung", "Taoyuan", "Keelung", "Hsinchu", "HsinchuCounty", "MiaoliCounty", "ChanghuaCounty", "NantouCounty", "YunlinCounty", "ChiayiCounty", "Chiayi", "PingtungCounty", "YilanCounty", "HualienCounty", "TaitungCounty", "PenghuCounty", "Kaohsiung" ], "type": "string", "xml": { } } }, { "name": "RouteName", "in": "path", "description": "繁體中文路線名稱,如'307'", "required": true, "schema": { "title": "String", "type": "string", "xml": { } } }, { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusFirstLastTripInfo" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusFirstLastTripInfo" }, "xml": { "name": "ArrayOfBusFirstLastTripInfo", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/Alert/City/{City}": { "get": { "tags": [ "CityBus" ], "summary": "取得指定[縣市]的市區公車營運通阻資料", "description": "市區公車營運通阻資料", "operationId": "CityBusApi_Alert_2053", "parameters": [ { "name": "City", "in": "path", "description": "欲查詢縣市", "required": true, "schema": { "title": "String", "enum": [ "Hsinchu", "HsinchuCounty", "MiaoliCounty", "ChanghuaCounty", "NantouCounty", "YunlinCounty", "ChiayiCounty", "Chiayi", "PingtungCounty", "YilanCounty", "HualienCounty", "TaitungCounty", "PenghuCounty", "Taichung", "Kaohsiung", "Taoyuan", "Taipei", "NewTaipei", "Keelung" ], "type": "string", "xml": { } } }, { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusAlert" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusAlert" }, "xml": { "name": "ArrayOfBusAlert", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/RouteNetwork/City/{City}": { "get": { "tags": [ "CityBus" ], "summary": "取得指定[縣市]的市區公車路線網路拓撲資料", "description": "市區公車路線網路拓撲資料", "operationId": "CityBusApi_RouteNetwork_2055", "parameters": [ { "name": "City", "in": "path", "description": "欲查詢縣市", "required": true, "schema": { "title": "String", "enum": [ "Taoyuan" ], "type": "string", "xml": { } } }, { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRouteNetwork" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRouteNetwork" }, "xml": { "name": "ArrayOfBusRouteNetwork", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/RouteNetwork/City/{City}/{RouteName}": { "get": { "tags": [ "CityBus" ], "summary": "取得指定[縣市],[路線名稱]的市區公車顯示用路線站序資料", "description": "市區公車之顯示用路線站序資料", "operationId": "CityBusApi_RouteNetwork_2055_1", "parameters": [ { "name": "City", "in": "path", "description": "欲查詢縣市", "required": true, "schema": { "title": "String", "enum": [ "Taoyuan" ], "type": "string", "xml": { } } }, { "name": "RouteName", "in": "path", "description": "繁體中文路線名稱,如'307'", "required": true, "schema": { "title": "String", "type": "string", "xml": { } } }, { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRouteNetwork" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRouteNetwork" }, "xml": { "name": "ArrayOfBusRouteNetwork", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/S2STravelTime/City/{City}/{RouteID}": { "get": { "tags": [ "CityBus" ], "summary": "取得指定[縣市],[路線代碼]的市區公車站間旅行時間資料", "description": "指定[縣市],[路線代碼]的市區公車站間旅行時間資料", "operationId": "CityBusApi_S2STravelTimeDetail_2056", "parameters": [ { "name": "City", "in": "path", "description": "欲查詢縣市", "required": true, "schema": { "title": "String", "enum": [ "Taipei", "Taoyuan", "Taichung", "Keelung", "Hsinchu", "HsinchuCounty", "MiaoliCounty", "ChanghuaCounty", "NantouCounty", "YunlinCounty", "ChiayiCounty", "Chiayi", "PingtungCounty", "YilanCounty", "HualienCounty", "TaitungCounty", "PenghuCounty" ], "type": "string", "xml": { } } }, { "name": "RouteID", "in": "path", "description": "路線代碼", "required": true, "schema": { "title": "String", "type": "string", "xml": { } } }, { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusS2STravelTime" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusS2STravelTime" }, "xml": { "name": "ArrayOfBusS2STravelTime", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/RealTimeByFrequency/Streaming/InterCity": { "get": { "tags": [ "InterCityBus" ], "summary": "取得公路客運的動態定時資料(A1)[逐筆更新]", "description": "### 公路客運之定時資料(A1) ###\n- [逐筆更新]與[批次更新]之差異請詳見運輸資料使用指引([連結](https://motc-ptx.gitbook.io/tdx-zi-liao-shi-yong-kui-hua-bao-dian/data_notice/public_transportation_data/bus_dynamic_data))", "operationId": "InterCityBusApi_RealTimeByFrequency_UDP_2057", "parameters": [ { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA1Data" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA1Data" }, "xml": { "name": "ArrayOfBusA1Data", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/RealTimeByFrequency/Streaming/InterCity/{RouteName}": { "get": { "tags": [ "InterCityBus" ], "summary": "取得指定[路線名稱]的公路客運動態定時資料(A1)[逐筆更新]", "description": "### 公路客運之定時資料(A1) ###\n- [逐筆更新]與[批次更新]之差異請詳見運輸資料使用指引([連結](https://motc-ptx.gitbook.io/tdx-zi-liao-shi-yong-kui-hua-bao-dian/data_notice/public_transportation_data/bus_dynamic_data))", "operationId": "InterCityBusApi_RealTimeByFrequency_UDP_2057_1", "parameters": [ { "name": "RouteName", "in": "path", "description": "繁體中文路線名稱,如'9001'", "required": true, "schema": { "title": "String", "type": "string", "xml": { } } }, { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA1Data" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA1Data" }, "xml": { "name": "ArrayOfBusA1Data", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/RealTimeNearStop/Streaming/InterCity": { "get": { "tags": [ "InterCityBus" ], "summary": "取得公路客運的動態定點資料(A2)[逐筆更新]", "description": "### 公路客運之定點資料(A2) ###\n- [逐筆更新]與[批次更新]之差異請詳見運輸資料使用指引([連結](https://motc-ptx.gitbook.io/tdx-zi-liao-shi-yong-kui-hua-bao-dian/data_notice/public_transportation_data/bus_dynamic_data))", "operationId": "InterCityBusApi_RealTimeNearStop_UDP_2058", "parameters": [ { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA2Data" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA2Data" }, "xml": { "name": "ArrayOfBusA2Data", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/RealTimeNearStop/Streaming/InterCity/{RouteName}": { "get": { "tags": [ "InterCityBus" ], "summary": "取得指定[路線名稱]的公路客運動態定點資料(A2)[逐筆更新]", "description": "### 公路客運之定點資料(A2) ###\n- [逐筆更新]與[批次更新]之差異請詳見運輸資料使用指引([連結](https://motc-ptx.gitbook.io/tdx-zi-liao-shi-yong-kui-hua-bao-dian/data_notice/public_transportation_data/bus_dynamic_data))", "operationId": "InterCityBusApi_RealTimeNearStop_UDP_2058_1", "parameters": [ { "name": "RouteName", "in": "path", "description": "繁體中文路線名稱,如'9001'", "required": true, "schema": { "title": "String", "type": "string", "xml": { } } }, { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA2Data" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA2Data" }, "xml": { "name": "ArrayOfBusA2Data", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/EstimatedTimeOfArrival/Streaming/InterCity": { "get": { "tags": [ "InterCityBus" ], "summary": "取得公路客運的預估到站資料(N1)[逐筆更新]", "description": "### 公路客運之預估到站資料(N1) ###\n- 不保留[現在時間]超過[本平台資料更新時間]兩分鐘的資料\n- [逐筆更新]與[批次更新]之差異請詳見運輸資料使用指引([連結](https://motc-ptx.gitbook.io/tdx-zi-liao-shi-yong-kui-hua-bao-dian/data_notice/public_transportation_data/bus_dynamic_data))\n- N1僅於該路線上有任一車輛離站時,來源端才會重新計算並發佈,因此使用者需自行處理時間遞減機制,或以EstimateTime-(收到資料時間-SrcTrasTime)(秒)作為實際預估抵達時間。", "operationId": "InterCityBusApi_EstimatedTimeOfArrival_UDP_2059", "parameters": [ { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusN1EstimateTime" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusN1EstimateTime" }, "xml": { "name": "ArrayOfBusN1EstimateTime", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/EstimatedTimeOfArrival/Streaming/InterCity/{RouteName}": { "get": { "tags": [ "InterCityBus" ], "summary": "取得指定[路線名稱]的公路客運預估到站資料(N1)[逐筆更新]", "description": "### 公路客運之預估到站資料(N1) ###\n- 不保留[現在時間]超過[本平台資料更新時間]兩分鐘的資料\n- [逐筆更新]與[批次更新]之差異請詳見運輸資料使用指引([連結](https://motc-ptx.gitbook.io/tdx-zi-liao-shi-yong-kui-hua-bao-dian/data_notice/public_transportation_data/bus_dynamic_data))\n- N1僅於該路線上有任一車輛離站時,來源端才會重新計算並發佈,因此使用者需自行處理時間遞減機制,或以EstimateTime-(收到資料時間-SrcTrasTime)(秒)作為實際預估抵達時間。", "operationId": "InterCityBusApi_EstimatedTimeOfArrival_UDP_2059_1", "parameters": [ { "name": "RouteName", "in": "path", "description": "繁體中文路線名稱,如'9001'", "required": true, "schema": { "title": "String", "type": "string", "xml": { } } }, { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusN1EstimateTime" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusN1EstimateTime" }, "xml": { "name": "ArrayOfBusN1EstimateTime", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/RealTimeByFrequency/InterCity": { "get": { "tags": [ "InterCityBus" ], "summary": "取得公路客運的動態定時資料(A1)[批次更新]", "description": "### 公路客運之定時資料(A1) ###\n- [逐筆更新]與[批次更新]之差異請詳見運輸資料使用指引([連結](https://motc-ptx.gitbook.io/tdx-zi-liao-shi-yong-kui-hua-bao-dian/data_notice/public_transportation_data/bus_dynamic_data))", "operationId": "InterCityBusApi_RealTimeByFrequency_2060", "parameters": [ { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA1Data" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA1Data" }, "xml": { "name": "ArrayOfBusA1Data", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/RealTimeByFrequency/InterCity/{RouteName}": { "get": { "tags": [ "InterCityBus" ], "summary": "取得指定[路線名稱]的公路客運動態定時資料(A1)[批次更新]", "description": "### 公路客運之定時資料(A1) ###\n- [逐筆更新]與[批次更新]之差異請詳見運輸資料使用指引([連結](https://motc-ptx.gitbook.io/tdx-zi-liao-shi-yong-kui-hua-bao-dian/data_notice/public_transportation_data/bus_dynamic_data))", "operationId": "InterCityBusApi_RealTimeByFrequency_2060_1", "parameters": [ { "name": "RouteName", "in": "path", "description": "繁體中文路線名稱,如'9001'", "required": true, "schema": { "title": "String", "type": "string", "xml": { } } }, { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA1Data" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA1Data" }, "xml": { "name": "ArrayOfBusA1Data", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/RealTimeNearStop/InterCity": { "get": { "tags": [ "InterCityBus" ], "summary": "取得公路客運的動態定點資料(A2)[批次更新]", "description": "### 公路客運之定點資料(A2) ###\n- [逐筆更新]與[批次更新]之差異請詳見運輸資料使用指引([連結](https://motc-ptx.gitbook.io/tdx-zi-liao-shi-yong-kui-hua-bao-dian/data_notice/public_transportation_data/bus_dynamic_data))", "operationId": "InterCityBusApi_RealTimeNearStop_2061", "parameters": [ { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA2Data" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA2Data" }, "xml": { "name": "ArrayOfBusA2Data", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/RealTimeNearStop/InterCity/{RouteName}": { "get": { "tags": [ "InterCityBus" ], "summary": "取得指定[路線名稱]的公路客運動態定點資料(A2)[批次更新]", "description": "### 公路客運之定點資料(A2) ###\n- [逐筆更新]與[批次更新]之差異請詳見運輸資料使用指引([連結](https://motc-ptx.gitbook.io/tdx-zi-liao-shi-yong-kui-hua-bao-dian/data_notice/public_transportation_data/bus_dynamic_data))", "operationId": "InterCityBusApi_RealTimeNearStop_2061_1", "parameters": [ { "name": "RouteName", "in": "path", "description": "繁體中文路線名稱,如'9001'", "required": true, "schema": { "title": "String", "type": "string", "xml": { } } }, { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA2Data" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA2Data" }, "xml": { "name": "ArrayOfBusA2Data", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/EstimatedTimeOfArrival/InterCity": { "get": { "tags": [ "InterCityBus" ], "summary": "取得公路客運的預估到站資料(N1)[批次更新]", "description": "###公路客運之預估到站資料(N1)###\n- 不保留[現在時間]超過[本平台資料更新時間]兩分鐘的資料\n- [逐筆更新]與[批次更新]之差異請詳見運輸資料使用指引([連結](https://motc-ptx.gitbook.io/tdx-zi-liao-shi-yong-kui-hua-bao-dian/data_notice/public_transportation_data/bus_dynamic_data))", "operationId": "InterCityBusApi_EstimatedTimeOfArrival_2062", "parameters": [ { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusN1EstimateTime" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusN1EstimateTime" }, "xml": { "name": "ArrayOfBusN1EstimateTime", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/EstimatedTimeOfArrival/InterCity/{RouteName}": { "get": { "tags": [ "InterCityBus" ], "summary": "取得指定[路線名稱]的公路客運預估到站資料(N1)[批次更新]", "description": "### 公路客運之預估到站資料(N1) ###\n- 不保留[現在時間]超過[本平台資料更新時間]兩分鐘的資料\n- [逐筆更新]與[批次更新]之差異請詳見運輸資料使用指引([連結](https://motc-ptx.gitbook.io/tdx-zi-liao-shi-yong-kui-hua-bao-dian/data_notice/public_transportation_data/bus_dynamic_data))", "operationId": "InterCityBusApi_EstimatedTimeOfArrival_2062_1", "parameters": [ { "name": "RouteName", "in": "path", "description": "繁體中文路線名稱,如'9001'", "required": true, "schema": { "title": "String", "type": "string", "xml": { } } }, { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusN1EstimateTime" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusN1EstimateTime" }, "xml": { "name": "ArrayOfBusN1EstimateTime", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/DataVersion/InterCity": { "get": { "tags": [ "InterCityBus" ], "summary": "取得公路客運目前資料的最新版本資訊", "description": "版本詳細資訊", "operationId": "InterCityBusApi_DataVersion_2063", "parameters": [ { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusVersion" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusVersion" } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/Operator/InterCity": { "get": { "tags": [ "InterCityBus" ], "summary": "取得公路客運的營運業者資料", "description": "公路客運之營運業者資料", "operationId": "InterCityBusApi_Operator_2064", "parameters": [ { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.Operator" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.Operator" }, "xml": { "name": "ArrayOfOperator", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/Route/InterCity": { "get": { "tags": [ "InterCityBus" ], "summary": "取得公路客運路線資料", "description": "公路客運之路線資料", "operationId": "InterCityBusApi_Route_2065", "parameters": [ { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRoute" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRoute" }, "xml": { "name": "ArrayOfBusRoute", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/Route/InterCity/{RouteName}": { "get": { "tags": [ "InterCityBus" ], "summary": "取得指定[路線名稱]的公路客運路線資料", "description": "公路客運之路線資料", "operationId": "InterCityBusApi_Route_2065_1", "parameters": [ { "name": "RouteName", "in": "path", "description": "繁體中文路線名稱,如'9001'", "required": true, "schema": { "title": "String", "type": "string", "xml": { } } }, { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRoute" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRoute" }, "xml": { "name": "ArrayOfBusRoute", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/Stop/InterCity": { "get": { "tags": [ "InterCityBus" ], "summary": "取得公路客運站牌資料", "description": "公路客運之站牌資料", "operationId": "InterCityBusApi_Stop_2066", "parameters": [ { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusStop" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusStop" }, "xml": { "name": "ArrayOfBusStop", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/Station/InterCity": { "get": { "tags": [ "InterCityBus" ], "summary": "取得公路客運站位資料", "description": "公路客運之各站牌所屬的站位資料", "operationId": "InterCityBusApi_Station_2067", "parameters": [ { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusStation" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusStation" }, "xml": { "name": "ArrayOfBusStation", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/StopOfRoute/InterCity": { "get": { "tags": [ "InterCityBus" ], "summary": "取得公路客運路線與站牌資料", "description": "公路客運之路線與站牌資料", "operationId": "InterCityBusApi_StopOfRoute_2068", "parameters": [ { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusStopOfRoute" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusStopOfRoute" }, "xml": { "name": "ArrayOfBusStopOfRoute", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/StopOfRoute/InterCity/{RouteName}": { "get": { "tags": [ "InterCityBus" ], "summary": "取得指定[路線名稱]的公路客運路線與站牌資料", "description": "公路客運之路線與站牌資料", "operationId": "InterCityBusApi_StopOfRoute_2068_1", "parameters": [ { "name": "RouteName", "in": "path", "description": "繁體中文路線名稱,如'9001'", "required": true, "schema": { "title": "String", "type": "string", "xml": { } } }, { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusStopOfRoute" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusStopOfRoute" }, "xml": { "name": "ArrayOfBusStopOfRoute", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/Schedule/InterCity": { "get": { "tags": [ "InterCityBus" ], "summary": "取得公路客運路線班表資料", "description": "公路客運之預定班表及班距資料。公路及國道客運多採用【班表】式時刻表", "operationId": "InterCityBusApi_Schedule_2069", "parameters": [ { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusSchedule" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusSchedule" }, "xml": { "name": "ArrayOfBusSchedule", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/Schedule/InterCity/{RouteName}": { "get": { "tags": [ "InterCityBus" ], "summary": "取得指定[路線名稱]的公路客運路線班表資料", "description": "公路客運之預定班表及班距資料。公路及國道客運多採用【班表】式時刻表", "operationId": "InterCityBusApi_Schedule_2069_1", "parameters": [ { "name": "RouteName", "in": "path", "description": "繁體中文路線名稱,如'9001'", "required": true, "schema": { "title": "String", "type": "string", "xml": { } } }, { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusSchedule" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusSchedule" }, "xml": { "name": "ArrayOfBusSchedule", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/News/InterCity": { "get": { "tags": [ "InterCityBus" ], "summary": "取得公路客運之最新消息", "description": "公路客運之最新消息", "operationId": "InterCityBusApi_News_2070", "parameters": [ { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusNews" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusNews" }, "xml": { "name": "ArrayOfBusNews", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/RouteFare/InterCity": { "get": { "tags": [ "InterCityBus" ], "summary": "取得公路客運之路線票價資料", "description": "公路客運之路線票價資料", "operationId": "InterCityBusApi_RouteFare_2072", "parameters": [ { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRouteFare" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRouteFare" }, "xml": { "name": "ArrayOfBusRouteFare", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/RouteFare/InterCity/{RouteName}": { "get": { "tags": [ "InterCityBus" ], "summary": "取得指定[路線名稱]的公路客運路線票價資料", "description": "公路客運之路線票價資料", "operationId": "InterCityBusApi_RouteFare_2072_1", "parameters": [ { "name": "RouteName", "in": "path", "description": "繁體中文路線名稱,如'9001'", "required": true, "schema": { "title": "String", "type": "string", "xml": { } } }, { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRouteFare" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRouteFare" }, "xml": { "name": "ArrayOfBusRouteFare", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/FirstLastTripInfo/InterCity": { "get": { "tags": [ "InterCityBus" ], "summary": "取得公路客運首末班車資料", "description": "公路客運之首末班車資料", "operationId": "InterCityBusApi_FirstLastTripInfo_2073", "parameters": [ { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusFirstLastTripInfo" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusFirstLastTripInfo" }, "xml": { "name": "ArrayOfBusFirstLastTripInfo", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/StationGroup/InterCity": { "get": { "tags": [ "InterCityBus" ], "summary": "取得公路客運組站位資料", "description": "公路客運之各站牌所屬的組站位資料", "operationId": "InterCityBusApi_StationGroup_2075", "parameters": [ { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusStationGroup" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusStationGroup" }, "xml": { "name": "ArrayOfBusStationGroup", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/Shape/InterCity": { "get": { "tags": [ "InterCityBus" ], "summary": "取得公路公車線型資料", "description": "公路客運之線型資料", "operationId": "InterCityBusApi_Shape_2076", "parameters": [ { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusShape" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusShape" }, "xml": { "name": "ArrayOfBusShape", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/Shape/InterCity/{RouteName}": { "get": { "tags": [ "InterCityBus" ], "summary": "取得指定[路線名稱]的公路公車線型資料", "description": "公路客運之線型資料", "operationId": "InterCityBusApi_Shape_2076_1", "parameters": [ { "name": "RouteName", "in": "path", "description": "繁體中文路線名稱,如'9001'", "required": true, "schema": { "title": "String", "type": "string", "xml": { } } }, { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusShape" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusShape" }, "xml": { "name": "ArrayOfBusShape", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/S2STravelTime/InterCity/{RouteID}": { "get": { "tags": [ "InterCityBus" ], "summary": "取得指定[路線代碼]的公路客運站間旅行時間資料", "description": "指定[路線代碼]的公路客運站間旅行時間資料", "operationId": "InterCityBusApi_S2STravelTimeDetail_2078", "parameters": [ { "name": "RouteID", "in": "path", "description": "路線代碼", "required": true, "schema": { "title": "String", "type": "string", "xml": { } } }, { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusS2STravelTime" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusS2STravelTime" }, "xml": { "name": "ArrayOfBusS2STravelTime", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/Alert/InterCity": { "get": { "tags": [ "InterCityBus" ], "summary": "取得公路客運之營運通阻資料", "description": "公路客運之營運通阻資料", "operationId": "InterCityBusApi_Alert_2079", "parameters": [ { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusAlert" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusAlert" }, "xml": { "name": "ArrayOfBusAlert", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/Vehicle": { "get": { "tags": [ "Bus(CityBus+InterCityBus)" ], "summary": "取得全臺公路客運與公路局代管縣市市區公車車輛資料", "description": "公路局代管縣市,包含:基隆市、新竹縣、新竹市、苗栗縣、彰化縣、南投縣、雲林縣、嘉義縣、嘉義市、屏東縣、宜蘭縣、花蓮縣、臺東縣、澎湖縣,若需六都市區公車車輛資料,請至縣市市區公車車輛資料取用", "operationId": "BusApi_Vehicle_2080", "parameters": [ { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusVehicleInfo" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusVehicleInfo" }, "xml": { "name": "ArrayOfBusVehicleInfo", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/RouteTPASS/City/{City}": { "get": { "tags": [ "CityBus" ], "summary": "取得指定[縣市]的市區公車路線適用通勤月票方案資料", "description": "市區公車之路線適用通勤月票方案資料", "operationId": "CityBusApi_RouteTPASS_2430", "parameters": [ { "name": "City", "in": "path", "description": "欲查詢縣市", "required": true, "schema": { "title": "String", "enum": [ "Keelung", "Hsinchu", "HsinchuCounty", "MiaoliCounty", "ChanghuaCounty", "NantouCounty", "YunlinCounty", "ChiayiCounty", "Chiayi", "PingtungCounty", "YilanCounty", "HualienCounty", "TaitungCounty", "PenghuCounty" ], "type": "string", "xml": { } } }, { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRouteTPASS" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRouteTPASS" }, "xml": { "name": "ArrayOfBusRouteTPASS", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/RouteTPASS/City/{City}/{RouteName}": { "get": { "tags": [ "CityBus" ], "summary": "取得指定[縣市],[路線名稱]的路線適用通勤月票方案資料", "description": "市區公車之路線適用通勤月票方案資料", "operationId": "CityBusApi_RouteTPASS_2430_1", "parameters": [ { "name": "City", "in": "path", "description": "欲查詢縣市", "required": true, "schema": { "title": "String", "enum": [ "Keelung", "Hsinchu", "HsinchuCounty", "MiaoliCounty", "ChanghuaCounty", "NantouCounty", "YunlinCounty", "ChiayiCounty", "Chiayi", "PingtungCounty", "YilanCounty", "HualienCounty", "TaitungCounty", "PenghuCounty" ], "type": "string", "xml": { } } }, { "name": "RouteName", "in": "path", "description": "繁體中文路線名稱,如'307'", "required": true, "schema": { "title": "String", "type": "string", "xml": { } } }, { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRouteTPASS" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRouteTPASS" }, "xml": { "name": "ArrayOfBusRouteTPASS", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/DailyTimeTable/City/{City}": { "get": { "tags": [ "CityBus" ], "summary": "取得指定[縣市]的市區公車每日營運時刻表資料", "description": "市區公車每日營運時刻表資料", "operationId": "CityBusApi_DailyTimeTable_2436", "parameters": [ { "name": "City", "in": "path", "description": "欲查詢縣市", "required": true, "schema": { "title": "String", "enum": [ "Taichung", "Taoyuan", "Keelung", "Hsinchu", "HsinchuCounty", "MiaoliCounty", "ChanghuaCounty", "NantouCounty", "YunlinCounty", "ChiayiCounty", "Chiayi", "PingtungCounty", "YilanCounty", "HualienCounty", "TaitungCounty", "Kaohsiung", "PenghuCounty" ], "type": "string", "xml": { } } }, { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusDailyTimeTable" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusDailyTimeTable" }, "xml": { "name": "ArrayOfBusDailyTimeTable", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/DailyTimeTable/City/{City}/{RouteName}": { "get": { "tags": [ "CityBus" ], "summary": "取得指定[縣市],[路線名稱]的市區公車每日營運時刻表資料", "description": "市區公車之每日營運時刻表資料", "operationId": "CityBusApi_DailyTimeTable_2436_1", "parameters": [ { "name": "City", "in": "path", "description": "欲查詢縣市", "required": true, "schema": { "title": "String", "enum": [ "Taichung", "Taoyuan", "Keelung", "Hsinchu", "HsinchuCounty", "MiaoliCounty", "ChanghuaCounty", "NantouCounty", "YunlinCounty", "ChiayiCounty", "Chiayi", "PingtungCounty", "YilanCounty", "HualienCounty", "TaitungCounty", "Kaohsiung", "PenghuCounty" ], "type": "string", "xml": { } } }, { "name": "RouteName", "in": "path", "description": "繁體中文路線名稱,如'307'", "required": true, "schema": { "title": "String", "type": "string", "xml": { } } }, { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusDailyTimeTable" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusDailyTimeTable" }, "xml": { "name": "ArrayOfBusDailyTimeTable", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/DailyStopTimeTable/City/{City}": { "get": { "tags": [ "CityBus" ], "summary": "取得指定[縣市]的市區公車每日站別時刻表資料", "description": "市區公車每日站別時刻表資料", "operationId": "CityBusApi_DailyStopTimeTable_2437", "parameters": [ { "name": "City", "in": "path", "description": "欲查詢縣市", "required": true, "schema": { "title": "String", "enum": [ "Taichung", "Taoyuan", "Kaohsiung" ], "type": "string", "xml": { } } }, { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusDailyStopTimeTable" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusDailyStopTimeTable" }, "xml": { "name": "ArrayOfBusDailyStopTimeTable", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/DailyStopTimeTable/City/{City}/{RouteName}": { "get": { "tags": [ "CityBus" ], "summary": "取得指定[縣市],[路線名稱]的市區公車每日站別時刻表資料", "description": "市區公車每日站別時刻表資料", "operationId": "CityBusApi_DailyStopTimeTable_2437_1", "parameters": [ { "name": "City", "in": "path", "description": "欲查詢縣市", "required": true, "schema": { "title": "String", "enum": [ "Taichung", "Taoyuan", "Kaohsiung" ], "type": "string", "xml": { } } }, { "name": "RouteName", "in": "path", "description": "繁體中文路線名稱,如'307'", "required": true, "schema": { "title": "String", "type": "string", "xml": { } } }, { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusDailyStopTimeTable" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusDailyStopTimeTable" }, "xml": { "name": "ArrayOfBusDailyStopTimeTable", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/DailyTimeTable/InterCity": { "get": { "tags": [ "InterCityBus" ], "summary": "取得公路客運每日營運時刻表資料", "description": "公路客運每日營運時刻表資料", "operationId": "InterCityBusApi_DailyTimeTable_2440", "parameters": [ { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusDailyTimeTable" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusDailyTimeTable" }, "xml": { "name": "ArrayOfBusDailyTimeTable", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/DailyTimeTable/InterCity/{RouteName}": { "get": { "tags": [ "InterCityBus" ], "summary": "取得指定[路線名稱]的公路客運每日營運時刻表資料", "description": "公路客運之每日營運時刻表資料", "operationId": "InterCityBusApi_DailyTimeTable_2440_1", "parameters": [ { "name": "RouteName", "in": "path", "description": "繁體中文路線名稱,如'9001'", "required": true, "schema": { "title": "String", "type": "string", "xml": { } } }, { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusDailyTimeTable" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusDailyTimeTable" }, "xml": { "name": "ArrayOfBusDailyTimeTable", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "304": { "description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content" }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/RouteTPASS/InterCity": { "get": { "tags": [ "InterCityBus" ], "summary": "取得公路客運之路線適用通勤月票方案資料", "description": "公路客運之路線適用通勤月票方案資料", "operationId": "InterCityBusApi_RouteTPASS_2441", "parameters": [ { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRouteTPASS" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRouteTPASS" }, "xml": { "name": "ArrayOfBusRouteTPASS", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } }, "/v2/Bus/RouteTPASS/InterCity/{RouteName}": { "get": { "tags": [ "InterCityBus" ], "summary": "取得指定[路線名稱]的公路客運路線適用通勤月票方案資料", "description": "公路客運之路線適用通勤月票方案資料", "operationId": "InterCityBusApi_RouteTPASS_2441_1", "parameters": [ { "name": "RouteName", "in": "path", "description": "繁體中文路線名稱,如'9001'", "required": true, "schema": { "title": "String", "type": "string", "xml": { } } }, { "name": "$select", "in": "query", "description": "挑選", "schema": { "type": "string" } }, { "name": "$filter", "in": "query", "description": "過濾", "schema": { "type": "string" } }, { "name": "$orderby", "in": "query", "description": "排序", "schema": { "type": "string" } }, { "name": "$top", "in": "query", "description": "取前幾筆", "schema": { "type": "integer", "default": 30 } }, { "name": "$skip", "in": "query", "description": "跳過前幾筆", "schema": { "type": "string" } }, { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } }, { "name": "$format", "in": "query", "description": "指定來源格式", "required": true, "schema": { "enum": [ "JSON", "XML" ], "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRouteTPASS" } } }, "application/xml": { "schema": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRouteTPASS" }, "xml": { "name": "ArrayOfBusRouteTPASS", "namespace": "https://ptx.transportdata.tw/standard/schema/", "wrapped": true } } } } }, "299": { "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth" } } } } } } } }, "components": { "schemas": { "PTX.Service.DTO.Bus.Specification.V2.BusA1Data": { "title": "BusA1Data", "required": [ "GPSTime", "PlateNumb", "UpdateTime" ], "type": "object", "properties": { "PlateNumb": { "title": "String", "minLength": 1, "type": "string", "description": "車牌號碼", "xml": { "name": "PlateNumb" } }, "OperatorID": { "title": "String", "type": "string", "description": "營運業者代碼", "nullable": true, "xml": { "name": "OperatorID" } }, "OperatorNo": { "title": "String", "type": "string", "description": "營運業者編號[交通部票證資料系統定義]", "nullable": true, "xml": { "name": "OperatorNo" } }, "RouteUID": { "title": "String", "type": "string", "description": "路線唯一識別代碼,規則為 {業管機關簡碼} + {RouteID},其中 {業管機關簡碼} 可於Authority API中的AuthorityCode欄位查詢", "nullable": true, "xml": { "name": "RouteUID" } }, "RouteID": { "title": "String", "type": "string", "description": "地區既用中之路線代碼(為原資料內碼)", "nullable": true, "xml": { "name": "RouteID" } }, "RouteName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType" } ], "description": "路線名稱", "nullable": true, "xml": { "name": "NameType" } }, "SubRouteUID": { "title": "String", "type": "string", "description": "子路線唯一識別代碼,規則為 {業管機關簡碼} + {SubRouteID},其中 {業管機關簡碼} 可於Authority API中的AuthorityCode欄位查詢", "nullable": true, "xml": { "name": "SubRouteUID" } }, "SubRouteID": { "title": "String", "type": "string", "description": "地區既用中之子路線代碼(為原資料內碼)", "nullable": true, "xml": { "name": "SubRouteID" } }, "SubRouteName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType" } ], "description": "子路線名稱", "nullable": true, "xml": { "name": "NameType" } }, "Direction": { "title": "Int32", "type": "integer", "description": "去返程 : [0:'去程',1:'返程',2:'迴圈',10:'循環線',255:'未知']", "format": "int32", "nullable": true }, "BusPosition": { "title": "PointType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.PointType" } ], "description": "車輛位置經度", "nullable": true, "xml": { "name": "PointType" } }, "Speed": { "type": "number", "description": "行駛速度(kph)", "format": "double", "nullable": true }, "Azimuth": { "type": "number", "description": "方位角", "format": "double", "nullable": true }, "DutyStatus": { "title": "Int32", "type": "integer", "description": "勤務狀態 : [0:'正常',1:'開始',2:'結束']", "format": "int32", "nullable": true }, "BusStatus": { "title": "Int32", "type": "integer", "description": "行車狀況 : [0:'正常',1:'車禍',2:'故障',3:'塞車',4:'緊急求援',5:'加油',90:'不明',91:'去回不明',98:'偏移路線',99:'非營運狀態',100:'客滿',101:'包車出租',255:'未知']", "format": "int32", "nullable": true }, "MessageType": { "title": "Int32", "type": "integer", "description": "資料型態種類 : [0:'未知',1:'定期',2:'非定期']", "format": "int32", "nullable": true }, "GPSTime": { "title": "DateTime", "type": "string", "description": "車機時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "TransTime": { "type": "string", "description": "車機資料傳輸時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)[多數單位沒有提供此欄位資訊]", "format": "date-time", "nullable": true }, "SrcRecTime": { "type": "string", "description": "來源端平台接收時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time", "nullable": true }, "SrcTransTime": { "type": "string", "description": "來源端平台資料傳出時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)[公總使用動態即時推播故有提供此欄位, 而非公總系統因使用整包資料更新, 故沒有提供此欄位]", "format": "date-time", "nullable": true }, "SrcUpdateTime": { "type": "string", "description": "來源端平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)[公總使用動態即時推播故沒有提供此欄位, 而非公總系統因提供整包資料更新, 故有提供此欄]", "format": "date-time", "nullable": true }, "UpdateTime": { "title": "DateTime", "type": "string", "description": "本平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" } }, "additionalProperties": false, "description": "定時車機資料型別", "xml": { "name": "BusA1Data" } }, "PTX.Service.DTO.Bus.Specification.V2.BusA1Data0": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA1Data" }, "PTX.Service.DTO.Shared.Specification.V2.Base.NameType": { "title": "NameType", "type": "object", "properties": { "Zh_tw": { "title": "String", "type": "string", "description": "中文繁體名稱", "nullable": true, "xml": { "name": "Zh_tw" } }, "En": { "title": "String", "type": "string", "description": "英文名稱", "nullable": true, "xml": { "name": "En" } } }, "additionalProperties": false, "description": "名稱資料型別", "xml": { "name": "NameType" } }, "PTX.Service.DTO.Shared.Specification.V2.Base.PointType": { "title": "PointType", "type": "object", "properties": { "PositionLon": { "type": "number", "description": "位置經度(WGS84)", "format": "double", "nullable": true }, "PositionLat": { "type": "number", "description": "位置緯度(WGS84)", "format": "double", "nullable": true }, "GeoHash": { "title": "String", "type": "string", "description": "地理空間編碼", "nullable": true, "xml": { "name": "GeoHash" } } }, "additionalProperties": false, "description": "座標資料型別", "xml": { "name": "PointType" } }, "PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth": { "title": "DisplayHealth", "required": [ "Inbound", "Outbound", "ServiceID", "ServiceName" ], "type": "object", "properties": { "ServiceID": { "title": "String", "minLength": 1, "type": "string", "description": "API服務代碼", "xml": { "name": "ServiceID" } }, "ServiceName": { "title": "String", "minLength": 1, "type": "string", "description": "API服務中文名稱", "xml": { "name": "ServiceName" } }, "Inbound": { "title": "Inbound", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.Inbound" } ], "description": "本平台資料來源轉入狀態", "nullable": true, "xml": { "name": "Inbound" } }, "Outbound": { "title": "Outbound", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.Outbound" } ], "description": "本平台API狀態", "nullable": true, "xml": { "name": "Outbound" } } }, "additionalProperties": false, "description": "API服務健康狀態", "xml": { "name": "DisplayHealth" } }, "PTX.Service.DTO.Shared.Specification.V3.Base.Inbound": { "title": "Inbound", "required": [ "CheckTime", "Status" ], "type": "object", "properties": { "CheckTime": { "title": "DateTime", "type": "string", "description": "檢核時間", "format": "date-time" }, "Status": { "title": "Int32", "type": "integer", "description": "檢核結果狀態 : [0:'失敗',1:'成功',2:'資料清洗中']", "format": "int32" }, "Reason": { "title": "String", "type": "string", "description": "檢核失敗原因", "nullable": true, "xml": { "name": "Reason" } } }, "additionalProperties": false, "description": "本平台資料來源轉入狀態", "xml": { "name": "Inbound" } }, "PTX.Service.DTO.Shared.Specification.V3.Base.Outbound": { "title": "Outbound", "required": [ "CheckTime", "Status" ], "type": "object", "properties": { "CheckTime": { "title": "DateTime", "type": "string", "description": "檢核時間", "format": "date-time" }, "Status": { "title": "Int32", "type": "integer", "description": "檢核結果狀態 : [0:'失敗',1:'成功',2:'資料清洗中']", "format": "int32" }, "Reason": { "title": "String", "type": "string", "description": "檢核失敗原因", "nullable": true, "xml": { "name": "Reason" } } }, "additionalProperties": false, "description": "本平台API狀態", "xml": { "name": "Outbound" } }, "PTX.Service.DTO.Bus.Specification.V2.BusA2Data": { "title": "BusA2Data", "required": [ "Direction", "GPSTime", "PlateNumb", "TripStartTimeType", "UpdateTime" ], "type": "object", "properties": { "PlateNumb": { "title": "String", "minLength": 1, "type": "string", "description": "車牌號碼", "xml": { "name": "PlateNumb" } }, "OperatorID": { "title": "String", "type": "string", "description": "營運業者代碼", "nullable": true, "xml": { "name": "OperatorID" } }, "OperatorNo": { "title": "String", "type": "string", "description": "營運業者編號[交通部票證資料系統定義]", "nullable": true, "xml": { "name": "OperatorNo" } }, "RouteUID": { "title": "String", "type": "string", "description": "路線唯一識別代碼,規則為 {業管機關簡碼} + {RouteID},其中 {業管機關簡碼} 可於Authority API中的AuthorityCode欄位查詢", "nullable": true, "xml": { "name": "RouteUID" } }, "RouteID": { "title": "String", "type": "string", "description": "地區既用中之路線代碼(為原資料內碼)", "nullable": true, "xml": { "name": "RouteID" } }, "RouteName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType" } ], "description": "路線名", "nullable": true, "xml": { "name": "NameType" } }, "SubRouteUID": { "title": "String", "type": "string", "description": "子路線唯一識別代碼,規則為 {業管機關簡碼} + {SubRouteID},其中 {業管機關簡碼} 可於Authority API中的AuthorityCode欄位查詢", "nullable": true, "xml": { "name": "SubRouteUID" } }, "SubRouteID": { "title": "String", "type": "string", "description": "地區既用中之子路線代碼(為原資料內碼)", "nullable": true, "xml": { "name": "SubRouteID" } }, "SubRouteName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType" } ], "description": "子路線名稱", "nullable": true, "xml": { "name": "NameType" } }, "Direction": { "title": "Int32", "type": "integer", "description": "去返程 : [0:'去程',1:'返程',2:'迴圈',10:'循環線',255:'未知']", "format": "int32" }, "StopUID": { "title": "String", "type": "string", "description": "站牌唯一識別代碼,規則為 {業管機關簡碼} + {StopID},其中 {業管機關簡碼} 可於Authority API中的AuthorityCode欄位查詢", "nullable": true, "xml": { "name": "StopUID" } }, "StopID": { "title": "String", "type": "string", "description": "地區既用中之站牌代號(為原資料內碼)", "nullable": true, "xml": { "name": "StopID" } }, "StopName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType" } ], "description": "站牌名", "nullable": true, "xml": { "name": "NameType" } }, "StopSequence": { "title": "Int32", "type": "integer", "description": "路線經過站牌之順序", "format": "int32" }, "MessageType": { "title": "Int32", "type": "integer", "description": "資料型態種類 : [0:'未知',1:'定期',2:'非定期']", "format": "int32", "nullable": true }, "DutyStatus": { "title": "Int32", "type": "integer", "description": "勤務狀態 : [0:'正常',1:'開始',2:'結束']", "format": "int32", "nullable": true }, "BusStatus": { "title": "Int32", "type": "integer", "description": "行車狀況 : [0:'正常',1:'車禍',2:'故障',3:'塞車',4:'緊急求援',5:'加油',90:'不明',91:'去回不明',98:'偏移路線',99:'非營運狀態',100:'客滿',101:'包車出租',255:'未知']", "format": "int32", "nullable": true }, "A2EventType": { "title": "Int32", "type": "integer", "description": "進站離站 : [0:'離站',1:'進站']", "format": "int32", "nullable": true }, "GPSTime": { "title": "DateTime", "type": "string", "description": "車機時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz) [觸發到離站的GPS時間]", "format": "date-time" }, "TripStartTimeType": { "title": "Int32", "type": "integer", "description": "班次發車時間類型 : [0:'實際發車時間',1:'預估發車時間',2:'無法推估發車時間']", "format": "int32" }, "TripStartTime": { "title": "String", "type": "string", "description": "首站發車時間(yyyy-MM-ddTHH:mm:sszzz)", "nullable": true, "xml": { "name": "TripStartTime" } }, "TransTime": { "type": "string", "description": "車機資料傳輸時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)[多數單位沒有提供此欄位資訊]", "format": "date-time", "nullable": true }, "SrcRecTime": { "type": "string", "description": "來源端平台接收時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time", "nullable": true }, "SrcTransTime": { "type": "string", "description": "來源端平台資料傳出時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)[公總使用動態即時推播故有提供此欄位, 而非公總系統因使用整包資料更新, 故沒有提供此欄位]", "format": "date-time", "nullable": true }, "SrcUpdateTime": { "type": "string", "description": "來源端平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)[公總使用動態即時推播故沒有提供此欄位, 而非公總系統因提供整包資料更新, 故有提供此欄]", "format": "date-time", "nullable": true }, "UpdateTime": { "title": "DateTime", "type": "string", "description": "本平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" } }, "additionalProperties": false, "description": "定點車機資料型別", "xml": { "name": "BusA2Data" } }, "PTX.Service.DTO.Bus.Specification.V2.BusA2Data1": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA2Data" }, "PTX.Service.DTO.Bus.Specification.V2.BusN1EstimateTime": { "title": "BusN1EstimateTime", "required": [ "Direction", "UpdateTime" ], "type": "object", "properties": { "PlateNumb": { "title": "String", "type": "string", "description": "車牌號碼 [値為値為-1時,表示目前該站位無車輛行駛]", "nullable": true, "xml": { "name": "PlateNumb" } }, "StopUID": { "title": "String", "type": "string", "description": "站牌唯一識別代碼,規則為 {業管機關簡碼} + {StopID},其中 {業管機關簡碼} 可於Authority API中的AuthorityCode欄位查詢", "nullable": true, "xml": { "name": "StopUID" } }, "StopID": { "title": "String", "type": "string", "description": "地區既用中之站牌代碼(為原資料內碼)", "nullable": true, "xml": { "name": "StopID" } }, "StopName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType" } ], "description": "站牌名", "nullable": true, "xml": { "name": "NameType" } }, "RouteUID": { "title": "String", "type": "string", "description": "路線唯一識別代碼,規則為 {業管機關代碼} + {RouteID},其中 {業管機關代碼} 可於Authority API中的AuthorityCode欄位查詢", "nullable": true, "xml": { "name": "RouteUID" } }, "RouteID": { "title": "String", "type": "string", "description": "地區既用中之路線代碼(為原資料內碼)", "nullable": true, "xml": { "name": "RouteID" } }, "RouteName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType" } ], "description": "路線名稱", "nullable": true, "xml": { "name": "NameType" } }, "SubRouteUID": { "title": "String", "type": "string", "description": "子路線唯一識別代碼,規則為 {業管機關簡碼} + {SubRouteID},其中 {業管機關簡碼} 可於Authority API中的AuthorityCode欄位查詢", "nullable": true, "xml": { "name": "SubRouteUID" } }, "SubRouteID": { "title": "String", "type": "string", "description": "地區既用中之子路線代碼(為原資料內碼)", "nullable": true, "xml": { "name": "SubRouteID" } }, "SubRouteName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType" } ], "description": "子路線名稱", "nullable": true, "xml": { "name": "NameType" } }, "Direction": { "title": "Int32", "type": "integer", "description": "去返程(該方向指的是此車牌車輛目前所在路線的去返程方向,非指站站牌所在路線的去返程方向,使用時請加值業者多加注意) : [0:'去程',1:'返程',2:'迴圈',10:'循環線',255:'未知']", "format": "int32" }, "EstimateTime": { "type": "integer", "description": "到站時間預估(秒) [當StopStatus値為2~4或PlateNumb値為-1時,EstimateTime値為null; 當StopStatus値為1時, EstimateTime値多數為null,僅部分路線因有固定發車時間,故EstimateTime有値; 當StopStatus値為0時,EstimateTime有値。]", "format": "int32", "nullable": true }, "ScheduledTime": { "title": "String", "type": "string", "description": "預排班表時間 HH:mm", "nullable": true, "xml": { "name": "ScheduledTime" } }, "StopCountDown": { "type": "integer", "description": "車輛距離本站站數", "format": "int32", "nullable": true }, "CurrentStop": { "title": "String", "type": "string", "description": "車輛目前所在站牌代碼", "nullable": true, "xml": { "name": "CurrentStop" } }, "DestinationStop": { "title": "String", "type": "string", "description": "車輛目的站牌代碼", "nullable": true, "xml": { "name": "DestinationStop" } }, "StopSequence": { "type": "integer", "description": "路線經過站牌之順序", "format": "int32", "nullable": true }, "StopStatus": { "title": "Int32", "type": "integer", "description": "車輛狀態備註 : [0:'正常',1:'尚未發車',2:'交管不停靠',3:'末班車已過',4:'今日未營運']", "format": "int32", "nullable": true }, "MessageType": { "title": "Int32", "type": "integer", "description": "資料型態種類 : [0:'未知',1:'定期',2:'非定期']", "format": "int32", "nullable": true }, "NextBusTime": { "type": "string", "description": "下一班公車到達時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time", "nullable": true }, "IsLastBus": { "type": "boolean", "description": "是否為末班車", "nullable": true }, "Estimates": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.N1.Estimate" }, "description": "到站時間預估", "nullable": true, "xml": { "name": "Estimate" } }, "DataTime": { "type": "string", "description": "系統演算該筆預估到站資料的時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)[目前僅公總提供此欄位資訊]", "format": "date-time", "nullable": true }, "TransTime": { "type": "string", "description": "車機資料傳輸時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz))[該欄位在N1資料中無意義]", "format": "date-time", "nullable": true }, "SrcRecTime": { "type": "string", "description": "來源端平台接收時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz))[該欄位在N1資料中無意義]", "format": "date-time", "nullable": true }, "SrcTransTime": { "type": "string", "description": "來源端平台資料傳出時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)[公總使用動態即時推播故有提供此欄位, 而非公總系統因使用整包資料更新, 故沒有提供此欄位]", "format": "date-time", "nullable": true }, "SrcUpdateTime": { "type": "string", "description": "來源端平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)[公總使用動態即時推播故沒有提供此欄位, 而非公總系統因提供整包資料更新, 故有提供此欄]", "format": "date-time", "nullable": true }, "UpdateTime": { "title": "DateTime", "type": "string", "description": "本平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" } }, "additionalProperties": false, "xml": { "name": "BusN1EstimateTime" } }, "PTX.Service.DTO.Bus.Specification.V2.BusN1EstimateTime2": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusN1EstimateTime" }, "PTX.Service.DTO.Bus.Specification.V2.N1.Estimate": { "title": "Estimate", "type": "object", "properties": { "PlateNumb": { "title": "String", "type": "string", "description": "車輛車牌號碼", "nullable": true, "xml": { "name": "PlateNumb" } }, "EstimateTime": { "type": "integer", "description": "車輛之到站時間預估(秒)", "format": "int32", "nullable": true }, "IsLastBus": { "type": "boolean", "description": "是否為末班車", "nullable": true }, "VehicleStopStatus": { "title": "Int32", "type": "integer", "description": "車輛於該站之進離站狀態 : [0:'離站',1:'進站']", "format": "int32", "nullable": true } }, "additionalProperties": false, "xml": { "name": "Estimate" } }, "PTX.Service.DTO.Bus.Specification.V2.BusVersion": { "title": "BusVersion", "required": [ "UpdateCheckTime", "UpdateTime", "VersionID" ], "type": "object", "properties": { "VersionID": { "title": "Int32", "type": "integer", "description": "資料版本編號", "format": "int32" }, "UpdateTime": { "title": "DateTime", "type": "string", "description": "資料更新日期時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "UpdateCheckTime": { "title": "DateTime", "type": "string", "description": "此資料版本最後檢查更新之日期時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" } }, "additionalProperties": false, "description": "公車版本資料型別", "xml": { "name": "BusVersion" } }, "PTX.Service.DTO.Shared.Specification.V2.Base.Operator": { "title": "Operator", "required": [ "AuthorityCode", "OperatorCode", "OperatorID", "OperatorName", "OperatorNo", "ProviderID", "UpdateTime" ], "type": "object", "properties": { "ProviderID": { "title": "String", "minLength": 1, "type": "string", "description": "資料提供平台代碼", "xml": { "name": "ProviderID" } }, "OperatorID": { "title": "String", "minLength": 1, "type": "string", "description": "營運業者代碼", "xml": { "name": "OperatorID" } }, "OperatorName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType" } ], "description": "營運業者名稱", "xml": { "name": "NameType" } }, "OperatorPhone": { "title": "String", "type": "string", "description": "營運業者連絡電話", "nullable": true, "xml": { "name": "OperatorPhone" } }, "OperatorEmail": { "title": "String", "type": "string", "description": "營運業者電子信箱", "nullable": true, "xml": { "name": "OperatorEmail" } }, "OperatorUrl": { "title": "String", "type": "string", "description": "營運業者網址鏈結", "nullable": true, "xml": { "name": "OperatorUrl" } }, "ReservationUrl": { "title": "String", "type": "string", "description": "訂票網址鏈結", "nullable": true, "xml": { "name": "ReservationUrl" } }, "ReservationPhone": { "title": "String", "type": "string", "description": "訂票連絡電話", "nullable": true, "xml": { "name": "ReservationPhone" } }, "OperatorCode": { "title": "String", "type": "string", "description": "營運業者簡碼", "nullable": true, "xml": { "name": "OperatorCode" } }, "AuthorityCode": { "title": "String", "minLength": 1, "type": "string", "description": "營運業者業管機關簡碼(對於於公路客運/國道客運而言為THB)", "xml": { "name": "AuthorityCode" } }, "SubAuthorityCode": { "title": "String", "type": "string", "description": "營運業者所屬業管子機關簡碼(對於公路客運/國道客運路線而言為區監理所如THB-VO10-1..等)", "nullable": true, "xml": { "name": "SubAuthorityCode" } }, "OperatorNo": { "title": "String", "minLength": 1, "type": "string", "description": "營運業者編號[交通部票證資料系統定義]", "xml": { "name": "OperatorNo" } }, "UpdateTime": { "title": "DateTime", "type": "string", "description": "資料更新日期時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" } }, "additionalProperties": false, "description": "營運業者資料型別", "xml": { "name": "Operator" } }, "PTX.Service.DTO.Shared.Specification.V2.Base.Operator3": { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.Operator" }, "PTX.Service.DTO.Bus.Specification.V2.BusRoute": { "title": "BusRoute", "required": [ "AuthorityID", "BusRouteType", "HasSubRoutes", "Operators", "ProviderID", "RouteID", "RouteName", "RouteUID", "UpdateTime", "VersionID" ], "type": "object", "properties": { "RouteUID": { "title": "String", "minLength": 1, "type": "string", "description": "路線唯一識別代碼,規則為 {業管機關簡碼} + {RouteID},其中 {業管機關簡碼} 可於Authority API中的AuthorityCode欄位查詢", "xml": { "name": "RouteUID" } }, "RouteID": { "title": "String", "minLength": 1, "type": "string", "description": "地區既用中之路線代碼(為原資料內碼)", "xml": { "name": "RouteID" } }, "HasSubRoutes": { "title": "Boolean", "type": "boolean", "description": "實際上是否有多條附屬路線。(此欄位值與SubRoutes結構並無強烈的絕對關聯。詳細說明請參閱swagger上方的【資料服務使用注意事項】)" }, "Operators": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.Embedded.RouteOperator" }, "description": "營運業者", "xml": { "name": "Operator" } }, "AuthorityID": { "title": "String", "minLength": 1, "type": "string", "description": "業管機關代碼", "xml": { "name": "AuthorityID" } }, "ProviderID": { "title": "String", "minLength": 1, "type": "string", "description": "資料提供平台代碼", "xml": { "name": "ProviderID" } }, "SubRoutes": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusSubRoute" }, "description": "附屬路線資料(如果原始資料並無提供附屬路線ID,而本平台基於跨來源資料之一致性,會以SubRouteID=RouteID產製一份相對應的附屬路線資料(若有去返程,則會有兩筆))", "nullable": true, "xml": { "name": "SubRoute" } }, "BusRouteType": { "title": "Int32", "type": "integer", "description": "公車路線類別 : [11:'市區公車',12:'公路客運',13:'國道客運',14:'接駁車']", "format": "int32" }, "RouteName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType" } ], "description": "路線名稱", "xml": { "name": "NameType" } }, "DepartureStopNameZh": { "title": "String", "type": "string", "description": "起站中文名稱", "nullable": true, "xml": { "name": "DepartureStopNameZh" } }, "DepartureStopNameEn": { "title": "String", "type": "string", "description": "起站英文名稱", "nullable": true, "xml": { "name": "DepartureStopNameEn" } }, "DestinationStopNameZh": { "title": "String", "type": "string", "description": "終點站中文名稱", "nullable": true, "xml": { "name": "DestinationStopNameZh" } }, "DestinationStopNameEn": { "title": "String", "type": "string", "description": "終點站英文名稱", "nullable": true, "xml": { "name": "DestinationStopNameEn" } }, "TicketPriceDescriptionZh": { "title": "String", "type": "string", "description": "票價中文敘述", "nullable": true, "xml": { "name": "TicketPriceDescriptionZh" } }, "TicketPriceDescriptionEn": { "title": "String", "type": "string", "description": "票價英文敘述", "nullable": true, "xml": { "name": "TicketPriceDescriptionEn" } }, "FareBufferZoneDescriptionZh": { "title": "String", "type": "string", "description": "收費緩衝區中文敘述", "nullable": true, "xml": { "name": "FareBufferZoneDescriptionZh" } }, "FareBufferZoneDescriptionEn": { "title": "String", "type": "string", "description": "收費緩衝區英文敘述", "nullable": true, "xml": { "name": "FareBufferZoneDescriptionEn" } }, "RouteMapImageUrl": { "title": "String", "type": "string", "description": "路線簡圖網址", "nullable": true, "xml": { "name": "RouteMapImageUrl" } }, "City": { "title": "String", "type": "string", "description": "路線權管所屬縣市(相當於市區公車API的City參數)[若為公路/國道客運路線則為空值]", "nullable": true, "xml": { "name": "City" } }, "CityCode": { "title": "String", "type": "string", "description": "路線權管所屬縣市之代碼(國際ISO 3166-2 三碼城市代碼)[若為公路/國道客運路線則為空值]", "nullable": true, "xml": { "name": "CityCode" } }, "UpdateTime": { "title": "DateTime", "type": "string", "description": "資料更新日期時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "VersionID": { "title": "Int32", "type": "integer", "description": "資料版本編號", "format": "int32" } }, "additionalProperties": false, "description": "路線資料型別", "xml": { "name": "BusRoute" } }, "PTX.Service.DTO.Bus.Specification.V2.BusRoute4": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRoute" }, "PTX.Service.DTO.Bus.Specification.V2.Embedded.RouteOperator": { "title": "RouteOperator", "required": [ "OperatorID", "OperatorName", "OperatorNo" ], "type": "object", "properties": { "OperatorID": { "title": "String", "minLength": 1, "type": "string", "description": "營運業者代碼", "xml": { "name": "OperatorID" } }, "OperatorName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType" } ], "description": "營運業者名稱", "xml": { "name": "NameType" } }, "OperatorCode": { "title": "String", "type": "string", "description": "營運業者簡碼", "nullable": true, "xml": { "name": "OperatorCode" } }, "OperatorNo": { "title": "String", "minLength": 1, "type": "string", "description": "營運業者編號[交通部票證資料系統定義]", "xml": { "name": "OperatorNo" } } }, "additionalProperties": false, "description": "營運業者資訊", "xml": { "name": "RouteOperator" } }, "PTX.Service.DTO.Bus.Specification.V2.BusSubRoute": { "title": "BusSubRoute", "required": [ "Direction", "OperatorIDs", "SubRouteID", "SubRouteName", "SubRouteUID" ], "type": "object", "properties": { "SubRouteUID": { "title": "String", "minLength": 1, "type": "string", "description": "附屬路線唯一識別代碼,規則為 {業管機關簡碼} + {SubRouteID},其中 {業管機關簡碼} 可於Authority API中的AuthorityCode欄位查詢", "xml": { "name": "SubRouteUID" } }, "SubRouteID": { "title": "String", "minLength": 1, "type": "string", "description": "地區既用中之附屬路線代碼(為原資料內碼)", "xml": { "name": "SubRouteID" } }, "OperatorIDs": { "title": "Array", "type": "array", "items": { "title": "String", "type": "string", "xml": { } }, "description": "營運業者代碼", "xml": { "name": "List`1" } }, "SubRouteName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType" } ], "description": "附屬路線名稱", "xml": { "name": "NameType" } }, "Headsign": { "title": "String", "type": "string", "description": "車頭描述", "nullable": true, "xml": { "name": "Headsign" } }, "HeadsignEn": { "title": "String", "type": "string", "description": "車頭英文描述", "nullable": true, "xml": { "name": "HeadsignEn" } }, "Direction": { "title": "Int32", "type": "integer", "description": "去返程 : [0:'去程',1:'返程',2:'迴圈',10:'循環線',255:'未知']", "format": "int32" }, "FirstBusTime": { "title": "String", "type": "string", "description": "平日第一班發車時間", "nullable": true, "xml": { "name": "FirstBusTime" } }, "LastBusTime": { "title": "String", "type": "string", "description": "平日返程第一班發車時間", "nullable": true, "xml": { "name": "LastBusTime" } }, "HolidayFirstBusTime": { "title": "String", "type": "string", "description": "假日去程第一班發車時間", "nullable": true, "xml": { "name": "HolidayFirstBusTime" } }, "HolidayLastBusTime": { "title": "String", "type": "string", "description": "假日返程第一班發車時間", "nullable": true, "xml": { "name": "HolidayLastBusTime" } }, "DepartureStopNameZh": { "title": "String", "type": "string", "description": "起站中文名稱", "nullable": true, "xml": { "name": "DepartureStopNameZh" } }, "DepartureStopNameEn": { "title": "String", "type": "string", "description": "起站英文名稱", "nullable": true, "xml": { "name": "DepartureStopNameEn" } }, "DestinationStopNameZh": { "title": "String", "type": "string", "description": "終點站中文名稱", "nullable": true, "xml": { "name": "DestinationStopNameZh" } }, "DestinationStopNameEn": { "title": "String", "type": "string", "description": "終點站英文名稱", "nullable": true, "xml": { "name": "DestinationStopNameEn" } } }, "additionalProperties": false, "description": "附屬路線資料型別", "xml": { "name": "BusSubRoute" } }, "PTX.Service.DTO.Bus.Specification.V2.BusStop": { "title": "BusStop", "required": [ "AuthorityID", "StationGroupID", "StopID", "StopName", "StopPosition", "StopUID", "UpdateTime", "VersionID" ], "type": "object", "properties": { "StopUID": { "title": "String", "minLength": 1, "type": "string", "description": "站牌唯一識別代碼,規則為 {業管機關簡碼} + {StopID},其中 {業管機關簡碼} 可於Authority API中的AuthorityCode欄位查詢", "xml": { "name": "StopUID" } }, "StopID": { "title": "String", "minLength": 1, "type": "string", "description": "地區既用中之站牌代碼(為原資料內碼)", "xml": { "name": "StopID" } }, "AuthorityID": { "title": "String", "minLength": 1, "type": "string", "description": "業管機關代碼", "xml": { "name": "AuthorityID" } }, "StopName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType" } ], "description": "站牌名稱", "xml": { "name": "NameType" } }, "StopPosition": { "title": "PointType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.PointType" } ], "description": "站牌位置", "xml": { "name": "PointType" } }, "StopAddress": { "title": "String", "type": "string", "description": "站牌地址", "nullable": true, "xml": { "name": "StopAddress" } }, "Bearing": { "title": "String", "type": "string", "description": "方位角,E:東行;W:西行;S:南行;N:北行;SE:東南行;NE:東北行;SW:西南行;NW:西北行", "nullable": true, "xml": { "name": "Bearing" } }, "StationID": { "title": "String", "type": "string", "description": "站牌所屬的站位ID", "nullable": true, "xml": { "name": "StationID" } }, "StationGroupID": { "title": "String", "minLength": 1, "type": "string", "description": "站牌所屬的組站位ID", "xml": { "name": "StationGroupID" } }, "StopDescription": { "title": "String", "type": "string", "description": "站牌詳細說明描述", "nullable": true, "xml": { "name": "StopDescription" } }, "City": { "title": "String", "type": "string", "description": "站牌權管所屬縣市(相當於市區公車API的City參數)[若為公路/國道客運路線則為空值]", "nullable": true, "xml": { "name": "City" } }, "CityCode": { "title": "String", "type": "string", "description": "站牌權管所屬縣市之代碼(國際ISO 3166-2 三碼城市代碼)[若為公路/國道客運路線則為空值]", "nullable": true, "xml": { "name": "CityCode" } }, "LocationCityCode": { "title": "String", "type": "string", "description": "站牌位置縣市之代碼(國際ISO 3166-2 三碼城市代碼)[若為公路/國道客運路線則為空值]", "nullable": true, "xml": { "name": "LocationCityCode" } }, "UpdateTime": { "title": "DateTime", "type": "string", "description": "資料更新日期時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "VersionID": { "title": "Int32", "type": "integer", "description": "資料版本編號", "format": "int32" } }, "additionalProperties": false, "description": "站牌/位資料型別", "xml": { "name": "BusStop" } }, "PTX.Service.DTO.Bus.Specification.V2.BusStop5": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusStop" }, "PTX.Service.DTO.Bus.Specification.V2.BusStation": { "title": "BusStation", "required": [ "StationGroupID", "StationID", "StationName", "StationPosition", "StationUID", "UpdateTime", "VersionID" ], "type": "object", "properties": { "StationUID": { "title": "String", "minLength": 1, "type": "string", "description": "站位唯一識別代碼,規則為 {業管機關簡碼} + {StationID},其中 {業管機關簡碼} 可於Authority API中的AuthorityCode欄位查詢", "xml": { "name": "StationUID" } }, "StationID": { "title": "String", "minLength": 1, "type": "string", "description": "站位代碼", "xml": { "name": "StationID" } }, "StationName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType" } ], "description": "站位名稱", "xml": { "name": "NameType" } }, "StationPosition": { "title": "PointType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.PointType" } ], "description": "站位位置", "xml": { "name": "PointType" } }, "StationAddress": { "title": "String", "type": "string", "description": "站位地址", "nullable": true, "xml": { "name": "StationAddress" } }, "StationGroupID": { "title": "String", "minLength": 1, "type": "string", "description": "站牌所屬的組站位ID", "xml": { "name": "StationGroupID" } }, "Stops": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.StationStop" }, "description": "站牌與所行經此站牌之路線列表(資料會對路線展開,因此可能會有重複的站牌資料)", "nullable": true, "xml": { "name": "Stop" } }, "LocationCityCode": { "title": "String", "type": "string", "description": "站牌位置縣市之代碼(國際ISO 3166-2 三碼城市代碼)[若為公路/國道客運路線則為空值]", "nullable": true, "xml": { "name": "LocationCityCode" } }, "Bearing": { "title": "String", "type": "string", "description": "方位角,E:東行;W:西行;S:南行;N:北行;SE:東南行;NE:東北行;SW:西南行;NW:西北行", "nullable": true, "xml": { "name": "Bearing" } }, "UpdateTime": { "title": "DateTime", "type": "string", "description": "資料更新日期時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "VersionID": { "title": "Int32", "type": "integer", "description": "資料版本編號", "format": "int32" } }, "additionalProperties": false, "description": "站牌/位資料型別", "xml": { "name": "BusStation" } }, "PTX.Service.DTO.Bus.Specification.V2.BusStation6": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusStation" }, "PTX.Service.DTO.Bus.Specification.V2.StationStop": { "title": "StationStop", "required": [ "RouteID", "RouteName", "RouteUID", "StopID", "StopName", "StopUID" ], "type": "object", "properties": { "StopUID": { "title": "String", "minLength": 1, "type": "string", "description": "站牌唯一識別代碼,規則為 {業管機關簡碼} + {StopID},其中 {業管機關簡碼} 可於Authority API中的AuthorityCode欄位查詢", "xml": { "name": "StopUID" } }, "StopID": { "title": "String", "minLength": 1, "type": "string", "description": "地區既用中之站牌代碼(為原資料內碼)", "xml": { "name": "StopID" } }, "StopName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType" } ], "description": "站牌名稱", "xml": { "name": "NameType" } }, "RouteUID": { "title": "String", "minLength": 1, "type": "string", "description": "路線唯一識別代碼,規則為 {業管機關簡碼} + {RouteID},其中 {業管機關簡碼} 可於Authority API中的AuthorityCode欄位查詢", "xml": { "name": "RouteUID" } }, "RouteID": { "title": "String", "minLength": 1, "type": "string", "description": "地區既用中之路線代碼(為原資料內碼)", "xml": { "name": "RouteID" } }, "RouteName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType" } ], "description": "路線名稱", "xml": { "name": "NameType" } } }, "additionalProperties": false, "description": "站牌與路線資料型別", "xml": { "name": "StationStop" } }, "PTX.Service.DTO.Bus.Specification.V2.BusDisplayStopOfRoute": { "title": "BusDisplayStopOfRoute", "required": [ "RouteID", "RouteName", "RouteUID", "Stops", "UpdateTime", "VersionID" ], "type": "object", "properties": { "RouteUID": { "title": "String", "minLength": 1, "type": "string", "description": "路線唯一識別代碼,規則為 {業管機關代碼} + {RouteID},其中 {業管機關代碼} 可於Authority API中的AuthorityCode欄位查詢", "xml": { "name": "RouteUID" } }, "RouteID": { "title": "String", "minLength": 1, "type": "string", "description": "地區既用中之路線代碼(為原資料內碼)", "xml": { "name": "RouteID" } }, "RouteName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType" } ], "description": "路線名稱", "xml": { "name": "NameType" } }, "Direction": { "title": "Int32", "type": "integer", "description": "去返程 : [0:'去程',1:'返程',2:'迴圈',10:'循環線',255:'未知']", "format": "int32" }, "Stops": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.Embedded.Stop" }, "description": "所有經過站牌", "xml": { "name": "Stop" } }, "UpdateTime": { "title": "DateTime", "type": "string", "description": "資料更新日期時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "VersionID": { "title": "Int32", "type": "integer", "description": "資料版本編號", "format": "int32" } }, "additionalProperties": false, "description": "顯示用路線站序資料", "xml": { "name": "BusDisplayStopOfRoute" } }, "PTX.Service.DTO.Bus.Specification.V2.BusDisplayStopOfRoute7": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusDisplayStopOfRoute" }, "PTX.Service.DTO.Bus.Specification.V2.Embedded.Stop": { "title": "Stop", "required": [ "StationGroupID", "StopID", "StopName", "StopPosition", "StopSequence", "StopUID" ], "type": "object", "properties": { "StopUID": { "title": "String", "minLength": 1, "type": "string", "description": "站牌唯一識別代碼,規則為 {業管機關簡碼} + {StopID},其中 {業管機關簡碼} 可於Authority API中的AuthorityCode欄位查詢", "xml": { "name": "StopUID" } }, "StopID": { "title": "String", "minLength": 1, "type": "string", "description": "地區既用中之站牌代碼(為原資料內碼)", "xml": { "name": "StopID" } }, "StopName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType" } ], "description": "站牌名稱", "xml": { "name": "NameType" } }, "StopBoarding": { "title": "Int32", "type": "integer", "description": "上下車站別 : [-1:'可下車',0:'可上下車',1:'可上車']", "format": "int32", "nullable": true }, "StopSequence": { "title": "Int32", "type": "integer", "description": "路線經過站牌之順序", "format": "int32" }, "StopPosition": { "title": "PointType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.PointType" } ], "description": "站牌位置", "xml": { "name": "PointType" } }, "StationID": { "title": "String", "type": "string", "description": "站牌所屬的站位ID", "nullable": true, "xml": { "name": "StationID" } }, "StationGroupID": { "title": "String", "minLength": 1, "type": "string", "description": "站牌所屬的組站位ID", "xml": { "name": "StationGroupID" } }, "LocationCityCode": { "title": "String", "type": "string", "description": "站牌位置縣市之代碼(國際ISO 3166-2 三碼城市代碼)[若為公路/國道客運路線則為空值]", "nullable": true, "xml": { "name": "LocationCityCode" } } }, "additionalProperties": false, "description": "站牌代碼資料", "xml": { "name": "Stop" } }, "PTX.Service.DTO.Bus.Specification.V2.BusStopOfRoute": { "title": "BusStopOfRoute", "required": [ "RouteID", "RouteName", "RouteUID", "Stops", "SubRouteID", "SubRouteName", "SubRouteUID", "UpdateTime", "VersionID" ], "type": "object", "properties": { "RouteUID": { "title": "String", "minLength": 1, "type": "string", "description": "路線唯一識別代碼,規則為 {業管機關簡碼} + {RouteID},其中 {業管機關簡碼} 可於Authority API中的AuthorityCode欄位查詢", "xml": { "name": "RouteUID" } }, "RouteID": { "title": "String", "minLength": 1, "type": "string", "description": "地區既用中之路線代碼(為原資料內碼)", "xml": { "name": "RouteID" } }, "RouteName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType" } ], "description": "路線名稱", "xml": { "name": "NameType" } }, "Operators": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.Embedded.RouteOperator" }, "description": "營運業者", "nullable": true, "xml": { "name": "Operator" } }, "SubRouteUID": { "title": "String", "minLength": 1, "type": "string", "description": "附屬路線唯一識別代碼,規則為 {業管機關簡碼} + {SubRouteID},其中 {業管機關簡碼} 可於Authority API中的AuthorityCode欄位查詢", "xml": { "name": "SubRouteUID" } }, "SubRouteID": { "title": "String", "minLength": 1, "type": "string", "description": "地區既用中之附屬路線代碼(為原資料內碼)", "xml": { "name": "SubRouteID" } }, "SubRouteName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType" } ], "description": "附屬路線名稱", "xml": { "name": "NameType" } }, "Direction": { "title": "Int32", "type": "integer", "description": "去返程 : [0:'去程',1:'返程',2:'迴圈',10:'循環線',255:'未知']", "format": "int32", "nullable": true }, "City": { "title": "String", "type": "string", "description": "站牌權管所屬縣市(相當於市區公車API的City參數)[若為公路/國道客運路線則為空值]", "nullable": true, "xml": { "name": "City" } }, "CityCode": { "title": "String", "type": "string", "description": "站牌權管所屬縣市之代碼(國際ISO 3166-2 三碼城市代碼)[若為公路/國道客運路線則為空值]", "nullable": true, "xml": { "name": "CityCode" } }, "Stops": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.Embedded.Stop" }, "description": "所有經過站牌", "xml": { "name": "Stop" } }, "UpdateTime": { "title": "DateTime", "type": "string", "description": "資料更新日期時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "VersionID": { "title": "Int32", "type": "integer", "description": "資料版本編號", "format": "int32" } }, "additionalProperties": false, "description": "路線站序資料", "xml": { "name": "BusStopOfRoute" } }, "PTX.Service.DTO.Bus.Specification.V2.BusStopOfRoute8": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusStopOfRoute" }, "PTX.Service.DTO.Bus.Specification.V2.BusSchedule": { "title": "BusSchedule", "required": [ "Direction", "RouteID", "RouteName", "RouteUID", "SubRouteID", "SubRouteName", "SubRouteUID", "UpdateTime", "VersionID" ], "type": "object", "properties": { "RouteUID": { "title": "String", "minLength": 1, "type": "string", "description": "路線唯一識別代碼,規則為 {業管機關簡碼} + {RouteID},其中 {業管機關簡碼} 可於Authority API中的AuthorityCode欄位查詢", "xml": { "name": "RouteUID" } }, "RouteID": { "title": "String", "minLength": 1, "type": "string", "description": "地區既用中之路線代碼(為原資料內碼)", "xml": { "name": "RouteID" } }, "RouteName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType" } ], "description": "路線名稱", "xml": { "name": "NameType" } }, "SubRouteUID": { "title": "String", "minLength": 1, "type": "string", "description": "附屬路線唯一識別代碼,規則為 {業管機關簡碼} + {SubRouteID},其中 {業管機關簡碼} 可於Authority API中的AuthorityCode欄位查詢", "xml": { "name": "SubRouteUID" } }, "SubRouteID": { "title": "String", "minLength": 1, "type": "string", "description": "地區既用中之附屬路線代碼(為原資料內碼)", "xml": { "name": "SubRouteID" } }, "SubRouteName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType" } ], "description": "附屬路線名稱", "xml": { "name": "NameType" } }, "Direction": { "title": "Int32", "type": "integer", "description": "去返程 : [0:'去程',1:'返程',2:'迴圈',10:'循環線',255:'未知']", "format": "int32" }, "OperatorID": { "title": "String", "type": "string", "description": "營運業者代碼", "nullable": true, "xml": { "name": "OperatorID" } }, "OperatorCode": { "title": "String", "type": "string", "description": "營運業者簡碼", "nullable": true, "xml": { "name": "OperatorCode" } }, "OperatorNo": { "title": "String", "type": "string", "description": "營運業者編號[交通部票證資料系統定義]", "nullable": true, "xml": { "name": "OperatorNo" } }, "Timetables": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusTimetable" }, "description": "預定班表", "nullable": true, "xml": { "name": "Timetable" } }, "Frequencys": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusFrequency" }, "description": "發車班距", "nullable": true, "xml": { "name": "Frequency" } }, "UpdateTime": { "title": "DateTime", "type": "string", "description": "資料更新日期時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "VersionID": { "title": "Int32", "type": "integer", "description": "資料版本編號", "format": "int32" } }, "additionalProperties": false, "description": "班表資料", "xml": { "name": "BusSchedule" } }, "PTX.Service.DTO.Bus.Specification.V2.BusSchedule9": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusSchedule" }, "PTX.Service.DTO.Bus.Specification.V2.BusTimetable": { "title": "BusTimetable", "required": [ "StopTimes" ], "type": "object", "properties": { "TripID": { "title": "String", "type": "string", "description": "班次代碼", "nullable": true, "xml": { "name": "TripID" } }, "IsLowFloor": { "type": "boolean", "description": "該路線班次是否使用低地板公車車輛", "nullable": true }, "ServiceDay": { "title": "ServiceDay", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.Embedded.ServiceDay" } ], "description": "週內營運日", "nullable": true, "xml": { "name": "ServiceDay" } }, "SpecialDays": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.SpecialDay" }, "description": "特殊營運日", "nullable": true, "xml": { "name": "SpecialDay" } }, "StopTimes": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusStopTime" }, "description": "公車停靠時間資料", "xml": { "name": "StopTime" } } }, "additionalProperties": false, "description": "班次資料", "xml": { "name": "BusTimetable" } }, "PTX.Service.DTO.Bus.Specification.V2.SpecialDay": { "title": "SpecialDay", "type": "object", "properties": { "Dates": { "title": "Array", "type": "array", "items": { "title": "String", "type": "string", "xml": { } }, "description": "不連續特殊日期", "nullable": true, "xml": { "name": "List`1" } }, "DatePeriod": { "title": "DatePeriod", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.DatePeriod" } ], "description": "連續特殊日期", "nullable": true, "xml": { "name": "DatePeriod" } }, "ServiceStatus": { "title": "Int32", "type": "integer", "description": "營運服務狀態代碼 : [0:'正常營運',1:'加班營運',2:'取消/停駛營運']", "format": "int32" }, "Description": { "title": "String", "type": "string", "description": "特殊營運描述", "nullable": true, "xml": { "name": "Description" } } }, "additionalProperties": false, "description": "特殊營運日資料", "xml": { "name": "SpecialDay" } }, "PTX.Service.DTO.Bus.Specification.V2.DatePeriod": { "title": "DatePeriod", "type": "object", "properties": { "StartDate": { "title": "String", "type": "string", "description": "營運起始日(格式: yyyy-MM-dd)", "nullable": true, "xml": { "name": "StartDate" } }, "EndDate": { "title": "String", "type": "string", "description": "營運結束日(格式: yyyy-MM-dd)", "nullable": true, "xml": { "name": "EndDate" } } }, "additionalProperties": false, "xml": { "name": "DatePeriod" } }, "PTX.Service.DTO.Bus.Specification.V2.BusStopTime": { "title": "BusStopTime", "required": [ "ArrivalTime", "DepartureTime", "StopID", "StopName", "StopSequence", "StopUID" ], "type": "object", "properties": { "StopSequence": { "title": "Int32", "type": "integer", "description": "路線經過站牌之順序(由1開始)", "format": "int32" }, "StopUID": { "title": "String", "minLength": 1, "type": "string", "description": "站牌唯一識別代碼,規則為 {業管機關代碼} + {StopID},其中 {業管機關代碼} 可於Authority API中的AuthorityCode欄位查詢", "xml": { "name": "StopUID" } }, "StopID": { "title": "String", "minLength": 1, "type": "string", "description": "地區既用中之站牌代碼(為原資料內碼)", "xml": { "name": "StopID" } }, "StopName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType" } ], "description": "站牌名稱", "xml": { "name": "NameType" } }, "ArrivalTime": { "title": "String", "minLength": 1, "type": "string", "description": "到站時間,格式為:HH:mm", "xml": { "name": "ArrivalTime" } }, "DepartureTime": { "title": "String", "minLength": 1, "type": "string", "description": "離站時間,格式為:HH:mm", "xml": { "name": "DepartureTime" } } }, "additionalProperties": false, "description": "公車停靠時間資料", "xml": { "name": "BusStopTime" } }, "PTX.Service.DTO.Bus.Specification.V2.Embedded.ServiceDay": { "title": "ServiceDay", "required": [ "Friday", "Monday", "Saturday", "Sunday", "Thursday", "Tuesday", "Wednesday" ], "type": "object", "properties": { "ServiceTag": { "title": "String", "type": "string", "description": "服務日標籤", "nullable": true, "xml": { "name": "ServiceTag" } }, "Sunday": { "title": "Int32", "type": "integer", "description": "星期日是否營運 : [0:'否',1:'是']", "format": "int32" }, "Monday": { "title": "Int32", "type": "integer", "description": "星期一是否營運 : [0:'否',1:'是']", "format": "int32" }, "Tuesday": { "title": "Int32", "type": "integer", "description": "星期二是否營運 : [0:'否',1:'是']", "format": "int32" }, "Wednesday": { "title": "Int32", "type": "integer", "description": "星期三是否營運 : [0:'否',1:'是']", "format": "int32" }, "Thursday": { "title": "Int32", "type": "integer", "description": "星期四是否營運 : [0:'否',1:'是']", "format": "int32" }, "Friday": { "title": "Int32", "type": "integer", "description": "星期五是否營運 : [0:'否',1:'是']", "format": "int32" }, "Saturday": { "title": "Int32", "type": "integer", "description": "星期六是否營運 : [0:'否',1:'是']", "format": "int32" }, "NationalHolidays": { "title": "Int32", "type": "integer", "description": "國定假日營運與否 : [0:'否',1:'是']", "format": "int32", "nullable": true } }, "additionalProperties": false, "description": "週內營運日資料", "xml": { "name": "ServiceDay" } }, "PTX.Service.DTO.Bus.Specification.V2.BusFrequency": { "title": "BusFrequency", "required": [ "EndTime", "MaxHeadwayMins", "MinHeadwayMins", "StartTime" ], "type": "object", "properties": { "StartTime": { "title": "String", "minLength": 1, "type": "string", "description": "發車班距起始適用時間,格式為: HH:mm", "xml": { "name": "StartTime" } }, "EndTime": { "title": "String", "minLength": 1, "type": "string", "description": "發車班距結束適用時間,格式為: HH:mm", "xml": { "name": "EndTime" } }, "MinHeadwayMins": { "title": "Int32", "type": "integer", "description": "最小班距時間(分鐘)", "format": "int32" }, "MaxHeadwayMins": { "title": "Int32", "type": "integer", "description": "最大班距時間(分鐘)", "format": "int32" }, "ServiceDay": { "title": "ServiceDay", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.Embedded.ServiceDay" } ], "description": "週內營運日", "nullable": true, "xml": { "name": "ServiceDay" } }, "SpecialDays": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.SpecialDay" }, "description": "特殊營運日", "nullable": true, "xml": { "name": "SpecialDay" } } }, "additionalProperties": false, "description": "發車班距資料", "xml": { "name": "BusFrequency" } }, "PTX.Service.DTO.Bus.Specification.V2.BusVehicleInfo": { "title": "BusVehicleInfo", "required": [ "CardReaderLayout", "HasLiftOrRamp", "HasWifi", "IsElectric", "IsHybrid", "IsLowFloor", "OperatorCode", "OperatorID", "PlateNumb", "UpdateTime", "VehicleClass", "VehicleType" ], "type": "object", "properties": { "PlateNumb": { "title": "String", "minLength": 1, "type": "string", "description": "車牌號碼", "xml": { "name": "PlateNumb" } }, "OperatorID": { "title": "String", "minLength": 1, "type": "string", "description": "營運業者代碼", "xml": { "name": "OperatorID" } }, "OperatorCode": { "title": "String", "minLength": 1, "type": "string", "description": "營運業者簡碼", "xml": { "name": "OperatorCode" } }, "OperatorNo": { "title": "String", "type": "string", "description": "營運業者編號[交通部票證資料系統定義]", "nullable": true, "xml": { "name": "OperatorNo" } }, "VehicleClass": { "title": "Int32", "type": "integer", "description": "車輛種類 : [1:'大型巴士',2:'中型巴士',3:'小型巴士',4:'雙層巴士',5:'雙節巴士',6:'營業用小客車',99:'其他']", "format": "int32" }, "VehicleType": { "title": "Int32", "type": "integer", "description": "車輛種類 : [1:'一般',2:'復康巴士',3:'專車',4:'其他']", "format": "int32" }, "CardReaderLayout": { "title": "Int32", "type": "integer", "description": "讀卡機配置(0:無讀卡機配置;1:前門刷卡;2:前後門刷卡)", "format": "int32" }, "IsElectric": { "title": "Int32", "type": "integer", "description": "是否為電動公車 : [0:'否',1:'是']", "format": "int32" }, "IsHybrid": { "title": "Int32", "type": "integer", "description": "是否為油電混合公車 : [0:'否',1:'是']", "format": "int32" }, "IsLowFloor": { "title": "Int32", "type": "integer", "description": "是否為低地板 : [0:'否',1:'是']", "format": "int32" }, "HasLiftOrRamp": { "title": "Int32", "type": "integer", "description": "是否有升降或斜坡板設備 : [0:'否',1:'是']", "format": "int32" }, "HasWifi": { "title": "Int32", "type": "integer", "description": "是否有提供Wifi服務(-1: 未設定; 0: 無; 1: 有)", "format": "int32" }, "InBoxID": { "title": "String", "type": "string", "description": "車機代號", "nullable": true, "xml": { "name": "InBoxID" } }, "PurchaseTime": { "type": "string", "description": "購入時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time", "nullable": true }, "UpdateTime": { "title": "DateTime", "type": "string", "description": "資料更新日期時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" } }, "additionalProperties": false, "description": "公車車輛基本資料", "xml": { "name": "BusVehicleInfo" } }, "PTX.Service.DTO.Bus.Specification.V2.BusVehicleInfo10": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusVehicleInfo" }, "PTX.Service.DTO.Bus.Specification.V2.BusShape": { "title": "BusShape", "required": [ "EncodedPolyline", "Geometry", "RouteID", "RouteName", "RouteUID", "SubRouteUID", "UpdateTime", "VersionID" ], "type": "object", "properties": { "RouteUID": { "title": "String", "minLength": 1, "type": "string", "description": "路線唯一識別代碼,規則為 {業管機關簡碼} + {RouteID},其中 {業管機關簡碼} 可於Authority API中的AuthorityCode欄位查詢", "xml": { "name": "RouteUID" } }, "RouteID": { "title": "String", "minLength": 1, "type": "string", "description": "地區既用中之路線代碼(為原資料內碼)", "xml": { "name": "RouteID" } }, "RouteName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType" } ], "description": "路線名稱", "xml": { "name": "NameType" } }, "SubRouteUID": { "title": "String", "minLength": 1, "type": "string", "description": "附屬路線唯一識別代碼,規則為 {業管機關簡碼} + {SubRouteID},其中 {業管機關簡碼} 可於Authority API中的AuthorityCode欄位查詢", "xml": { "name": "SubRouteUID" } }, "SubRouteID": { "title": "String", "type": "string", "description": "附屬路線唯一識別代碼,規則為 {業管機關簡碼} + {SubRouteID},其中 {業管機關簡碼} 可於Authority API中的AuthorityCode欄位查詢", "nullable": true, "xml": { "name": "SubRouteID" } }, "SubRouteName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType" } ], "description": "附屬路線名稱", "nullable": true, "xml": { "name": "NameType" } }, "Direction": { "title": "Int32", "type": "integer", "description": "去返程,若無值則表示來源尚無區分去返程 : [0:'去程',1:'返程',2:'迴圈',10:'循環線',255:'未知']", "format": "int32", "nullable": true }, "Geometry": { "title": "String", "minLength": 1, "type": "string", "description": "well-known text,為路線軌跡資料", "xml": { "name": "Geometry" } }, "EncodedPolyline": { "title": "String", "minLength": 1, "type": "string", "description": "路線軌跡編碼(encoded polyline)", "xml": { "name": "EncodedPolyline" } }, "UpdateTime": { "title": "DateTime", "type": "string", "description": "資料更新日期時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "VersionID": { "title": "Int32", "type": "integer", "description": "資料版本編號(由於該服務資料不再版控,固定帶入版號0)", "format": "int32" } }, "additionalProperties": false, "description": "公車線型資料", "xml": { "name": "BusShape" } }, "PTX.Service.DTO.Bus.Specification.V2.BusShape11": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusShape" }, "PTX.Service.DTO.Bus.Specification.V2.BusRouteFare": { "title": "BusRouteFare", "required": [ "FarePricingType", "IsForAllSubRoutes", "IsFreeBus", "OperatorID", "RouteID", "UpdateTime" ], "type": "object", "properties": { "RouteID": { "title": "String", "minLength": 1, "type": "string", "description": "機關定義路線代號", "xml": { "name": "RouteID" } }, "RouteName": { "title": "String", "type": "string", "description": "路線名稱", "nullable": true, "xml": { "name": "RouteName" } }, "OperatorID": { "title": "String", "minLength": 1, "type": "string", "description": "營運業者代碼", "xml": { "name": "OperatorID" } }, "OperatorNo": { "title": "String", "type": "string", "description": "營運業者編號[交通部票證資料系統定義]", "nullable": true, "xml": { "name": "OperatorNo" } }, "SubRouteID": { "title": "String", "type": "string", "description": "機關定義附屬路線代碼", "nullable": true, "xml": { "name": "SubRouteID" } }, "SubRouteName": { "title": "String", "type": "string", "description": "附屬路線名稱", "nullable": true, "xml": { "name": "SubRouteName" } }, "FarePricingType": { "title": "Int32", "type": "integer", "description": "描述該路線計費方式 : [0:'段次計費',1:'起迄站間計費',2:'計費站區間計費']", "format": "int32" }, "IsFreeBus": { "title": "Int32", "type": "integer", "description": "是否為免費公車 : [0:'否',1:'是']", "format": "int32" }, "IsForAllSubRoutes": { "title": "Int32", "type": "integer", "description": "該收費方式是否應用到所有附屬路線 : [0:'否',1:'是']", "format": "int32" }, "SectionFares": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.SectionFare" }, "description": "段次計費", "nullable": true, "xml": { "name": "SectionFare" } }, "StageFares": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusStageFare" }, "description": "計費站區間計費", "nullable": true, "xml": { "name": "StageFare" } }, "ODFares": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusODFare" }, "description": "起迄站間計費", "nullable": true, "xml": { "name": "ODFare" } }, "UpdateTime": { "title": "DateTime", "type": "string", "description": "本平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" } }, "additionalProperties": false, "description": "路線票價資料", "xml": { "name": "BusRouteFare" } }, "PTX.Service.DTO.Bus.Specification.V2.BusRouteFare12": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRouteFare" }, "PTX.Service.DTO.Bus.Specification.V2.SectionFare": { "title": "SectionFare", "required": [ "Fares" ], "type": "object", "properties": { "BufferZones": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.SectionFareBufferZone" }, "description": "緩衝區資訊", "nullable": true, "xml": { "name": "BufferZone" } }, "Fares": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusFare" }, "description": "每段收費資訊", "xml": { "name": "Fare" } } }, "additionalProperties": false, "description": "段次計費", "xml": { "name": "SectionFare" } }, "PTX.Service.DTO.Bus.Specification.V2.SectionFareBufferZone": { "title": "BufferZone", "required": [ "Direction", "FareBufferZoneDestination", "FareBufferZoneOrigin", "SectionSequence" ], "type": "object", "properties": { "ZoneID": { "title": "String", "type": "string", "description": "緩衝區代號", "nullable": true, "xml": { "name": "ZoneID" } }, "SectionSequence": { "title": "Int32", "type": "integer", "description": "緩衝區順序", "format": "int32" }, "Direction": { "title": "Int32", "type": "integer", "description": "方向性描述 : [0:'去程',1:'返程',2:'迴圈',10:'循環線',255:'未知']", "format": "int32" }, "FareBufferZoneOrigin": { "title": "Stop", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRouteFareStop" } ], "description": "緩衝區起點", "xml": { "name": "Stop" } }, "FareBufferZoneDestination": { "title": "Stop", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRouteFareStop" } ], "description": "緩衝區迄點", "xml": { "name": "Stop" } }, "BufferZoneDescription": { "title": "String", "type": "string", "description": "收費緩衝區描述", "nullable": true, "xml": { "name": "BufferZoneDescription" } } }, "additionalProperties": false, "xml": { "name": "BufferZone" } }, "PTX.Service.DTO.Bus.Specification.V2.BusRouteFareStop": { "title": "Stop", "required": [ "StopID", "StopName" ], "type": "object", "properties": { "StopID": { "title": "String", "minLength": 1, "type": "string", "description": "站牌代碼", "xml": { "name": "StopID" } }, "StopName": { "title": "String", "minLength": 1, "type": "string", "description": "站牌名稱", "xml": { "name": "StopName" } }, "Sequence": { "type": "integer", "description": "站序", "format": "int32", "nullable": true } }, "additionalProperties": false, "xml": { "name": "Stop" } }, "PTX.Service.DTO.Bus.Specification.V2.BusFare": { "title": "BusFare", "required": [ "FareClass", "Price", "TicketType" ], "type": "object", "properties": { "FareName": { "title": "String", "type": "string", "description": "票價名稱", "nullable": true, "xml": { "name": "FareName" } }, "TicketType": { "title": "Int32", "type": "integer", "description": "票種類型 : [1:'一般票',2:'來回票',3:'電子票證',4:'回數票',5:'定期票30天期',6:'定期票60天期',7:'早鳥票',8:'定期票90天期']", "format": "int32" }, "FareClass": { "title": "Int32", "type": "integer", "description": "費率等級 : [1:'成人',2:'學生',3:'孩童',4:'敬老',5:'愛心',6:'愛心孩童',7:'愛心優待或愛心陪伴',8:'團體',9:'軍警',10:'由各運業者自行定義的半票']", "format": "int32" }, "Price": { "title": "Int32", "type": "integer", "description": "計費價格(新台幣),其中-1表示不提供售票服務", "format": "int32" }, "DiscountPeriods": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusDiscountPeriods" }, "description": "優惠時段", "nullable": true, "xml": { "name": "DiscountPeriod" } } }, "additionalProperties": false, "description": "票票價種類及費率說明", "xml": { "name": "BusFare" } }, "PTX.Service.DTO.Bus.Specification.V2.BusDiscountPeriods": { "title": "BusDiscountPeriods", "required": [ "EndTime", "ServiceDay", "StartTime" ], "type": "object", "properties": { "ServiceDay": { "title": "ServiceDay", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.Embedded.ServiceDay" } ], "description": "營運日型態", "xml": { "name": "ServiceDay" } }, "StartTime": { "title": "String", "minLength": 1, "type": "string", "description": "開始時間(HH:mm制)", "xml": { "name": "StartTime" } }, "EndTime": { "title": "String", "minLength": 1, "type": "string", "description": "結束時間(HH:mm制)", "xml": { "name": "EndTime" } } }, "additionalProperties": false, "description": "優惠時段", "xml": { "name": "BusDiscountPeriods" } }, "PTX.Service.DTO.Bus.Specification.V2.BusStageFare": { "title": "BusStageFare", "required": [ "DestinationStage", "Direction", "Fares", "OriginStage" ], "type": "object", "properties": { "Direction": { "title": "Int32", "type": "integer", "description": "方向性描述 : [0:'去程',1:'返程',2:'迴圈',10:'循環線',255:'未知']", "format": "int32" }, "OriginStage": { "title": "Stop", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRouteFareStop" } ], "description": "起點計費站", "xml": { "name": "Stop" } }, "DestinationStage": { "title": "Stop", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRouteFareStop" } ], "description": "迄點計費站", "xml": { "name": "Stop" } }, "Fares": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusFare" }, "description": "票價內容", "xml": { "name": "Fare" } } }, "additionalProperties": false, "description": "此計費方式以一路線內所有站牌分區收費。(公總稱之為計費站收費, Stage=計費站)", "xml": { "name": "BusStageFare" } }, "PTX.Service.DTO.Bus.Specification.V2.BusODFare": { "title": "BusODFare", "required": [ "DestinationStop", "Direction", "Fares", "OriginStop" ], "type": "object", "properties": { "Direction": { "title": "Int32", "type": "integer", "description": "方向性描述 : [0:'去程',1:'返程',2:'迴圈',10:'循環線',255:'未知']", "format": "int32" }, "OriginStop": { "title": "Stop", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRouteFareStop" } ], "description": "計費起點站牌資訊", "xml": { "name": "Stop" } }, "DestinationStop": { "title": "Stop", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRouteFareStop" } ], "description": "計費迄點站牌資訊", "xml": { "name": "Stop" } }, "Fares": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusFare" }, "description": "票價內容", "xml": { "name": "Fare" } } }, "additionalProperties": false, "description": "起迄站間計費", "xml": { "name": "BusODFare" } }, "PTX.Service.DTO.Bus.Specification.V2.BusNews": { "title": "BusNews", "required": [ "Description", "EndTime", "Language", "NewsID", "PublishTime", "StartTime", "Title", "UpdateTime" ], "type": "object", "properties": { "NewsID": { "title": "String", "minLength": 1, "type": "string", "description": "最新消息原單位發布代碼", "xml": { "name": "NewsID" } }, "Language": { "title": "String", "minLength": 1, "type": "string", "description": "語系", "xml": { "name": "Language" } }, "Department": { "title": "String", "type": "string", "description": "發布單位", "nullable": true, "xml": { "name": "Department" } }, "Title": { "title": "String", "minLength": 1, "type": "string", "description": "消息標題", "xml": { "name": "Title" } }, "NewsCategory": { "title": "Int32", "type": "integer", "description": "消息類別 : [1:'最新消息',2:'新聞稿',3:'營運資訊',4:'轉乘資訊',5:'活動訊息',6:'系統公告',7:'通阻資訊',99:'其他']", "format": "int32", "nullable": true }, "Description": { "title": "String", "minLength": 1, "type": "string", "description": "內容描述", "xml": { "name": "Description" } }, "ContactName": { "title": "String", "type": "string", "description": "聯絡人/單位", "nullable": true, "xml": { "name": "ContactName" } }, "ContactPhone": { "title": "String", "type": "string", "description": "聯絡電話", "nullable": true, "xml": { "name": "ContactPhone" } }, "NewsURL": { "title": "String", "type": "string", "description": "報導網站連結", "nullable": true, "xml": { "name": "NewsURL" } }, "AttachmentURL": { "title": "String", "type": "string", "description": "相關網站連結", "nullable": true, "xml": { "name": "AttachmentURL" } }, "PublishTime": { "title": "DateTime", "type": "string", "description": "消息公告日期時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "StartTime": { "type": "string", "description": "開始時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "EndTime": { "type": "string", "description": "結束時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "SrcUpdateTime": { "type": "string", "description": "來源端平台資料更新時間", "format": "date-time", "nullable": true }, "UpdateTime": { "title": "DateTime", "type": "string", "description": "本平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" } }, "additionalProperties": false, "description": "公車最新消息資料", "xml": { "name": "BusNews" } }, "PTX.Service.DTO.Bus.Specification.V2.BusNews13": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusNews" }, "PTX.Service.DTO.Bus.Specification.V2.BusStationGroup": { "title": "BusStationGroup", "required": [ "StationGroupID", "StationGroupName", "StationGroupPosition", "StationGroupUID", "UpdateTime", "VersionID" ], "type": "object", "properties": { "StationGroupUID": { "title": "String", "minLength": 1, "type": "string", "description": "組站位唯一識別代碼,規則為 {業管機關簡碼} + {StationGroupID},其中 {業管機關簡碼} 可於Authority API中的AuthorityCode欄位查詢", "xml": { "name": "StationGroupUID" } }, "StationGroupID": { "title": "String", "minLength": 1, "type": "string", "description": "組站位代碼", "xml": { "name": "StationGroupID" } }, "StationGroupName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType" } ], "description": "組站位名稱", "xml": { "name": "NameType" } }, "StationGroupPosition": { "title": "PointType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.PointType" } ], "description": "組站位位置", "xml": { "name": "PointType" } }, "UpdateTime": { "title": "DateTime", "type": "string", "description": "資料更新日期時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "VersionID": { "title": "Int32", "type": "integer", "description": "資料版本編號", "format": "int32" } }, "additionalProperties": false, "description": "組站位資料型別", "xml": { "name": "BusStationGroup" } }, "PTX.Service.DTO.Bus.Specification.V2.BusStationGroup14": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusStationGroup" }, "PTX.Service.DTO.Bus.Specification.V2.BusFirstLastTripInfo": { "title": "BusFirstLastTripInfo", "required": [ "Direction", "FirstLastTrips", "OperatorID", "RouteID", "RouteName", "RouteUID", "SubRouteID", "SubRouteName", "SubRouteUID", "UpdateTime", "VersionID" ], "type": "object", "properties": { "RouteUID": { "title": "String", "minLength": 1, "type": "string", "description": "路線唯一識別代碼,規則為 {業管機關簡碼} + {RouteID},其中 {業管機關簡碼} 可於Authority API中的AuthorityCode欄位查詢", "xml": { "name": "RouteUID" } }, "RouteID": { "title": "String", "minLength": 1, "type": "string", "description": "地區既用中之路線代碼(為原資料內碼)", "xml": { "name": "RouteID" } }, "RouteName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType" } ], "description": "路線名稱", "xml": { "name": "NameType" } }, "OperatorID": { "title": "String", "minLength": 1, "type": "string", "description": "營運業者代碼", "xml": { "name": "OperatorID" } }, "OperatorNo": { "title": "String", "type": "string", "description": "營運業者編號[交通部票證資料系統定義]", "nullable": true, "xml": { "name": "OperatorNo" } }, "SubRouteUID": { "title": "String", "minLength": 1, "type": "string", "description": "附屬路線唯一識別代碼,規則為 {業管機關簡碼} + {SubRouteID},其中 {業管機關簡碼} 可於Authority API中的AuthorityCode欄位查詢", "xml": { "name": "SubRouteUID" } }, "SubRouteID": { "title": "String", "minLength": 1, "type": "string", "description": "地區既用中之附屬路線代碼(為原資料內碼)", "xml": { "name": "SubRouteID" } }, "SubRouteName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType" } ], "description": "附屬路線名稱", "xml": { "name": "NameType" } }, "Direction": { "title": "Int32", "type": "integer", "description": "去返程 : [0:'去程',1:'返程',2:'迴圈',10:'循環線',255:'未知']", "format": "int32" }, "FirstLastTrips": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.FirstLastTrip" }, "description": "首末班車", "xml": { "name": "FirstLastTrip" } }, "UpdateTime": { "title": "DateTime", "type": "string", "description": "資料更新日期時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "VersionID": { "title": "Int32", "type": "integer", "description": "資料版本編號", "format": "int32" } }, "additionalProperties": false, "description": "路線首末班車資料型別", "xml": { "name": "BusFirstLastTripInfo" } }, "PTX.Service.DTO.Bus.Specification.V2.BusFirstLastTripInfo15": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusFirstLastTripInfo" }, "PTX.Service.DTO.Bus.Specification.V2.FirstLastTrip": { "title": "FirstLastTrip", "required": [ "FirstTripDepTime", "LastTripDepTime", "ServiceDay" ], "type": "object", "properties": { "ServiceDay": { "title": "ServiceDay", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusFirstLastTripInfoServiceDay" } ], "description": "服務日型態", "xml": { "name": "ServiceDay" } }, "FirstTripDepTime": { "title": "String", "minLength": 1, "type": "string", "description": "頭班車發車時間(HH:mm)", "xml": { "name": "FirstTripDepTime" } }, "LastTripDepTime": { "title": "String", "minLength": 1, "type": "string", "description": "末班車發車時間(HH:mm)", "xml": { "name": "LastTripDepTime" } } }, "additionalProperties": false, "description": "首末班車資料型別", "xml": { "name": "FirstLastTrip" } }, "PTX.Service.DTO.Bus.Specification.V2.BusFirstLastTripInfoServiceDay": { "title": "ServiceDay", "required": [ "Friday", "Monday", "Saturday", "Sunday", "Thursday", "Tuesday", "Wednesday" ], "type": "object", "properties": { "ServiceTag": { "title": "String", "type": "string", "description": "服務日標籤", "nullable": true, "xml": { "name": "ServiceTag" } }, "Sunday": { "title": "Int32", "type": "integer", "description": "星期日是否營運 : [0:'否',1:'是']", "format": "int32" }, "Monday": { "title": "Int32", "type": "integer", "description": "星期一是否營運 : [0:'否',1:'是']", "format": "int32" }, "Tuesday": { "title": "Int32", "type": "integer", "description": "星期二是否營運 : [0:'否',1:'是']", "format": "int32" }, "Wednesday": { "title": "Int32", "type": "integer", "description": "星期三是否營運 : [0:'否',1:'是']", "format": "int32" }, "Thursday": { "title": "Int32", "type": "integer", "description": "星期四是否營運 : [0:'否',1:'是']", "format": "int32" }, "Friday": { "title": "Int32", "type": "integer", "description": "星期五是否營運 : [0:'否',1:'是']", "format": "int32" }, "Saturday": { "title": "Int32", "type": "integer", "description": "星期六是否營運 : [0:'否',1:'是']", "format": "int32" }, "NationalHolidays": { "title": "Int32", "type": "integer", "description": "國定假日營運與否 : [0:'否',1:'是']", "format": "int32", "nullable": true }, "DayBeforeNationalHoliday": { "title": "Int32", "type": "integer", "description": "國定假日前一日營運與否 : [0:'否',1:'是']", "format": "int32", "nullable": true }, "DayAfterNationalHoliday": { "title": "Int32", "type": "integer", "description": "國定假日後一日營運與否 : [0:'否',1:'是']", "format": "int32", "nullable": true }, "TyphoonDay": { "title": "Int32", "type": "integer", "description": "颱風停止上班上課期間營運與否 : [0:'否',1:'是']", "format": "int32", "nullable": true } }, "additionalProperties": false, "xml": { "name": "ServiceDay" } }, "PTX.Service.DTO.Bus.Specification.V2.BusAlert": { "title": "BusAlert", "required": [ "AlertID", "Department", "Description", "EndTime", "Scope", "StartTime", "Title" ], "type": "object", "properties": { "AlertID": { "title": "String", "minLength": 1, "type": "string", "description": "通阻事件原單位發布代碼", "xml": { "name": "AlertID" } }, "Title": { "title": "String", "minLength": 1, "type": "string", "description": "通阻標題", "xml": { "name": "Title" } }, "Description": { "title": "String", "minLength": 1, "type": "string", "description": "事件描述", "xml": { "name": "Description" } }, "Department": { "title": "String", "minLength": 1, "type": "string", "description": "發布單位", "xml": { "name": "Department" } }, "Status": { "title": "Int32", "type": "integer", "description": "營運狀況 : [0:'全部營運停止',1:'全部營運正常',2:'有異常狀況']", "format": "int32", "nullable": true }, "Cause": { "title": "Int32", "type": "integer", "description": "原因 : [1:'事故(ACCIDENT)',2:'維護檢修(MAINTENANCE)',3:'技術問題(TECHNICAL_PROBLEM)',4:'施工(CONSTRUCTION)',5:'醫療緊急狀況(MEDICAL_EMERGENCY)',6:'氣候(WEATHER)',7:'示威遊行(DEMONSTRATION)',8:'政治活動/維安(POLICE_ACTIVITY)',9:'假日/節慶(HOLIDAY)',10:'罷工(STRIKE)',11:'活動(Activity)(如:國慶活動/煙火活動/跨年活動/路跑活動/新北耶誕城活動等)',254:'其他(OTHER_CAUSE)',255:'未知原因(UNKNOWN_CAUSE)']", "format": "int32", "nullable": true }, "Effect": { "title": "Int32", "type": "integer", "description": "影響 : [1:'車輛改道/站牌不停靠(DETOUR)',2:'服務(班次)增加(ADDITIONAL_SERVICE)',3:'服務(班次)減少(REDUCED_SERVICE)',4:'服務(班次)取消(NO_SERVICE)',5:'服務(班次)改變(MODIFIED_SERVICE)',6:'站點異動(STOP_MOVED)',7:'重大延遲(SIGNIFICANT_DELAYS)',254:'其他影響(OTHER_EFFECT)',255:'未知影響(UNKNOWN_EFFECT)']", "format": "int32", "nullable": true }, "Scope": { "title": "Scope", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.Scope" } ], "description": "通阻影響範圍", "xml": { "name": "Scope" } }, "AlertURL": { "title": "String", "type": "string", "description": "詳細描述網站連結", "nullable": true, "xml": { "name": "AlertURL" } }, "PublishTime": { "type": "string", "description": "消息公告日期時間", "format": "date-time", "nullable": true }, "StartTime": { "type": "string", "description": "開始日期時間", "format": "date-time" }, "EndTime": { "type": "string", "description": "結束日期時間", "format": "date-time" }, "SrcUpdateTime": { "title": "DateTime", "type": "string", "description": "[來源端平臺]此筆資料最後更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "UpdateTime": { "title": "DateTime", "type": "string", "description": "本平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" } }, "additionalProperties": false, "xml": { "name": "BusAlert" } }, "PTX.Service.DTO.Bus.Specification.V2.BusAlert16": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusAlert" }, "PTX.Service.DTO.Bus.Specification.V2.Scope": { "title": "Scope", "type": "object", "properties": { "Operators": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.ScopeOperator" }, "description": "營運業者資料", "nullable": true, "xml": { "name": "Operator" } }, "Stops": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.ScopeStop" }, "description": "站牌資料", "nullable": true, "xml": { "name": "Stop" } }, "Stations": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.ScopeStation" }, "description": "站位資料", "nullable": true, "xml": { "name": "Station" } }, "Routes": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.ScopeRoute" }, "description": "路線資料", "nullable": true, "xml": { "name": "Route" } }, "SubRoutes": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.ScopeSubRoute" }, "description": "附屬路線資料", "nullable": true, "xml": { "name": "SubRoute" } }, "Trips": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.ScopeTrip" }, "description": "班次資料", "nullable": true, "xml": { "name": "Trip" } } }, "additionalProperties": false, "description": "通阻影響範圍", "xml": { "name": "Scope" } }, "PTX.Service.DTO.Bus.Specification.V2.ScopeOperator": { "title": "Operator", "type": "object", "properties": { "OperatorID": { "title": "String", "type": "string", "description": "營運業者代碼 ,", "nullable": true, "xml": { "name": "OperatorID" } }, "OperatorName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType" } ], "description": "營運業者名稱", "nullable": true, "xml": { "name": "NameType" } } }, "additionalProperties": false, "description": "營運業者資料", "xml": { "name": "Operator" } }, "PTX.Service.DTO.Bus.Specification.V2.ScopeStop": { "title": "Stop", "type": "object", "properties": { "StopID": { "title": "String", "type": "string", "description": "地區既用中之站牌代碼(為原資料內碼)", "nullable": true, "xml": { "name": "StopID" } }, "StopName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType" } ], "description": "站牌名稱", "nullable": true, "xml": { "name": "NameType" } }, "StationID": { "title": "String", "type": "string", "description": "站位代碼", "nullable": true, "xml": { "name": "StationID" } } }, "additionalProperties": false, "description": "站牌資料", "xml": { "name": "Stop" } }, "PTX.Service.DTO.Bus.Specification.V2.ScopeStation": { "title": "Station", "type": "object", "properties": { "StationID": { "title": "String", "type": "string", "description": "站位代碼", "nullable": true, "xml": { "name": "StationID" } }, "StationName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType" } ], "description": "站位名稱", "nullable": true, "xml": { "name": "NameType" } } }, "additionalProperties": false, "description": "站位資料", "xml": { "name": "Station" } }, "PTX.Service.DTO.Bus.Specification.V2.ScopeRoute": { "title": "Route", "type": "object", "properties": { "RouteID": { "title": "String", "type": "string", "description": "地區既用中之班次代碼(為原資料內碼)", "nullable": true, "xml": { "name": "RouteID" } }, "RouteName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType" } ], "description": "路線名稱", "nullable": true, "xml": { "name": "NameType" } }, "Direction": { "title": "Int32", "type": "integer", "description": "影響方向 : [0:'去程',1:'返程',2:'迴圈',10:'循環線',255:'未知']", "format": "int32", "nullable": true } }, "additionalProperties": false, "description": "路線資料", "xml": { "name": "Route" } }, "PTX.Service.DTO.Bus.Specification.V2.ScopeSubRoute": { "title": "SubRoute", "type": "object", "properties": { "SubRouteID": { "title": "String", "type": "string", "description": "地區既用中之附屬班次代碼(為原資料內碼)", "nullable": true, "xml": { "name": "SubRouteID" } }, "SubRouteName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType" } ], "description": "附屬路線名稱", "nullable": true, "xml": { "name": "NameType" } }, "Direction": { "title": "Int32", "type": "integer", "description": "影響方向 : [0:'去程',1:'返程',2:'迴圈',10:'循環線',255:'未知']", "format": "int32", "nullable": true } }, "additionalProperties": false, "description": "附屬路線資料", "xml": { "name": "SubRoute" } }, "PTX.Service.DTO.Bus.Specification.V2.ScopeTrip": { "title": "Trip", "type": "object", "properties": { "TripID": { "title": "String", "type": "string", "description": "地區既用中之班次代碼(為原資料內碼)", "nullable": true, "xml": { "name": "TripID" } }, "RouteID": { "title": "String", "type": "string", "description": "地區既用中之班次代碼(為原資料內碼)", "nullable": true, "xml": { "name": "RouteID" } }, "SubRouteID": { "title": "String", "type": "string", "description": "地區既用中之附屬班次代碼(為原資料內碼)", "nullable": true, "xml": { "name": "SubRouteID" } }, "Direction": { "title": "Int32", "type": "integer", "description": "影響方向 : [0:'去程',1:'返程',2:'迴圈',10:'循環線',255:'未知']", "format": "int32", "nullable": true }, "TripDepTime": { "title": "String", "type": "string", "description": "首站發車時間(HH:mm)", "nullable": true, "xml": { "name": "TripDepTime" } } }, "additionalProperties": false, "description": "班次代碼資料", "xml": { "name": "Trip" } }, "PTX.Service.DTO.Bus.Specification.V2.BusRouteNetwork": { "title": "BusRouteNetwork", "required": [ "RouteID", "RouteName", "RouteUID", "Segments", "UpdateTime", "VersionID" ], "type": "object", "properties": { "RouteUID": { "title": "String", "minLength": 1, "type": "string", "description": "路線唯一識別代碼,規則為 {業管機關簡碼} + {RouteID},其中 {業管機關簡碼} 可於Authority API中的AuthorityCode欄位查詢", "xml": { "name": "RouteUID" } }, "RouteID": { "title": "String", "minLength": 1, "type": "string", "description": "地區既用中之路線代碼(為原資料內碼)", "xml": { "name": "RouteID" } }, "RouteName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType" } ], "description": "路線名稱", "xml": { "name": "NameType" } }, "Segments": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRouteNetworkSegment" }, "description": "站間線段序號", "xml": { "name": "Segment" } }, "UpdateTime": { "title": "DateTime", "type": "string", "description": "資料更新日期時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "VersionID": { "title": "Int32", "type": "integer", "description": "資料版本編號", "format": "int32" } }, "additionalProperties": false, "xml": { "name": "BusRouteNetwork" } }, "PTX.Service.DTO.Bus.Specification.V2.BusRouteNetwork17": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRouteNetwork" }, "PTX.Service.DTO.Bus.Specification.V2.BusRouteNetworkSegment": { "title": "Segment", "required": [ "Distance", "FromStationID", "Sequence", "ToStationID" ], "type": "object", "properties": { "Sequence": { "title": "Single", "type": "number", "description": "站間線段序號", "format": "float" }, "FromStationID": { "title": "String", "minLength": 1, "type": "string", "description": "表BusStation唯一碼(起點站牌)", "xml": { "name": "FromStationID" } }, "ToStationID": { "title": "String", "minLength": 1, "type": "string", "description": "表BusStation唯一碼(迄點站牌)", "xml": { "name": "ToStationID" } }, "Distance": { "title": "Single", "type": "number", "description": "站間線段距離", "format": "float" } }, "additionalProperties": false, "xml": { "name": "Segment" } }, "PTX.Service.DTO.Bus.Specification.V2.BusS2STravelTime": { "title": "BusS2STravelTime", "required": [ "Direction", "RouteID", "RouteUID", "SubRouteID", "SubRouteUID", "TravelTimes", "UpdateTime" ], "type": "object", "properties": { "RouteUID": { "title": "String", "minLength": 1, "type": "string", "description": "路線唯一識別代碼,規則為 {業管機關簡碼} + {RouteID},其中 {業管機關簡碼} 可於Authority API中的AuthorityCode欄位查詢", "xml": { "name": "RouteUID" } }, "RouteID": { "title": "String", "minLength": 1, "type": "string", "description": "地區既用中之路線代碼(為原資料內碼)", "xml": { "name": "RouteID" } }, "SubRouteUID": { "title": "String", "minLength": 1, "type": "string", "description": "附屬路線唯一識別代碼,規則為 {業管機關簡碼} + {SubRouteID},其中 {業管機關簡碼} 可於Authority API中的AuthorityCode欄位查詢", "xml": { "name": "SubRouteUID" } }, "SubRouteID": { "title": "String", "minLength": 1, "type": "string", "description": "地區既用中之附屬路線代碼(為原資料內碼)", "xml": { "name": "SubRouteID" } }, "Direction": { "title": "Int32", "type": "integer", "description": "去返程 : [0:'去程',1:'返程',2:'迴圈',10:'循環線',255:'未知']", "format": "int32" }, "TravelTimes": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.ServiceTime" }, "description": "旅行時間資訊", "xml": { "name": "TravelTime" } }, "UpdateTime": { "title": "DateTime", "type": "string", "description": "資料更新日期時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" } }, "additionalProperties": false, "description": "站間旅行時間資料型別", "xml": { "name": "BusS2STravelTime" } }, "PTX.Service.DTO.Bus.Specification.V2.BusS2STravelTime18": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusS2STravelTime" }, "PTX.Service.DTO.Bus.Specification.V2.ServiceTime": { "title": "ServiceTime", "required": [ "EndHour", "S2STimes", "StartHour", "Weekday" ], "type": "object", "properties": { "Weekday": { "title": "Int32", "type": "integer", "description": "星期 : [0:星期日, 1:星期一, 2:星期二, 3:星期三, 4:星期四, 5:星期五, 6:星期六, 99:不分星期]", "format": "int32" }, "StartHour": { "title": "Int32", "type": "integer", "description": "起始時區(小時)", "format": "int32" }, "EndHour": { "title": "Int32", "type": "integer", "description": "結束時區(小時)", "format": "int32" }, "S2STimes": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.TravelTime" }, "description": "站間行駛時間資訊", "xml": { "name": "S2STime" } } }, "additionalProperties": false, "description": "行駛時間資料型別", "xml": { "name": "ServiceTime" } }, "PTX.Service.DTO.Bus.Specification.V2.TravelTime": { "title": "TravelTime", "required": [ "FromStationID", "FromStopID", "RunTime", "ToStationID", "ToStopID" ], "type": "object", "properties": { "FromStopID": { "title": "String", "minLength": 1, "type": "string", "description": "起始站牌代碼", "xml": { "name": "FromStopID" } }, "ToStopID": { "title": "String", "minLength": 1, "type": "string", "description": "終點站牌代碼", "xml": { "name": "ToStopID" } }, "FromStationID": { "title": "String", "minLength": 1, "type": "string", "description": "起始站位代碼", "xml": { "name": "FromStationID" } }, "ToStationID": { "title": "String", "minLength": 1, "type": "string", "description": "終點站位代碼", "xml": { "name": "ToStationID" } }, "RunTime": { "title": "Int32", "type": "integer", "description": "站間預估行駛時間 [當RunTime值為-1時,代表該區間無提供旅行時間資料。]", "format": "int32" } }, "additionalProperties": false, "xml": { "name": "TravelTime" } }, "PTX.Service.DTO.Bus.Specification.V2.BusRouteTPASS": { "title": "BusRouteTPASS", "required": [ "Operators", "RouteID", "RouteName", "SubRouteID", "SubRouteName" ], "type": "object", "properties": { "RouteID": { "title": "String", "minLength": 1, "type": "string", "description": "機關定義路線代號", "xml": { "name": "RouteID" } }, "RouteName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType" } ], "description": "路線名稱", "xml": { "name": "NameType" } }, "SubRouteID": { "title": "String", "minLength": 1, "type": "string", "description": "機關定義附屬路線代號", "xml": { "name": "SubRouteID" } }, "SubRouteName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType" } ], "description": "附屬路線名稱", "xml": { "name": "NameType" } }, "Operators": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRouteTPASSOperator" }, "description": "營運業者", "xml": { "name": "Operator" } } }, "additionalProperties": false, "description": "路線適用通勤月票方案資料", "xml": { "name": "BusRouteTPASS" } }, "PTX.Service.DTO.Bus.Specification.V2.BusRouteTPASS19": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRouteTPASS" }, "PTX.Service.DTO.Bus.Specification.V2.BusRouteTPASSOperator": { "title": "Operator", "required": [ "OperatorID", "OperatorName", "OperatorNo" ], "type": "object", "properties": { "OperatorID": { "title": "String", "minLength": 1, "type": "string", "description": "營運業者代碼", "xml": { "name": "OperatorID" } }, "OperatorNo": { "title": "String", "minLength": 1, "type": "string", "description": "營運業者編號", "xml": { "name": "OperatorNo" } }, "OperatorName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType" } ], "description": "營運業者名稱", "xml": { "name": "NameType" } } }, "additionalProperties": false, "description": "營運業者資料", "xml": { "name": "Operator" } }, "PTX.Service.DTO.Bus.Specification.V2.BusDailyTimeTable": { "title": "BusDailyTimeTable", "required": [ "BusDate", "Direction", "OperatorID", "RouteID", "RouteName", "RouteUID", "SubRouteID", "UpdateTime" ], "type": "object", "properties": { "BusDate": { "title": "DateTime", "type": "string", "description": "適用日期", "format": "date-time" }, "RouteUID": { "title": "String", "minLength": 1, "type": "string", "description": "路線唯一識別代碼,規則為 {業管機關簡碼} + {RouteID},其中 {業管機關簡碼} 可於Authority API中的AuthorityCode欄位查詢", "xml": { "name": "RouteUID" } }, "RouteID": { "title": "String", "minLength": 1, "type": "string", "description": "地區既用中之路線代碼(為原資料內碼)", "xml": { "name": "RouteID" } }, "RouteName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType" } ], "description": "路線名稱", "xml": { "name": "NameType" } }, "OperatorID": { "title": "String", "minLength": 1, "type": "string", "description": "營運業者代碼", "xml": { "name": "OperatorID" } }, "OperatorNo": { "title": "String", "type": "string", "description": "營運業者編號[交通部票證資料系統定義]", "nullable": true, "xml": { "name": "OperatorNo" } }, "OperatorCode": { "title": "String", "type": "string", "description": "營運業者簡碼", "nullable": true, "xml": { "name": "OperatorCode" } }, "SubRouteUID": { "title": "String", "type": "string", "description": "附屬路線唯一識別代碼,規則為 {業管機關簡碼} + {SubRouteID},其中 {業管機關簡碼} 可於Authority API中的AuthorityCode欄位查詢", "nullable": true, "xml": { "name": "SubRouteUID" } }, "SubRouteID": { "title": "String", "minLength": 1, "type": "string", "description": "地區既用中之附屬路線代碼(為原資料內碼)", "xml": { "name": "SubRouteID" } }, "SubRouteName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType" } ], "description": "附屬路線名稱", "nullable": true, "xml": { "name": "NameType" } }, "Direction": { "title": "Int32", "type": "integer", "description": "去返程 : [0:'去程',1:'返程',2:'迴圈',10:'循環線',255:'未知']", "format": "int32" }, "Timetables": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusDailyTimeTableTimeTable" }, "description": "預定班表", "nullable": true, "xml": { "name": "TimeTable" } }, "UpdateTime": { "title": "DateTime", "type": "string", "description": "資料更新日期時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" } }, "additionalProperties": false, "xml": { "name": "BusDailyTimeTable" } }, "PTX.Service.DTO.Bus.Specification.V2.BusDailyTimeTable20": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusDailyTimeTable" }, "PTX.Service.DTO.Bus.Specification.V2.BusDailyTimeTableTimeTable": { "title": "TimeTable", "required": [ "StopTimes" ], "type": "object", "properties": { "TripID": { "title": "String", "type": "string", "description": "班次代碼", "nullable": true, "xml": { "name": "TripID" } }, "StopTimes": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusDailyTimeTableStopTime" }, "description": "公車停靠時間資料", "xml": { "name": "StopTime" } } }, "additionalProperties": false, "xml": { "name": "TimeTable" } }, "PTX.Service.DTO.Bus.Specification.V2.BusDailyTimeTableStopTime": { "title": "StopTime", "required": [ "ArrivalTime", "DepartureTime", "StopID", "StopSequence", "StopUID", "TimeType" ], "type": "object", "properties": { "StopSequence": { "title": "Int32", "type": "integer", "description": "路線經過站牌之順序(由1開始)", "format": "int32" }, "StopUID": { "title": "String", "minLength": 1, "type": "string", "description": "站牌唯一識別代碼,規則為 {業管機關代碼} + {StopID},其中 {業管機關代碼} 可於Authority API中的AuthorityCode欄位查詢", "xml": { "name": "StopUID" } }, "StopID": { "title": "String", "minLength": 1, "type": "string", "description": "地區既用中之站牌代碼(為原資料內碼)", "xml": { "name": "StopID" } }, "StopName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType" } ], "description": "站牌名稱", "nullable": true, "xml": { "name": "NameType" } }, "ArrivalTime": { "title": "String", "minLength": 1, "type": "string", "description": "到站時間,格式為:HH:mm", "xml": { "name": "ArrivalTime" } }, "DepartureTime": { "title": "String", "minLength": 1, "type": "string", "description": "離站時間,格式為:HH:mm", "xml": { "name": "DepartureTime" } }, "TimeType": { "title": "Int32", "type": "integer", "description": "時刻表時間類型 : [0:'估算時間',1:'表訂時間']", "format": "int32" } }, "additionalProperties": false, "xml": { "name": "StopTime" } }, "PTX.Service.DTO.Bus.Specification.V2.BusDailyStopTimeTable": { "title": "BusDailyStopTimeTable", "required": [ "BusDate", "DestinationStopID", "OperatorID", "RouteID", "RouteName", "RouteUID", "Stops", "SubRouteID", "SubRouteUID", "UpdateTime" ], "type": "object", "properties": { "BusDate": { "title": "DateTime", "type": "string", "description": "適用日期", "format": "date-time" }, "RouteUID": { "title": "String", "minLength": 1, "type": "string", "description": "路線唯一識別代碼,規則為 {業管機關簡碼} + {RouteID},其中 {業管機關簡碼} 可於Authority API中的AuthorityCode欄位查詢", "xml": { "name": "RouteUID" } }, "RouteID": { "title": "String", "minLength": 1, "type": "string", "description": "地區既用中之路線代碼(為原資料內碼)", "xml": { "name": "RouteID" } }, "RouteName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType" } ], "description": "路線名稱", "xml": { "name": "NameType" } }, "OperatorID": { "title": "String", "minLength": 1, "type": "string", "description": "營運業者代碼", "xml": { "name": "OperatorID" } }, "OperatorCode": { "title": "String", "type": "string", "description": "營運業者簡碼", "nullable": true, "xml": { "name": "OperatorCode" } }, "SubRouteUID": { "title": "String", "minLength": 1, "type": "string", "description": "附屬路線唯一識別代碼,規則為 {業管機關簡碼} + {SubRouteID},其中 {業管機關簡碼} 可於Authority API中的AuthorityCode欄位查詢", "xml": { "name": "SubRouteUID" } }, "SubRouteID": { "title": "String", "minLength": 1, "type": "string", "description": "地區既用中之附屬路線代碼(為原資料內碼)", "xml": { "name": "SubRouteID" } }, "SubRouteName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType" } ], "description": "附屬路線名稱", "nullable": true, "xml": { "name": "NameType" } }, "DestinationStopID": { "title": "String", "minLength": 1, "type": "string", "description": "迄點站站牌代碼,機關定義站牌代號(為原資料內碼)", "xml": { "name": "DestinationStopID" } }, "DestinationStopName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType" } ], "description": "迄點站站牌名稱", "nullable": true, "xml": { "name": "NameType" } }, "Stops": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusDailyStopTimeTableStop" }, "description": "公車站牌停靠資料", "xml": { "name": "Stop" } }, "UpdateTime": { "title": "DateTime", "type": "string", "description": "資料更新日期時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" } }, "additionalProperties": false, "xml": { "name": "BusDailyStopTimeTable" } }, "PTX.Service.DTO.Bus.Specification.V2.BusDailyStopTimeTable21": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusDailyStopTimeTable" }, "PTX.Service.DTO.Bus.Specification.V2.BusDailyStopTimeTableStop": { "title": "Stop", "required": [ "StopID", "StopUID" ], "type": "object", "properties": { "StopUID": { "title": "String", "minLength": 1, "type": "string", "description": "站牌唯一識別代碼,規則為 {業管機關代碼} + {StopID},其中 {業管機關代碼} 可於Authority API中的AuthorityCode欄位查詢", "xml": { "name": "StopUID" } }, "StopID": { "title": "String", "minLength": 1, "type": "string", "description": "地區既用中之站牌代碼(為原資料內碼)", "xml": { "name": "StopID" } }, "StopName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType" } ], "description": "站牌名稱", "nullable": true, "xml": { "name": "NameType" } }, "TimeTables": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusDailyStopTimeTableTimeTable" }, "description": "預定班表", "nullable": true, "xml": { "name": "TimeTable" } } }, "additionalProperties": false, "xml": { "name": "Stop" } }, "PTX.Service.DTO.Bus.Specification.V2.BusDailyStopTimeTableTimeTable": { "title": "TimeTable", "required": [ "ArrivalTime", "DepartureTime", "Sequence", "TimeType" ], "type": "object", "properties": { "Sequence": { "title": "Int32", "type": "integer", "description": "發車順序(由1開始)", "format": "int32" }, "TripID": { "title": "String", "type": "string", "description": "班次代碼", "nullable": true, "xml": { "name": "TripID" } }, "IsLowFloor": { "type": "boolean", "description": "該路線班次是否使用低地板公車車輛 , 0 = 否 , 1 = 是", "nullable": true }, "ArrivalTime": { "title": "String", "minLength": 1, "type": "string", "description": "到站時間,格式為:HH:mm", "xml": { "name": "ArrivalTime" } }, "DepartureTime": { "title": "String", "minLength": 1, "type": "string", "description": "離站時間,格式為:HH:mm", "xml": { "name": "DepartureTime" } }, "TimeType": { "title": "Int32", "type": "integer", "description": "時刻表時間類型 : [0:'估算時間',1:'表訂時間']", "format": "int32" } }, "additionalProperties": false, "xml": { "name": "TimeTable" } } }, "securitySchemes": { "TDX": { "type": "oauth2", "description": "TDX會員可至【會員專區-資料服務-服務金鑰】功能頁面,從預設金鑰(或建立新的金鑰)取得Client Id和Client Secret資訊,分別輸入至下方client_id和client_secret欄位、按下Authorize按鈕,即可開始於Swagger介面呼叫TDX API。", "flows": { "clientCredentials": { "tokenUrl": "https://tdx.transportdata.tw/auth/realms/TDXConnect/protocol/openid-connect/token", "scopes": { } } } } } }, "security": [ { "TDX": [ ] } ], "tags": [ { "name": "CityBus", "description": "市區公車" }, { "name": "InterCityBus", "description": "公路客運" }, { "name": "Bus(CityBus+InterCityBus)", "description": "公車(市區公車+公路客運)" } ] }