{ "openapi": "3.0.4", "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/5fa88b0c-120b-43f1-b188-c379ddb2593d)", "termsOfService": "https://tdx.transportdata.tw/term", "contact": { "name": "TDX客服信箱", "email": "tdx@motc.gov.tw" }, "version": "v3" }, "servers": [ { "url": "https://tdx.transportdata.tw/api/basic" } ], "paths": { "/v3/Rail/TRA/Network": { "get": { "tags": [ "TRA" ], "summary": "取得臺鐵路網資料", "description": "取得臺鐵路網資料", "operationId": "NetworkApiController_Get_3200", "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": "$count", "in": "query", "description": "查詢數量", "schema": { "enum": [ true, false ], "type": "boolean" } }, { "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.API.Rail.Model.TRABaseWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.Network.Network]" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.API.Rail.Model.TRABaseWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.Network.Network]" } } } }, "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" } } } } } } }, "/v3/Rail/TRA/Station": { "get": { "tags": [ "TRA" ], "summary": "取得車站基本資料", "description": "取得車站基本資料", "operationId": "StationApiController_Get_3201", "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": "$count", "in": "query", "description": "查詢數量", "schema": { "enum": [ true, false ], "type": "boolean" } }, { "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.API.Rail.Model.TRABaseWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.Station]" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.API.Rail.Model.TRABaseWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.Station]" } } } }, "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" } } } } } } }, "/v3/Rail/TRA/StationExit": { "get": { "tags": [ "TRA" ], "summary": "取得車站出入口基本資料", "description": "取得車站出入口基本資料", "operationId": "StationExitApiController_Get_3202", "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": "$count", "in": "query", "description": "查詢數量", "schema": { "enum": [ true, false ], "type": "boolean" } }, { "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.API.Rail.Model.TRABaseWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.StationExit.StationExit]" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.API.Rail.Model.TRABaseWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.StationExit.StationExit]" } } } }, "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" } } } } } } }, "/v3/Rail/TRA/StationFacility": { "get": { "tags": [ "TRA" ], "summary": "取得車站設施資料", "description": "取得車站設施資料", "operationId": "StationFacilityApiController_Get_3203", "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": "$count", "in": "query", "description": "查詢數量", "schema": { "enum": [ true, false ], "type": "boolean" } }, { "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.API.Rail.Model.TRABaseWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.StationFacility.StationFacility]" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.API.Rail.Model.TRABaseWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.StationFacility.StationFacility]" } } } }, "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" } } } } } } }, "/v3/Rail/TRA/Line": { "get": { "tags": [ "TRA" ], "summary": "取得路線基本資料", "description": "取得路線基本資料", "operationId": "LineApiController_Get_3204", "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": "$count", "in": "query", "description": "查詢數量", "schema": { "enum": [ true, false ], "type": "boolean" } }, { "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.API.Rail.Model.TRABaseWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.Line]" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.API.Rail.Model.TRABaseWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.Line]" } } } }, "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" } } } } } } }, "/v3/Rail/TRA/StationOfLine": { "get": { "tags": [ "TRA" ], "summary": "取得路線車站基本資料", "description": "取得路線車站基本資料", "operationId": "StationOfLineApiController_Get_3205", "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": "$count", "in": "query", "description": "查詢數量", "schema": { "enum": [ true, false ], "type": "boolean" } }, { "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.API.Rail.Model.TRABaseWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.StationOfLine.StationOfLine]" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.API.Rail.Model.TRABaseWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.StationOfLine.StationOfLine]" } } } }, "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" } } } } } } }, "/v3/Rail/TRA/TrainType": { "get": { "tags": [ "TRA" ], "summary": "取得所有列車車種資料", "description": "取得所有列車車種資料", "operationId": "TrainTypeApiController_Get_3206", "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": "$count", "in": "query", "description": "查詢數量", "schema": { "enum": [ true, false ], "type": "boolean" } }, { "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.API.Rail.Model.TRABaseWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.TrainType]" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.API.Rail.Model.TRABaseWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.TrainType]" } } } }, "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" } } } } } } }, "/v3/Rail/TRA/ODFare": { "get": { "tags": [ "TRA" ], "summary": "取得票價資料(檔案)", "description": "取得Gzip壓縮檔", "operationId": "ODFareApiControllerApiController_Get_3207", "parameters": [ { "name": "health", "in": "query", "description": "加入參數'?health=true'即可查詢此API服務的健康狀態", "schema": { "enum": [ "true", "false" ], "type": "string" } } ], "responses": { "200": { "description": "Gzipped Attachment Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PTX.API.Rail.Model.TRAODFareWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.ODFare.ODFare]" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.API.Rail.Model.TRAODFareWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.ODFare.ODFare]" } } } }, "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" } } } } } } }, "/v3/Rail/TRA/ODFare/{OriginStationID}/to/{DestinationStationID}": { "get": { "tags": [ "TRA" ], "summary": "取得指定起迄站間票價資料", "description": "取得指定起迄站間票價資料", "operationId": "ODFareApiControllerApiController_Get_3207_1", "parameters": [ { "name": "OriginStationID", "in": "path", "description": "起點車站代碼", "required": true, "schema": { "title": "String", "type": "string", "xml": { } } }, { "name": "DestinationStationID", "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": "$count", "in": "query", "description": "查詢數量", "schema": { "enum": [ true, false ], "type": "boolean" } }, { "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.API.Rail.Model.TRAODFareWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.ODFare.ODFare]" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.API.Rail.Model.TRAODFareWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.ODFare.ODFare]" } } } }, "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" } } } } } } }, "/v3/Rail/TRA/GeneralTrainTimetable": { "get": { "tags": [ "TRA" ], "summary": "取得所有車次的定期時刻表資料", "description": "取得所有車次的定期時刻表資料", "operationId": "GeneralTrainTimetableApiController_Get_3208", "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": "$count", "in": "query", "description": "查詢數量", "schema": { "enum": [ true, false ], "type": "boolean" } }, { "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.API.Rail.Model.TRAGeneralTrainWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.GeneralTrainTimetable]" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.API.Rail.Model.TRAGeneralTrainWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.GeneralTrainTimetable]" } } } }, "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" } } } } } } }, "/v3/Rail/TRA/GeneralTrainTimetable/TrainNo/{TrainNo}": { "get": { "tags": [ "TRA" ], "summary": "取得指定[車次]的定期時刻表資料", "description": "取得指定[車次]的定期時刻表資料", "operationId": "GeneralTrainTimetableApiController_Get_3208_1", "parameters": [ { "name": "TrainNo", "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": "$count", "in": "query", "description": "查詢數量", "schema": { "enum": [ true, false ], "type": "boolean" } }, { "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.API.Rail.Model.TRAGeneralTrainWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.GeneralTrainTimetable]" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.API.Rail.Model.TRAGeneralTrainWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.GeneralTrainTimetable]" } } } }, "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" } } } } } } }, "/v3/Rail/TRA/GeneralStationTimetable": { "get": { "tags": [ "TRA" ], "summary": "取得各站的定期站別時刻表資料", "description": "取得各站的定期站別時刻表資料", "operationId": "GeneralStationTimetableApiController_Get_3209", "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": "$count", "in": "query", "description": "查詢數量", "schema": { "enum": [ true, false ], "type": "boolean" } }, { "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.API.Rail.Model.TRAGeneralStationWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.GeneralStationTimetable.GeneralStationTimetable]" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.API.Rail.Model.TRAGeneralStationWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.GeneralStationTimetable.GeneralStationTimetable]" } } } }, "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" } } } } } } }, "/v3/Rail/TRA/GeneralStationTimetable/Station/{StationID}": { "get": { "tags": [ "TRA" ], "summary": "取得指定[車站]的定期站別時刻表資料", "description": "取得指定[車站]的定期站別時刻表資料", "operationId": "GeneralStationTimetableApiController_Get_3209_1", "parameters": [ { "name": "StationID", "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": "$count", "in": "query", "description": "查詢數量", "schema": { "enum": [ true, false ], "type": "boolean" } }, { "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.API.Rail.Model.TRAGeneralStationWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.GeneralStationTimetable.GeneralStationTimetable]" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.API.Rail.Model.TRAGeneralStationWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.GeneralStationTimetable.GeneralStationTimetable]" } } } }, "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" } } } } } } }, "/v3/Rail/TRA/SpecificTrainTimetable": { "get": { "tags": [ "TRA" ], "summary": "取得所有特殊車次時刻表資料", "description": "取得所有特殊車次時刻表資料", "operationId": "SpecificTrainTimetableApiController_Get_3210", "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": "$count", "in": "query", "description": "查詢數量", "schema": { "enum": [ true, false ], "type": "boolean" } }, { "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.API.Rail.Model.TRASpecificWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.SpecificTrainTimetable]" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.API.Rail.Model.TRASpecificWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.SpecificTrainTimetable]" } } } }, "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" } } } } } } }, "/v3/Rail/TRA/SpecificTrainTimetable/TrainNo/{TrainNo}": { "get": { "tags": [ "TRA" ], "summary": "取得指定[車次]的特殊車次時刻表資料", "description": "取得指定[車次]的特殊車次時刻表資料", "operationId": "SpecificTrainTimetableApiController_Get_3210_1", "parameters": [ { "name": "TrainNo", "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": "$count", "in": "query", "description": "查詢數量", "schema": { "enum": [ true, false ], "type": "boolean" } }, { "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.API.Rail.Model.TRASpecificWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.SpecificTrainTimetable]" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.API.Rail.Model.TRASpecificWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.SpecificTrainTimetable]" } } } }, "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" } } } } } } }, "/v3/Rail/TRA/DailyTrainTimetable/Today": { "get": { "tags": [ "TRA" ], "summary": "取得當天車次時刻表資料", "description": "取得當天車次時刻表資料", "operationId": "DailyTrainTimeTableApiController_Get_3211", "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": "$count", "in": "query", "description": "查詢數量", "schema": { "enum": [ true, false ], "type": "boolean" } }, { "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.API.Rail.Model.TraDailyTrainWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.DailyTrainTimeTable.TrainTimetable]" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.API.Rail.Model.TraDailyTrainWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.DailyTrainTimeTable.TrainTimetable]" } } } }, "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" } } } } } } }, "/v3/Rail/TRA/DailyTrainTimetable/Today/TrainNo/{TrainNo}": { "get": { "tags": [ "TRA" ], "summary": "取得當天指定[車次]的時刻表資料", "description": "取得當天指定[車次]的時刻表資料", "operationId": "DailyTrainTimeTableApiController_Get_3211_1", "parameters": [ { "name": "TrainNo", "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": "$count", "in": "query", "description": "查詢數量", "schema": { "enum": [ true, false ], "type": "boolean" } }, { "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.API.Rail.Model.TraDailyTrainWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.DailyTrainTimeTable.TrainTimetable]" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.API.Rail.Model.TraDailyTrainWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.DailyTrainTimeTable.TrainTimetable]" } } } }, "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" } } } } } } }, "/v3/Rail/TRA/DailyTrainTimetable/TrainDates": { "get": { "tags": [ "TRA" ], "summary": "取得臺鐵每日時刻表所有供應的日期資料", "description": "取得臺鐵每日時刻表所有供應的日期資料", "operationId": "DailyTrainTimeTableApiController_Get_3211_2", "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.API.Rail.Model.TrainDateList" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.API.Rail.Model.TrainDateList" } } } }, "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" } } } } } } }, "/v3/Rail/TRA/DailyTrainTimetable/TrainDate/{TrainDate}": { "get": { "tags": [ "TRA" ], "summary": "取得指定[日期]所有車次的時刻表資料", "description": "取得指定[日期]所有車次的時刻表資料(台鐵提供近60天每日時刻表)", "operationId": "DailyTrainTimeTableApiController_Get_3211_3", "parameters": [ { "name": "TrainDate", "in": "path", "description": "欲查詢車次的日期(格式: yyyy-MM-dd)", "required": true, "schema": { "title": "DateTime", "type": "string", "format": "date-time" } }, { "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": "$count", "in": "query", "description": "查詢數量", "schema": { "enum": [ true, false ], "type": "boolean" } }, { "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.API.Rail.Model.TraDailyTrainWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.DailyTrainTimeTable.TrainTimetable]" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.API.Rail.Model.TraDailyTrainWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.DailyTrainTimeTable.TrainTimetable]" } } } }, "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" } } } } } } }, "/v3/Rail/TRA/DailyTrainTimetable/OD/{OriginStationID}/to/{DestinationStationID}/{TrainDate}": { "get": { "tags": [ "TRA" ], "summary": "取得指定[日期],[起迄站間]之站間時刻表資料(僅列出查詢的停靠站)", "description": "取得指定[日期],[起迄站間]之站間時刻表資料(僅列出查詢的停靠站)", "operationId": "DailyTrainTimeTableApiController_Get_3211_4", "parameters": [ { "name": "TrainDate", "in": "path", "description": "欲查詢的日期(格式: yyyy-MM-dd)", "required": true, "schema": { "title": "DateTime", "type": "string", "format": "date-time" } }, { "name": "OriginStationID", "in": "path", "description": "起點車站代碼", "required": true, "schema": { "title": "String", "type": "string", "xml": { } } }, { "name": "DestinationStationID", "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": "$count", "in": "query", "description": "查詢數量", "schema": { "enum": [ true, false ], "type": "boolean" } }, { "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.API.Rail.Model.TraDailyTrainWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.DailyTrainTimeTable.TrainTimetable]" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.API.Rail.Model.TraDailyTrainWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.DailyTrainTimeTable.TrainTimetable]" } } } }, "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" } } } } } } }, "/v3/Rail/TRA/DailyTrainTimetable/OD/Inclusive/{OriginStationID}/to/{DestinationStationID}/{TrainDate}": { "get": { "tags": [ "TRA" ], "summary": "取得指定[日期],[起迄站間]之站間時刻表資料", "description": "取得指定[日期],[起迄站間]之站間時刻表資料", "operationId": "DailyTrainTimeTableApiController_Get_3211_5", "parameters": [ { "name": "TrainDate", "in": "path", "description": "欲查詢的日期(格式: yyyy-MM-dd)", "required": true, "schema": { "title": "DateTime", "type": "string", "format": "date-time" } }, { "name": "OriginStationID", "in": "path", "description": "起點車站代碼", "required": true, "schema": { "title": "String", "type": "string", "xml": { } } }, { "name": "DestinationStationID", "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": "$count", "in": "query", "description": "查詢數量", "schema": { "enum": [ true, false ], "type": "boolean" } }, { "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.API.Rail.Model.TraDailyTrainWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.DailyTrainTimeTable.TrainTimetable]" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.API.Rail.Model.TraDailyTrainWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.DailyTrainTimeTable.TrainTimetable]" } } } }, "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" } } } } } } }, "/v3/Rail/TRA/DailyStationTimetable/Today": { "get": { "tags": [ "TRA" ], "summary": "取得當天各站站別時刻表資料", "description": "取得當天各站站別時刻表資料", "operationId": "DailyStationTimeTableApiController_Get_3212", "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": "$count", "in": "query", "description": "查詢數量", "schema": { "enum": [ true, false ], "type": "boolean" } }, { "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.API.Rail.Model.TraDailyStationWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.DailyStationTimeTable.StationTimetable]" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.API.Rail.Model.TraDailyStationWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.DailyStationTimeTable.StationTimetable]" } } } }, "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" } } } } } } }, "/v3/Rail/TRA/DailyStationTimetable/Today/Station/{StationID}": { "get": { "tags": [ "TRA" ], "summary": "取得當天指定[車站]的時刻表資料", "description": "取得當天指定[車站]的時刻表資料", "operationId": "DailyStationTimeTableApiController_Get_3212_1", "parameters": [ { "name": "StationID", "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": "$count", "in": "query", "description": "查詢數量", "schema": { "enum": [ true, false ], "type": "boolean" } }, { "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.API.Rail.Model.TraDailyStationWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.DailyStationTimeTable.StationTimetable]" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.API.Rail.Model.TraDailyStationWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.DailyStationTimeTable.StationTimetable]" } } } }, "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" } } } } } } }, "/v3/Rail/TRA/DailyStationTimetable/TrainDate/{TrainDate}": { "get": { "tags": [ "TRA" ], "summary": "取得各站每日站別時刻表資料", "description": "取得各站每日站別時刻表資料", "operationId": "DailyStationTimeTableApiController_Get_3212_2", "parameters": [ { "name": "TrainDate", "in": "path", "description": "欲查詢的日期(格式: yyyy-MM-dd)", "required": true, "schema": { "title": "DateTime", "type": "string", "format": "date-time" } }, { "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": "$count", "in": "query", "description": "查詢數量", "schema": { "enum": [ true, false ], "type": "boolean" } }, { "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.API.Rail.Model.TraDailyStationWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.DailyStationTimeTable.StationTimetable]" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.API.Rail.Model.TraDailyStationWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.DailyStationTimeTable.StationTimetable]" } } } }, "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" } } } } } } }, "/v3/Rail/TRA/StationLiveBoard": { "get": { "tags": [ "TRA" ], "summary": "取得列車即時到離站資料", "description": "取得列車即時到離站資料", "operationId": "StationLiveBoardApiController_Get_3213", "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": "$count", "in": "query", "description": "查詢數量", "schema": { "enum": [ true, false ], "type": "boolean" } }, { "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.API.Rail.Model.TRARealTimeWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.TRAStationLiveBoardList.StationLiveBoard]" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.API.Rail.Model.TRARealTimeWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.TRAStationLiveBoardList.StationLiveBoard]" } } } }, "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" } } } } } } }, "/v3/Rail/TRA/StationLiveBoard/Station/{StationID}": { "get": { "tags": [ "TRA" ], "summary": "取得指定[車站]的列車即時到離站資料", "description": "取得指定[車站]的列車即時到離站資料", "operationId": "StationLiveBoardApiController_Get_3213_1", "parameters": [ { "name": "StationID", "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": "$count", "in": "query", "description": "查詢數量", "schema": { "enum": [ true, false ], "type": "boolean" } }, { "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.API.Rail.Model.TRARealTimeWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.TRAStationLiveBoardList.StationLiveBoard]" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.API.Rail.Model.TRARealTimeWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.TRAStationLiveBoardList.StationLiveBoard]" } } } }, "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" } } } } } } }, "/v3/Rail/TRA/TrainLiveBoard": { "get": { "tags": [ "TRA" ], "summary": "取得列車即時位置動態資料", "description": "取得列車即時位置動態資料\n\n## 使用注意事項\n1. 本項資料為「列車目前所在之車站」資料,而更新資料的時機點為「列車離站時」(由 CTC 提供),其內容之車站資料可能為經過站,也可能為停靠站。\n2. 以「145車次」為例,如果車站名稱為「萬華」,表示 145 車次剛從萬華離開,而不是正前往萬華,另萬華站為145 車次之經過站,非停靠站。\n3. 提供所有經過站資料是為確保車次的準誤點資料都會是最新的 (尤其是東部幹線普悠瑪、太魯閣車次,因停靠站少,更新頻率低的話會使呈現的準誤點時間誤差過大)。\n4. 基於上述原因,本項資料並非僅提供列車停靠站資料,因為這樣提供方式會使列車位置資訊更狹隘,例如:只知道離開台北站,不曉得經過哪一站了,故請加值者使用時多加注意。", "operationId": "TrainLiveBoardApiController_Get_3214", "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": "$count", "in": "query", "description": "查詢數量", "schema": { "enum": [ true, false ], "type": "boolean" } }, { "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.API.Rail.Model.TRARealTimeWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.TRATrainLiveBoardList.TrainLiveBoard]" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.API.Rail.Model.TRARealTimeWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.TRATrainLiveBoardList.TrainLiveBoard]" } } } }, "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" } } } } } } }, "/v3/Rail/TRA/TrainLiveBoard/TrainNo/{TrainNo}": { "get": { "tags": [ "TRA" ], "summary": "取得指定[車次]的列車即時位置動態資料", "description": "取得指定[車次]的列車即時位置動態資料\n\n## 使用注意事項\n1. 本項資料為「列車目前所在之車站」資料,而更新資料的時機點為「列車離站時」(由 CTC 提供),其內容之車站資料可能為經過站,也可能為停靠站。\n2. 以「145車次」為例,如果車站名稱為「萬華」,表示 145 車次剛從萬華離開,而不是正前往萬華,另萬華站為145 車次之經過站,非停靠站。\n3. 提供所有經過站資料是為確保車次的準誤點資料都會是最新的 (尤其是東部幹線普悠瑪、太魯閣車次,因停靠站少,更新頻率低的話會使呈現的準誤點時間誤差過大)。\n4. 基於上述原因,本項資料並非僅提供列車停靠站資料,因為這樣提供方式會使列車位置資訊更狹隘,例如:只知道離開台北站,不曉得經過哪一站了,故請加值者使用時多加注意。", "operationId": "TrainLiveBoardApiController_Get_3214_1", "parameters": [ { "name": "TrainNo", "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": "$count", "in": "query", "description": "查詢數量", "schema": { "enum": [ true, false ], "type": "boolean" } }, { "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.API.Rail.Model.TRARealTimeWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.TRATrainLiveBoardList.TrainLiveBoard]" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.API.Rail.Model.TRARealTimeWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.TRATrainLiveBoardList.TrainLiveBoard]" } } } }, "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" } } } } } } }, "/v3/Rail/TRA/LineTransfer": { "get": { "tags": [ "TRA" ], "summary": "取得內部路線轉乘資料", "description": "取得內部路線轉乘資料", "operationId": "LineTransferApiController_Get_3215", "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": "$count", "in": "query", "description": "查詢數量", "schema": { "enum": [ true, false ], "type": "boolean" } }, { "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.API.Rail.Model.TRABaseWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.LineTransfer]" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.API.Rail.Model.TRABaseWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.LineTransfer]" } } } }, "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" } } } } } } }, "/v3/Rail/TRA/StationTransfer": { "get": { "tags": [ "TRA" ], "summary": "取得車站跨運具轉乘資訊", "description": "取得車站跨運具轉乘資訊", "operationId": "StationTransferApiController_Get_3216", "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": "$count", "in": "query", "description": "查詢數量", "schema": { "enum": [ true, false ], "type": "boolean" } }, { "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.API.Rail.Model.TRABaseWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.StationTransfer.StationTransfer]" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.API.Rail.Model.TRABaseWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.StationTransfer.StationTransfer]" } } } }, "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" } } } } } } }, "/v3/Rail/TRA/News": { "get": { "tags": [ "TRA" ], "summary": "取得最新消息", "description": "取得最新消息", "operationId": "NewsApiController_Get_3217", "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": "$count", "in": "query", "description": "查詢數量", "schema": { "enum": [ true, false ], "type": "boolean" } }, { "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.API.Rail.Model.TRARealTimeWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.TRANewsList.News]" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.API.Rail.Model.TRARealTimeWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.TRANewsList.News]" } } } }, "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" } } } } } } }, "/v3/Rail/TRA/Alert": { "get": { "tags": [ "TRA" ], "summary": "取得營運通阻資料", "description": "取得營運通阻資料", "operationId": "AlertApiController_Get_3218", "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": "$count", "in": "query", "description": "查詢數量", "schema": { "enum": [ true, false ], "type": "boolean" } }, { "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.API.Rail.Model.TRARealTimeWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.TRAAlertList.Alert]" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.API.Rail.Model.TRARealTimeWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.TRAAlertList.Alert]" } } } }, "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" } } } } } } }, "/v3/Rail/TRA/Shape": { "get": { "tags": [ "TRA" ], "summary": "取得線型基本資料", "description": "取得線型基本資料", "operationId": "ShapeApiController_Get_3219", "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": "$count", "in": "query", "description": "查詢數量", "schema": { "enum": [ true, false ], "type": "boolean" } }, { "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.API.Rail.Model.TRABaseWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.Shape]" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.API.Rail.Model.TRABaseWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.Shape]" } } } }, "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" } } } } } } }, "/v3/Rail/TRA/Operator": { "get": { "tags": [ "TRA" ], "summary": "取得台鐵營運業者基本資料", "description": "取得台鐵營運業者基本資料", "operationId": "OperatorApiController_Get_3220", "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": "$count", "in": "query", "description": "查詢數量", "schema": { "enum": [ true, false ], "type": "boolean" } }, { "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.API.Rail.Model.TRABaseWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.Operator]" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.API.Rail.Model.TRABaseWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.Operator]" } } } }, "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" } } } } } } }, "/v3/Rail/TRA/LineNetwork": { "get": { "tags": [ "TRA" ], "summary": "取得路線網路拓撲基本資料", "description": "取得路線網路拓撲基本資料", "operationId": "LineNetworkApiController_Get_3221", "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": "$count", "in": "query", "description": "查詢數量", "schema": { "enum": [ true, false ], "type": "boolean" } }, { "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.API.Rail.Model.TRABaseWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.LineNetwork.LineNetwork]" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.API.Rail.Model.TRABaseWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.LineNetwork.LineNetwork]" } } } }, "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" } } } } } } }, "/v3/Rail/AFR/Network": { "get": { "tags": [ "AFR" ], "summary": "取得路網資料", "description": "取得路網資料", "operationId": "LiteTrain_Network_3281", "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": "$count", "in": "query", "description": "查詢數量", "schema": { "enum": [ true, false ], "type": "boolean" } }, { "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.API.Rail.Model.LiteTrain.LiteTrainBaseWrapper[PTX.Service.DTO.Rail.Specification.V3.LiteTrain.Network.Network]" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.API.Rail.Model.LiteTrain.LiteTrainBaseWrapper[PTX.Service.DTO.Rail.Specification.V3.LiteTrain.Network.Network]" } } } }, "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" } } } } } } }, "/v3/Rail/AFR/Station": { "get": { "tags": [ "AFR" ], "summary": "取得車站基本資料", "description": "取得車站基本資料", "operationId": "LiteTrain_Station_3282", "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": "$count", "in": "query", "description": "查詢數量", "schema": { "enum": [ true, false ], "type": "boolean" } }, { "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.API.Rail.Model.LiteTrain.LiteTrainBaseWrapper[PTX.Service.DTO.Rail.Specification.V3.LiteTrain.Station]" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.API.Rail.Model.LiteTrain.LiteTrainBaseWrapper[PTX.Service.DTO.Rail.Specification.V3.LiteTrain.Station]" } } } }, "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" } } } } } } }, "/v3/Rail/AFR/Line": { "get": { "tags": [ "AFR" ], "summary": "取得路線基本資料", "description": "取得路線基本資料", "operationId": "LiteTrain_Line_3283", "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": "$count", "in": "query", "description": "查詢數量", "schema": { "enum": [ true, false ], "type": "boolean" } }, { "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.API.Rail.Model.LiteTrain.LiteTrainBaseWrapper[PTX.Service.DTO.Rail.Specification.V3.LiteTrain.Line]" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.API.Rail.Model.LiteTrain.LiteTrainBaseWrapper[PTX.Service.DTO.Rail.Specification.V3.LiteTrain.Line]" } } } }, "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" } } } } } } }, "/v3/Rail/AFR/Operator": { "get": { "tags": [ "AFR" ], "summary": "取得營運業者基本資料", "description": "取得營運業者基本資料", "operationId": "LiteTrain_Operator_3284", "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": "$count", "in": "query", "description": "查詢數量", "schema": { "enum": [ true, false ], "type": "boolean" } }, { "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.API.Rail.Model.LiteTrain.LiteTrainBaseWrapper[PTX.Service.DTO.Rail.Specification.V3.LiteTrain.Operator]" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.API.Rail.Model.LiteTrain.LiteTrainBaseWrapper[PTX.Service.DTO.Rail.Specification.V3.LiteTrain.Operator]" } } } }, "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" } } } } } } }, "/v3/Rail/AFR/GeneralTrainTimetable": { "get": { "tags": [ "AFR" ], "summary": "取得所有車次的定期時刻表資料", "description": "取得所有車次的定期時刻表資料", "operationId": "LiteTrain_GeneralTrainTimetable_3285", "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": "$count", "in": "query", "description": "查詢數量", "schema": { "enum": [ true, false ], "type": "boolean" } }, { "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.API.Rail.Model.LiteTrain.LiteTrainGeneralTrainWrapper[PTX.Service.DTO.Rail.Specification.V3.LiteTrain.GeneralTrainTimetable]" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.API.Rail.Model.LiteTrain.LiteTrainGeneralTrainWrapper[PTX.Service.DTO.Rail.Specification.V3.LiteTrain.GeneralTrainTimetable]" } } } }, "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" } } } } } } }, "/v3/Rail/AFR/GeneralTrainTimetable/TrainNo/{TrainNo}": { "get": { "tags": [ "AFR" ], "summary": "取得指定[車次]的定期時刻表資料", "description": "取得指定[車次]的定期時刻表資料", "operationId": "LiteTrain_GeneralTrainTimetable_3285_1", "parameters": [ { "name": "TrainNo", "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": "$count", "in": "query", "description": "查詢數量", "schema": { "enum": [ true, false ], "type": "boolean" } }, { "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.API.Rail.Model.LiteTrain.LiteTrainGeneralTrainWrapper[PTX.Service.DTO.Rail.Specification.V3.LiteTrain.GeneralTrainTimetable]" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.API.Rail.Model.LiteTrain.LiteTrainGeneralTrainWrapper[PTX.Service.DTO.Rail.Specification.V3.LiteTrain.GeneralTrainTimetable]" } } } }, "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" } } } } } } }, "/v3/Rail/AFR/ODFare": { "get": { "tags": [ "AFR" ], "summary": "取得所有票價資料", "description": "取得所有票價資料", "operationId": "LiteTrain_ODFare_3286", "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": "$count", "in": "query", "description": "查詢數量", "schema": { "enum": [ true, false ], "type": "boolean" } }, { "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.API.Rail.Model.LiteTrain.LiteTrainODFareWrapper[PTX.Service.DTO.Rail.Specification.V3.LiteTrain.ODFare.ODFare]" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.API.Rail.Model.LiteTrain.LiteTrainODFareWrapper[PTX.Service.DTO.Rail.Specification.V3.LiteTrain.ODFare.ODFare]" } } } }, "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" } } } } } } }, "/v3/Rail/AFR/ODFare/{OriginStationID}/to/{DestinationStationID}": { "get": { "tags": [ "AFR" ], "summary": "取得指定起迄站間票價資料", "description": "取得指定起迄站間票價資料", "operationId": "LiteTrain_ODFare_3286_1", "parameters": [ { "name": "OriginStationID", "in": "path", "description": "起點車站代碼", "required": true, "schema": { "title": "String", "type": "string", "xml": { } } }, { "name": "DestinationStationID", "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": "$count", "in": "query", "description": "查詢數量", "schema": { "enum": [ true, false ], "type": "boolean" } }, { "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.API.Rail.Model.LiteTrain.LiteTrainODFareWrapper[PTX.Service.DTO.Rail.Specification.V3.LiteTrain.ODFare.ODFare]" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.API.Rail.Model.LiteTrain.LiteTrainODFareWrapper[PTX.Service.DTO.Rail.Specification.V3.LiteTrain.ODFare.ODFare]" } } } }, "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" } } } } } } }, "/v3/Rail/AFR/Route": { "get": { "tags": [ "AFR" ], "summary": "取得營運路線基本資料", "description": "取得營運路線基本資料", "operationId": "LiteTrain_Route_3287", "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": "$count", "in": "query", "description": "查詢數量", "schema": { "enum": [ true, false ], "type": "boolean" } }, { "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.API.Rail.Model.LiteTrain.LiteTrainBaseWrapper[PTX.Service.DTO.Rail.Specification.V3.LiteTrain.Route]" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.API.Rail.Model.LiteTrain.LiteTrainBaseWrapper[PTX.Service.DTO.Rail.Specification.V3.LiteTrain.Route]" } } } }, "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" } } } } } } }, "/v3/Rail/AFR/StationOfLine": { "get": { "tags": [ "AFR" ], "summary": "取得路線車站基本資料", "description": "取得路線車站基本資料", "operationId": "LiteTrain_StationOfLine_3288", "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": "$count", "in": "query", "description": "查詢數量", "schema": { "enum": [ true, false ], "type": "boolean" } }, { "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.API.Rail.Model.LiteTrain.LiteTrainBaseWrapper[PTX.Service.DTO.Rail.Specification.V3.LiteTrain.StationOfLine.StationOfLine]" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.API.Rail.Model.LiteTrain.LiteTrainBaseWrapper[PTX.Service.DTO.Rail.Specification.V3.LiteTrain.StationOfLine.StationOfLine]" } } } }, "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" } } } } } } }, "/v3/Rail/AFR/TrainType": { "get": { "tags": [ "AFR" ], "summary": "取得所有列車車種資料", "description": "取得所有列車車種資料", "operationId": "LiteTrain_TrainType_3289", "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": "$count", "in": "query", "description": "查詢數量", "schema": { "enum": [ true, false ], "type": "boolean" } }, { "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.API.Rail.Model.LiteTrain.LiteTrainBaseWrapper[PTX.Service.DTO.Rail.Specification.V3.LiteTrain.TrainType]" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.API.Rail.Model.LiteTrain.LiteTrainBaseWrapper[PTX.Service.DTO.Rail.Specification.V3.LiteTrain.TrainType]" } } } }, "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" } } } } } } }, "/v3/Rail/AFR/StationOfRoute": { "get": { "tags": [ "AFR" ], "summary": "取得營運路線車站基本資料", "description": "取得營運路線車站基本資料", "operationId": "LiteTrain_StationOfRoute_3290", "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": "$count", "in": "query", "description": "查詢數量", "schema": { "enum": [ true, false ], "type": "boolean" } }, { "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.API.Rail.Model.LiteTrain.LiteTrainBaseWrapper[PTX.Service.DTO.Rail.Specification.V3.LiteTrain.StationOfRoute.StationOfRoute]" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.API.Rail.Model.LiteTrain.LiteTrainBaseWrapper[PTX.Service.DTO.Rail.Specification.V3.LiteTrain.StationOfRoute.StationOfRoute]" } } } }, "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" } } } } } } }, "/v3/Rail/AFR/News": { "get": { "tags": [ "AFR" ], "summary": "取得最新消息", "description": "取得最新消息", "operationId": "LiteTrain_News_3291", "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": "$count", "in": "query", "description": "查詢數量", "schema": { "enum": [ true, false ], "type": "boolean" } }, { "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.API.Rail.Model.LiteTrain.LiteTrainRealTimeWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.TRANewsList.News]" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.API.Rail.Model.LiteTrain.LiteTrainRealTimeWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.TRANewsList.News]" } } } }, "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" } } } } } } }, "/v3/Rail/AFR/Shape": { "get": { "tags": [ "AFR" ], "summary": "取得線型基本資料", "description": "取得線型基本資料", "operationId": "LiteTrain_Shape_3213", "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": "$count", "in": "query", "description": "查詢數量", "schema": { "enum": [ true, false ], "type": "boolean" } }, { "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.API.Rail.Model.LiteTrain.LiteTrainBaseWrapper[PTX.Service.DTO.Rail.Specification.V3.LiteTrain.Shape]" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PTX.API.Rail.Model.LiteTrain.LiteTrainBaseWrapper[PTX.Service.DTO.Rail.Specification.V3.LiteTrain.Shape]" } } } }, "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" } } } } } } } }, "components": { "schemas": { "PTX.API.Rail.Model.TRABaseWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.Network.Network]": { "title": "TRANetworkList", "required": [ "AuthorityCode", "Items", "SrcUpdateInterval", "SrcUpdateTime", "UpdateInterval", "UpdateTime" ], "type": "object", "properties": { "UpdateTime": { "type": "string", "description": "本平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "UpdateInterval": { "title": "Int32", "type": "integer", "description": "本平台資料更新週期(秒)", "format": "int32" }, "SrcUpdateTime": { "title": "DateTime", "type": "string", "description": "來源端平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "SrcUpdateInterval": { "title": "Int32", "type": "integer", "description": "來源端平台資料更新週期(秒)['-1: 不定期更新']", "format": "int32" }, "AuthorityCode": { "title": "String", "minLength": 1, "type": "string", "description": "業管機關簡碼", "xml": { "name": "AuthorityCode" } }, "Items": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.Network.Network" }, "description": "資料(陣列)", "xml": { "name": "List`1" } }, "Count": { "type": "integer", "description": "資料總筆數", "format": "int64", "nullable": true } }, "additionalProperties": false, "xml": { "name": "TRABaseWrapperOfNetwork", "namespace": "https://ptx.transportdata.tw/standard/schema/" } }, "PTX.Service.DTO.Rail.Specification.V3.TRA.Network.Network": { "title": "Network", "required": [ "Lines", "NetworkID", "NetworkMapURL", "NetworkName", "OperatorCode", "OperatorName" ], "type": "object", "properties": { "NetworkID": { "title": "String", "minLength": 1, "type": "string", "description": "路網代碼", "xml": { "name": "NetworkID" } }, "NetworkName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "路網名稱", "xml": { "name": "NameType" } }, "OperatorCode": { "title": "String", "minLength": 1, "type": "string", "description": "營運業者代碼", "xml": { "name": "OperatorCode" } }, "OperatorName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "營運業者名稱", "xml": { "name": "NameType" } }, "NetworkMapURL": { "title": "MapNameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.Network.MapNameType" } ], "description": "路網圖網址URL", "xml": { "name": "MapNameType" } }, "Lines": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.Network.Line" }, "description": "路線資訊", "xml": { "name": "List`1" } } }, "additionalProperties": false, "description": "路網資料", "xml": { "name": "Network" } }, "PTX.Service.DTO.Rail.Specification.V3.TRA.Network.Line": { "title": "Line", "required": [ "LineID", "LineNo" ], "type": "object", "properties": { "LineNo": { "title": "String", "minLength": 1, "type": "string", "description": "路線編號", "xml": { "name": "LineNo" } }, "LineID": { "title": "String", "minLength": 1, "type": "string", "description": "路線代碼", "xml": { "name": "LineID" } } }, "additionalProperties": false, "description": "路線基本資料", "xml": { "name": "Line" } }, "PTX.Service.DTO.Shared.Specification.V3.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, "xml": { "name": "NameType" } }, "PTX.Service.DTO.Rail.Specification.V3.TRA.Network.MapNameType": { "title": "MapNameType", "type": "object", "properties": { "MapName": { "title": "String", "type": "string", "description": "路網圖名稱", "nullable": true, "xml": { "name": "MapName" } }, "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, "xml": { "name": "MapNameType" } }, "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.API.Rail.Model.TRABaseWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.Station]": { "title": "TRAStationList", "required": [ "AuthorityCode", "Items", "SrcUpdateInterval", "SrcUpdateTime", "UpdateInterval", "UpdateTime" ], "type": "object", "properties": { "UpdateTime": { "type": "string", "description": "本平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "UpdateInterval": { "title": "Int32", "type": "integer", "description": "本平台資料更新週期(秒)", "format": "int32" }, "SrcUpdateTime": { "title": "DateTime", "type": "string", "description": "來源端平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "SrcUpdateInterval": { "title": "Int32", "type": "integer", "description": "來源端平台資料更新週期(秒)['-1: 不定期更新']", "format": "int32" }, "AuthorityCode": { "title": "String", "minLength": 1, "type": "string", "description": "業管機關簡碼", "xml": { "name": "AuthorityCode" } }, "Items": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.Station" }, "description": "資料(陣列)", "xml": { "name": "List`1" } }, "Count": { "type": "integer", "description": "資料總筆數", "format": "int64", "nullable": true } }, "additionalProperties": false, "xml": { "name": "TRABaseWrapperOfStation", "namespace": "https://ptx.transportdata.tw/standard/schema/" } }, "PTX.Service.DTO.Rail.Specification.V3.TRA.Station": { "title": "Station", "required": [ "StationID", "StationName", "StationPosition", "StationUID" ], "type": "object", "properties": { "StationUID": { "title": "String", "minLength": 1, "type": "string", "description": "車站唯一識別代碼", "xml": { "name": "StationUID" } }, "StationID": { "title": "String", "minLength": 1, "type": "string", "description": "車站代碼", "xml": { "name": "StationID" } }, "ReservationCode": { "title": "String", "type": "string", "description": "訂票車站代碼", "nullable": true, "xml": { "name": "ReservationCode" } }, "StationName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "車站名稱", "xml": { "name": "NameType" } }, "StationPosition": { "title": "PointType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.PointType" } ], "description": "車站座標(WGS84)", "xml": { "name": "PointType" } }, "StationAddress": { "title": "String", "type": "string", "description": "車站地址", "nullable": true, "xml": { "name": "StationAddress" } }, "StationPhone": { "title": "String", "type": "string", "description": "車站聯絡電話", "nullable": true, "xml": { "name": "StationPhone" } }, "StationClass": { "title": "String", "type": "string", "description": "車站級別 = ['0: 特等', '1: 一等', '2: 二等', '3: 三等', '4: 簡易', '5: 招呼', '6: 號誌', 'A: 貨運', 'B: 基地', 'X: 非車']", "nullable": true, "xml": { "name": "StationClass" } }, "StationURL": { "title": "String", "type": "string", "description": "車站資訊說明網址", "nullable": true, "xml": { "name": "StationURL" } } }, "additionalProperties": false, "description": "車站資料", "xml": { "name": "Station" } }, "PTX.Service.DTO.Shared.Specification.V3.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 } }, "additionalProperties": false, "description": "座標資料型別", "xml": { "name": "PointType" } }, "PTX.API.Rail.Model.TRABaseWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.StationExit.StationExit]": { "title": "TRAStationExitList", "required": [ "AuthorityCode", "Items", "SrcUpdateInterval", "SrcUpdateTime", "UpdateInterval", "UpdateTime" ], "type": "object", "properties": { "UpdateTime": { "type": "string", "description": "本平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "UpdateInterval": { "title": "Int32", "type": "integer", "description": "本平台資料更新週期(秒)", "format": "int32" }, "SrcUpdateTime": { "title": "DateTime", "type": "string", "description": "來源端平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "SrcUpdateInterval": { "title": "Int32", "type": "integer", "description": "來源端平台資料更新週期(秒)['-1: 不定期更新']", "format": "int32" }, "AuthorityCode": { "title": "String", "minLength": 1, "type": "string", "description": "業管機關簡碼", "xml": { "name": "AuthorityCode" } }, "Items": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.StationExit.StationExit" }, "description": "資料(陣列)", "xml": { "name": "List`1" } }, "Count": { "type": "integer", "description": "資料總筆數", "format": "int64", "nullable": true } }, "additionalProperties": false, "xml": { "name": "TRABaseWrapperOfStationExit", "namespace": "https://ptx.transportdata.tw/standard/schema/" } }, "PTX.Service.DTO.Rail.Specification.V3.TRA.StationExit.StationExit": { "title": "StationExit", "required": [ "Exits", "StationID", "StationName" ], "type": "object", "properties": { "StationID": { "title": "String", "minLength": 1, "type": "string", "description": "出入口所屬車站代碼", "xml": { "name": "StationID" } }, "StationName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "車站名稱", "xml": { "name": "NameType" } }, "Exits": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.StationExit.Exit" }, "description": "車站出入口", "xml": { "name": "Exit" } }, "ExitMapURLs": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.StationExit.ExitMapURL" }, "description": "車站出入口簡圖網址連結資訊", "nullable": true, "xml": { "name": "ExitMapURL" } } }, "additionalProperties": false, "description": "車站出入口資料", "xml": { "name": "StationExit" } }, "PTX.Service.DTO.Rail.Specification.V3.TRA.StationExit.Exit": { "title": "Exit", "required": [ "Escalator", "ExitID", "ExitName", "ExitPosition" ], "type": "object", "properties": { "ExitID": { "title": "String", "minLength": 1, "type": "string", "description": "出入口代碼", "xml": { "name": "ExitID" } }, "ExitName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "出入口名稱", "xml": { "name": "NameType" } }, "ExitPosition": { "title": "PointType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.PointType" } ], "description": "出入口座標", "xml": { "name": "PointType" } }, "Bearing": { "title": "String", "type": "string", "description": "出入口所在道路路段方位角", "nullable": true, "xml": { "name": "Bearing" } }, "RoadName": { "title": "String", "type": "string", "description": "出入口所在道路名稱", "nullable": true, "xml": { "name": "RoadName" } }, "LocationDescription": { "title": "String", "type": "string", "description": "地址描述", "nullable": true, "xml": { "name": "LocationDescription" } }, "Stair": { "title": "Boolean", "type": "boolean", "description": "是否有樓梯" }, "Escalator": { "title": "Int32", "type": "integer", "description": "是否有電扶梯 = ['0: 沒有', '1: 雙向皆有', '2: 出站有', '3: 入站有']", "format": "int32" }, "Elevator": { "title": "Boolean", "type": "boolean", "description": "是否有電梯" } }, "additionalProperties": false, "description": "車站出入口", "xml": { "name": "Exit" } }, "PTX.Service.DTO.Rail.Specification.V3.TRA.StationExit.ExitMapURL": { "title": "ExitMapURL", "required": [ "MapName" ], "type": "object", "properties": { "MapName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "車站出入口簡圖名稱", "xml": { "name": "NameType" } }, "MapURL": { "title": "String", "type": "string", "description": "車站出入口簡圖網址", "nullable": true, "xml": { "name": "MapURL" } }, "FloorLevel": { "title": "String", "type": "string", "description": "樓層", "nullable": true, "xml": { "name": "FloorLevel" } } }, "additionalProperties": false, "xml": { "name": "ExitMapURL" } }, "PTX.API.Rail.Model.TRABaseWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.StationFacility.StationFacility]": { "title": "TRAStationFacilityList", "required": [ "AuthorityCode", "Items", "SrcUpdateInterval", "SrcUpdateTime", "UpdateInterval", "UpdateTime" ], "type": "object", "properties": { "UpdateTime": { "type": "string", "description": "本平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "UpdateInterval": { "title": "Int32", "type": "integer", "description": "本平台資料更新週期(秒)", "format": "int32" }, "SrcUpdateTime": { "title": "DateTime", "type": "string", "description": "來源端平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "SrcUpdateInterval": { "title": "Int32", "type": "integer", "description": "來源端平台資料更新週期(秒)['-1: 不定期更新']", "format": "int32" }, "AuthorityCode": { "title": "String", "minLength": 1, "type": "string", "description": "業管機關簡碼", "xml": { "name": "AuthorityCode" } }, "Items": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.StationFacility.StationFacility" }, "description": "資料(陣列)", "xml": { "name": "List`1" } }, "Count": { "type": "integer", "description": "資料總筆數", "format": "int64", "nullable": true } }, "additionalProperties": false, "xml": { "name": "TRABaseWrapperOfStationFacility", "namespace": "https://ptx.transportdata.tw/standard/schema/" } }, "PTX.Service.DTO.Rail.Specification.V3.TRA.StationFacility.StationFacility": { "title": "StationFacility", "required": [ "DrinkingFountains", "Elevators", "FacilityMapURLs", "InformationSpots", "StationID", "StationName", "Toilets" ], "type": "object", "properties": { "StationID": { "title": "String", "minLength": 1, "type": "string", "description": "車站代碼", "xml": { "name": "StationID" } }, "StationName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "車站名稱", "xml": { "name": "NameType" } }, "FacilityMapURLs": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.StationFacility.FacilityMapURL" }, "description": "車站出入口", "xml": { "name": "FacilityMapURL" } }, "Elevators": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.StationFacility.FacilityInfo" }, "description": "無障礙電梯位置資訊", "xml": { "name": "List`1" } }, "InformationSpots": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.StationFacility.FacilityInfo" }, "description": "詢問處位置資訊", "xml": { "name": "List`1" } }, "DrinkingFountains": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.StationFacility.FacilityInfo" }, "description": "飲水機位置資訊", "xml": { "name": "List`1" } }, "Toilets": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.StationFacility.FacilityInfo" }, "description": "廁所位置資訊", "xml": { "name": "List`1" } } }, "additionalProperties": false, "description": "車站設施資訊", "xml": { "name": "StationFacility" } }, "PTX.Service.DTO.Rail.Specification.V3.TRA.StationFacility.FacilityMapURL": { "title": "FacilityMapURL", "required": [ "MapName", "MapURL" ], "type": "object", "properties": { "MapName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "車站設施簡圖名稱", "xml": { "name": "NameType" } }, "MapURL": { "title": "String", "minLength": 1, "type": "string", "description": "車站設施簡圖網址", "xml": { "name": "MapURL" } }, "FloorLevel": { "title": "String", "type": "string", "description": "樓層", "nullable": true, "xml": { "name": "FloorLevel" } } }, "additionalProperties": false, "description": "車站設施簡圖網址連結資訊", "xml": { "name": "FacilityMapURL" } }, "PTX.Service.DTO.Rail.Specification.V3.TRA.StationFacility.FacilityInfo": { "title": "FacilityInfo", "required": [ "Description" ], "type": "object", "properties": { "Description": { "title": "String", "minLength": 1, "type": "string", "description": "位置描述", "xml": { "name": "Description" } }, "FloorLevel": { "title": "String", "type": "string", "description": "樓層", "nullable": true, "xml": { "name": "FloorLevel" } } }, "additionalProperties": false, "xml": { "name": "FacilityInfo" } }, "PTX.API.Rail.Model.TRABaseWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.Line]": { "title": "TRALineList", "required": [ "AuthorityCode", "Items", "SrcUpdateInterval", "SrcUpdateTime", "UpdateInterval", "UpdateTime" ], "type": "object", "properties": { "UpdateTime": { "type": "string", "description": "本平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "UpdateInterval": { "title": "Int32", "type": "integer", "description": "本平台資料更新週期(秒)", "format": "int32" }, "SrcUpdateTime": { "title": "DateTime", "type": "string", "description": "來源端平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "SrcUpdateInterval": { "title": "Int32", "type": "integer", "description": "來源端平台資料更新週期(秒)['-1: 不定期更新']", "format": "int32" }, "AuthorityCode": { "title": "String", "minLength": 1, "type": "string", "description": "業管機關簡碼", "xml": { "name": "AuthorityCode" } }, "Items": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.Line" }, "description": "資料(陣列)", "xml": { "name": "List`1" } }, "Count": { "type": "integer", "description": "資料總筆數", "format": "int64", "nullable": true } }, "additionalProperties": false, "xml": { "name": "TRABaseWrapperOfLine", "namespace": "https://ptx.transportdata.tw/standard/schema/" } }, "PTX.Service.DTO.Rail.Specification.V3.TRA.Line": { "title": "Line", "required": [ "IsBranch", "LineID", "LineName", "LineNo", "LineSectionName" ], "type": "object", "properties": { "LineNo": { "title": "String", "minLength": 1, "type": "string", "description": "路線編號", "xml": { "name": "LineNo" } }, "LineID": { "title": "String", "minLength": 1, "type": "string", "description": "路線代碼", "xml": { "name": "LineID" } }, "LineName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "路線名稱", "xml": { "name": "NameType" } }, "LineSectionName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "路線區間名稱", "xml": { "name": "NameType" } }, "LineColor": { "title": "String", "type": "string", "description": "路線顏色", "nullable": true, "xml": { "name": "LineColor" } }, "IsBranch": { "title": "Boolean", "type": "boolean", "description": "是否位於支線" }, "LineGroup": { "title": "String", "type": "string", "description": "路線群組", "nullable": true, "xml": { "name": "LineGroup" } }, "LineURL": { "title": "String", "type": "string", "description": "路線群組", "nullable": true, "xml": { "name": "LineURL" } } }, "additionalProperties": false, "description": "路線基本資料", "xml": { "name": "Line" } }, "PTX.API.Rail.Model.TRABaseWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.StationOfLine.StationOfLine]": { "title": "TRAStationOfLineList", "required": [ "AuthorityCode", "Items", "SrcUpdateInterval", "SrcUpdateTime", "UpdateInterval", "UpdateTime" ], "type": "object", "properties": { "UpdateTime": { "type": "string", "description": "本平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "UpdateInterval": { "title": "Int32", "type": "integer", "description": "本平台資料更新週期(秒)", "format": "int32" }, "SrcUpdateTime": { "title": "DateTime", "type": "string", "description": "來源端平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "SrcUpdateInterval": { "title": "Int32", "type": "integer", "description": "來源端平台資料更新週期(秒)['-1: 不定期更新']", "format": "int32" }, "AuthorityCode": { "title": "String", "minLength": 1, "type": "string", "description": "業管機關簡碼", "xml": { "name": "AuthorityCode" } }, "Items": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.StationOfLine.StationOfLine" }, "description": "資料(陣列)", "xml": { "name": "List`1" } }, "Count": { "type": "integer", "description": "資料總筆數", "format": "int64", "nullable": true } }, "additionalProperties": false, "xml": { "name": "TRABaseWrapperOfStationOfLine", "namespace": "https://ptx.transportdata.tw/standard/schema/" } }, "PTX.Service.DTO.Rail.Specification.V3.TRA.StationOfLine.StationOfLine": { "title": "StationOfLine", "required": [ "LineID", "LineNo", "Stations" ], "type": "object", "properties": { "LineNo": { "title": "String", "minLength": 1, "type": "string", "description": "路線編號", "xml": { "name": "LineNo" } }, "LineID": { "title": "String", "minLength": 1, "type": "string", "description": "路線代碼", "xml": { "name": "LineID" } }, "Stations": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.StationOfLine.LineStation" }, "description": "路線車站資訊", "xml": { "name": "Station" } } }, "additionalProperties": false, "description": "路線車站基本資料", "xml": { "name": "StationOfLine" } }, "PTX.Service.DTO.Rail.Specification.V3.TRA.StationOfLine.LineStation": { "title": "LineStation", "required": [ "CumulativeDistance", "Sequence", "StationID", "StationName" ], "type": "object", "properties": { "Sequence": { "title": "Int32", "type": "integer", "description": "站序", "format": "int32" }, "StationID": { "title": "String", "minLength": 1, "type": "string", "description": "車站代碼", "xml": { "name": "StationID" } }, "StationName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "車站名稱", "xml": { "name": "NameType" } }, "CumulativeDistance": { "title": "Single", "type": "number", "description": "已累積之里程距離(公里)", "format": "float" } }, "additionalProperties": false, "description": "路線車站資訊", "xml": { "name": "LineStation" } }, "PTX.API.Rail.Model.TRABaseWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.TrainType]": { "title": "TRATrainTypeList", "required": [ "AuthorityCode", "Items", "SrcUpdateInterval", "SrcUpdateTime", "UpdateInterval", "UpdateTime" ], "type": "object", "properties": { "UpdateTime": { "type": "string", "description": "本平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "UpdateInterval": { "title": "Int32", "type": "integer", "description": "本平台資料更新週期(秒)", "format": "int32" }, "SrcUpdateTime": { "title": "DateTime", "type": "string", "description": "來源端平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "SrcUpdateInterval": { "title": "Int32", "type": "integer", "description": "來源端平台資料更新週期(秒)['-1: 不定期更新']", "format": "int32" }, "AuthorityCode": { "title": "String", "minLength": 1, "type": "string", "description": "業管機關簡碼", "xml": { "name": "AuthorityCode" } }, "Items": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.TrainType" }, "description": "資料(陣列)", "xml": { "name": "List`1" } }, "Count": { "type": "integer", "description": "資料總筆數", "format": "int64", "nullable": true } }, "additionalProperties": false, "xml": { "name": "TRABaseWrapperOfTrainType", "namespace": "https://ptx.transportdata.tw/standard/schema/" } }, "PTX.Service.DTO.Rail.Specification.V3.TRA.TrainType": { "title": "TrainType", "required": [ "TrainTypeCode", "TrainTypeID", "TrainTypeName" ], "type": "object", "properties": { "TrainTypeID": { "title": "String", "minLength": 1, "type": "string", "description": "列車車種代碼", "xml": { "name": "TrainTypeID" } }, "TrainTypeCode": { "title": "String", "minLength": 1, "type": "string", "description": "車種簡碼 = ['1: 太魯閣', '2: 普悠瑪', '3: 自強', '4: 莒光', '5: 復興', '6: 區間', '7: 普快', '10: 區間快']", "xml": { "name": "TrainTypeCode" } }, "TrainTypeName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "列車車種名稱", "xml": { "name": "NameType" } } }, "additionalProperties": false, "description": "列車車種資料", "xml": { "name": "TrainType" } }, "PTX.API.Rail.Model.TRAODFareWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.ODFare.ODFare]": { "title": "TRAODFareList", "required": [ "AuthorityCode", "ODFares", "SrcUpdateInterval", "SrcUpdateTime", "UpdateInterval", "UpdateTime" ], "type": "object", "properties": { "UpdateTime": { "type": "string", "description": "本平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "UpdateInterval": { "title": "Int32", "type": "integer", "description": "本平台資料更新週期(秒)", "format": "int32" }, "SrcUpdateTime": { "title": "DateTime", "type": "string", "description": "來源端平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "SrcUpdateInterval": { "title": "Int32", "type": "integer", "description": "來源端平台資料更新週期(秒)['-1: 不定期更新']", "format": "int32" }, "AuthorityCode": { "title": "String", "minLength": 1, "type": "string", "description": "業管機關簡碼", "xml": { "name": "AuthorityCode" } }, "EffectiveDate": { "title": "String", "type": "string", "description": "有效起始日期", "nullable": true, "xml": { "name": "EffectiveDate" } }, "ExpireDate": { "title": "String", "type": "string", "description": "有效終止日期", "nullable": true, "xml": { "name": "ExpireDate" } }, "SrcVersion": { "title": "String", "type": "string", "description": "資料版本", "nullable": true, "xml": { "name": "SrcVersion" } }, "ODFares": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.ODFare.ODFare" }, "description": "資料(陣列)", "xml": { "name": "List`1" } }, "Count": { "type": "integer", "description": "資料總筆數", "format": "int64", "nullable": true } }, "additionalProperties": false, "xml": { "name": "TRAODFareWrapperOfODFare", "namespace": "https://ptx.transportdata.tw/standard/schema/" } }, "PTX.Service.DTO.Rail.Specification.V3.TRA.ODFare.ODFare": { "title": "ODFare", "required": [ "DestinationStationID", "DestinationStationName", "Fares", "OriginStationID", "OriginStationName", "TrainType" ], "type": "object", "properties": { "OriginStationID": { "title": "String", "minLength": 1, "type": "string", "description": "起點車站代碼", "xml": { "name": "OriginStationID" } }, "OriginStationName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "起點車站名稱", "xml": { "name": "NameType" } }, "DestinationStationID": { "title": "String", "minLength": 1, "type": "string", "description": "迄點車站代碼", "xml": { "name": "DestinationStationID" } }, "DestinationStationName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "迄點車站名稱", "xml": { "name": "NameType" } }, "Direction": { "title": "Int32", "type": "integer", "description": "方向 : [0:'順行',1:'逆行']", "format": "int32", "nullable": true }, "TrainType": { "title": "Int32", "type": "integer", "description": "車種簡碼 = ['1: 太魯閣', '2: 普悠瑪', '3: 自強', '4: 莒光', '5: 復興', '6: 區間', '7: 普快', '10: 區間快']", "format": "int32" }, "Fares": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.ODFare.Fare" }, "description": "票價", "xml": { "name": "Fare" } }, "TravelDistance": { "type": "number", "description": "起迄站間乘車距離", "format": "float", "nullable": true } }, "additionalProperties": false, "xml": { "name": "ODFare" } }, "PTX.Service.DTO.Rail.Specification.V3.TRA.ODFare.Fare": { "title": "Fare", "required": [ "CabinClass", "FareClass", "Price", "TicketType" ], "type": "object", "properties": { "TicketType": { "title": "Int32", "type": "integer", "description": "票種類型 = ['1: 一般票', '2: 來回票', '3: 電子票證', '4: 回數票', '5: 定期票(30天期)', '6: 定期票(60天期)', '7: 早鳥票']", "format": "int32" }, "FareClass": { "title": "Int32", "type": "integer", "description": "費率等級 = ['1: 成人', '2: 學生', '3: 孩童', '4: 敬老', '5: 愛心', '6: 愛心孩童', '7: 愛心優待/愛心陪伴', '8: 團體', '9: 軍警']", "format": "int32" }, "CabinClass": { "title": "Int32", "type": "integer", "description": "艙等 = ['1: 標準座車廂', '2: 商務座車廂', '3: 自由座車廂']", "format": "int32" }, "Price": { "title": "Int32", "type": "integer", "description": "計費價格(新台幣)", "format": "int32" } }, "additionalProperties": false, "xml": { "name": "Fare" } }, "PTX.API.Rail.Model.TRAGeneralTrainWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.GeneralTrainTimetable]": { "title": "TRAGeneralTrainTimetableList", "required": [ "AuthorityCode", "EffectiveDate", "SrcUpdateInterval", "SrcUpdateTime", "TrainTimetables", "UpdateInterval", "UpdateTime" ], "type": "object", "properties": { "UpdateTime": { "type": "string", "description": "本平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "UpdateInterval": { "title": "Int32", "type": "integer", "description": "本平台資料更新週期(秒)", "format": "int32" }, "SrcUpdateTime": { "title": "DateTime", "type": "string", "description": "來源端平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "SrcUpdateInterval": { "title": "Int32", "type": "integer", "description": "來源端平台資料更新週期(秒)['-1: 不定期更新']", "format": "int32" }, "AuthorityCode": { "title": "String", "minLength": 1, "type": "string", "description": "業管機關簡碼", "xml": { "name": "AuthorityCode" } }, "EffectiveDate": { "title": "DateTime", "type": "string", "description": "有效起始日期", "format": "date-time" }, "ExpireDate": { "type": "string", "description": "有效終止日期", "format": "date-time", "nullable": true }, "SrcVersion": { "title": "String", "type": "string", "description": "來源版號", "nullable": true, "xml": { "name": "SrcVersion" } }, "TimetableName": { "title": "String", "type": "string", "description": "定期性站別時刻表名稱", "nullable": true, "xml": { "name": "TimetableName" } }, "ValidityDesciption": { "title": "String", "type": "string", "description": "時刻表適用情形說明", "nullable": true, "xml": { "name": "ValidityDesciption" } }, "TrainTimetables": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.GeneralTrainTimetable" }, "description": "資料(陣列)", "xml": { "name": "List`1" } }, "Count": { "type": "integer", "description": "資料總筆數", "format": "int64", "nullable": true } }, "additionalProperties": false, "xml": { "name": "TRAGeneralTrainWrapperOfGeneralTrainTimetable", "namespace": "https://ptx.transportdata.tw/standard/schema/" } }, "PTX.Service.DTO.Rail.Specification.V3.TRA.GeneralTrainTimetable": { "title": "GeneralTrainTimetable", "required": [ "ServiceDay", "StopTimes", "TrainInfo" ], "type": "object", "properties": { "TrainInfo": { "title": "TrainInfo", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.Common.TrainInfo" } ], "description": "定期車次資料", "xml": { "name": "TrainInfo" } }, "StopTimes": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.Common.StopTime" }, "description": "停靠時間資料", "xml": { "name": "StopTime" } }, "ServiceDay": { "title": "ServiceDay", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.Common.ServiceDay" } ], "description": "營運日型態", "xml": { "name": "ServiceDay" } } }, "additionalProperties": false, "description": "定期時刻表資料型別", "xml": { "name": "GeneralTrainTimetable" } }, "PTX.Service.DTO.Rail.Specification.V3.TRA.Common.StopTime": { "title": "StopTime", "required": [ "ArrivalTime", "DepartureTime", "StationID", "StationName", "StopSequence" ], "type": "object", "properties": { "StopSequence": { "title": "Int32", "type": "integer", "description": "停靠站序(由1開始)", "format": "int32" }, "StationID": { "title": "String", "minLength": 1, "type": "string", "description": "車站代碼", "xml": { "name": "StationID" } }, "StationName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.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": "StopTime" } }, "PTX.Service.DTO.Rail.Specification.V3.TRA.Common.TrainInfo": { "title": "TrainInfo", "required": [ "BikeFlag", "BreastFeedFlag", "CarFlag", "DailyFlag", "DiningFlag", "Direction", "ExtraTrainFlag", "PackageServiceFlag", "TrainNo", "WheelChairFlag" ], "type": "object", "properties": { "TrainNo": { "title": "String", "minLength": 1, "type": "string", "description": "車次代碼", "xml": { "name": "TrainNo" } }, "RouteID": { "title": "String", "type": "string", "description": "營運路線代碼", "nullable": true, "xml": { "name": "RouteID" } }, "Direction": { "title": "Int32", "type": "integer", "description": "行駛方向 : [0:'順行',1:'逆行']", "format": "int32" }, "TrainTypeID": { "title": "String", "type": "string", "description": "車種代嗎", "nullable": true, "xml": { "name": "TrainTypeID" } }, "TrainTypeCode": { "title": "String", "type": "string", "description": "車種簡碼 = ['1: 太魯閣', '2: 普悠瑪', '3: 自強', '4: 莒光', '5: 復興', '6: 區間', '7: 普快', '10: 區間快']", "nullable": true, "xml": { "name": "TrainTypeCode" } }, "TrainTypeName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "車種名稱", "nullable": true, "xml": { "name": "NameType" } }, "TripHeadSign": { "title": "String", "type": "string", "description": "車次之目的地方向描述", "nullable": true, "xml": { "name": "TripHeadSign" } }, "StartingStationID": { "title": "String", "type": "string", "description": "列車起點車站代號", "nullable": true, "xml": { "name": "StartingStationID" } }, "StartingStationName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "列車起點車站名稱", "nullable": true, "xml": { "name": "NameType" } }, "EndingStationID": { "title": "String", "type": "string", "description": "列車終點車站代號", "nullable": true, "xml": { "name": "EndingStationID" } }, "EndingStationName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "列車終點車站名稱", "nullable": true, "xml": { "name": "NameType" } }, "OverNightStationID": { "title": "String", "type": "string", "description": "跨夜車站代碼", "nullable": true, "xml": { "name": "OverNightStationID" } }, "TripLine": { "title": "Int32", "type": "integer", "description": "山海線類型 : [0:'不經山海線',1:'山線',2:'海線',3:'成追線']", "format": "int32", "nullable": true }, "WheelChairFlag": { "title": "Int32", "type": "integer", "description": "是否設身障旅客專用座位車 : [0:'否',1:'是']", "format": "int32" }, "PackageServiceFlag": { "title": "Int32", "type": "integer", "description": "是否提供行李服務 : [0:'否',1:'是']", "format": "int32" }, "DiningFlag": { "title": "Int32", "type": "integer", "description": "是否提供訂便當服務 : [0:'否',1:'是']", "format": "int32" }, "BreastFeedFlag": { "title": "Int32", "type": "integer", "description": "是否設有哺(集)乳室車廂 : [0:'否',1:'是']", "format": "int32" }, "BikeFlag": { "title": "Int32", "type": "integer", "description": "是否人車同行班次(置於攜車袋之自行車各級列車均可乘車) : [0:'否',1:'是']", "format": "int32" }, "CarFlag": { "title": "Int32", "type": "integer", "description": "是否提供小客車 : [0:'否',1:'是']", "format": "int32" }, "DailyFlag": { "title": "Int32", "type": "integer", "description": "是否為每日行駛 : [0:'否',1:'是']", "format": "int32" }, "ExtraTrainFlag": { "title": "Int32", "type": "integer", "description": "是否為加班車 : [0:'否',1:'是']", "format": "int32" }, "Note": { "title": "String", "type": "string", "description": "附註說明", "nullable": true, "xml": { "name": "Note" } } }, "additionalProperties": false, "description": "車次定期資料型別(時刻表用)", "xml": { "name": "TrainInfo" } }, "PTX.Service.DTO.Rail.Specification.V3.TRA.Common.ServiceDay": { "title": "ServiceDay", "required": [ "DayAfterHoliday", "DayBeforeHoliday", "Friday", "Monday", "NationalHolidays", "Saturday", "Sunday", "Thursday", "Tuesday", "TyphoonDay", "Wednesday" ], "type": "object", "properties": { "ServiceTag": { "title": "String", "type": "string", "description": "服務日標籤", "nullable": true, "xml": { "name": "ServiceTag" } }, "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" }, "Sunday": { "title": "Int32", "type": "integer", "description": "星期日是否營運 : [0:'否',1:'是']", "format": "int32" }, "NationalHolidays": { "title": "Int32", "type": "integer", "description": "國定假日是否營運 : [0:'否',1:'是']", "format": "int32" }, "DayBeforeHoliday": { "title": "Int32", "type": "integer", "description": "假日前一日是否營運 : [0:'否',1:'是']", "format": "int32" }, "DayAfterHoliday": { "title": "Int32", "type": "integer", "description": "假日後一日是否營運 : [0:'否',1:'是']", "format": "int32" }, "TyphoonDay": { "title": "Int32", "type": "integer", "description": "颱風停止上班上課期間營運營運 : [0:'否',1:'是']", "format": "int32" } }, "additionalProperties": false, "description": "服務日型態", "xml": { "name": "ServiceDay" } }, "PTX.API.Rail.Model.TRAGeneralStationWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.GeneralStationTimetable.GeneralStationTimetable]": { "title": "TRAGeneralStationTimetableList", "required": [ "AuthorityCode", "EffectiveDate", "SrcUpdateInterval", "SrcUpdateTime", "StationTimetables", "UpdateInterval", "UpdateTime" ], "type": "object", "properties": { "UpdateTime": { "type": "string", "description": "本平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "UpdateInterval": { "title": "Int32", "type": "integer", "description": "本平台資料更新週期(秒)", "format": "int32" }, "SrcUpdateTime": { "title": "DateTime", "type": "string", "description": "來源端平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "SrcUpdateInterval": { "title": "Int32", "type": "integer", "description": "來源端平台資料更新週期(秒)['-1: 不定期更新']", "format": "int32" }, "AuthorityCode": { "title": "String", "minLength": 1, "type": "string", "description": "業管機關簡碼", "xml": { "name": "AuthorityCode" } }, "EffectiveDate": { "title": "DateTime", "type": "string", "description": "有效起始日期", "format": "date-time" }, "ExpireDate": { "type": "string", "description": "有效終止日期", "format": "date-time", "nullable": true }, "SrcVersion": { "title": "String", "type": "string", "description": "來源版號", "nullable": true, "xml": { "name": "SrcVersion" } }, "TimetableName": { "title": "String", "type": "string", "description": "定期性站別時刻表名稱", "nullable": true, "xml": { "name": "TimetableName" } }, "ValidityDesciption": { "title": "String", "type": "string", "description": "時刻表適用情形說明", "nullable": true, "xml": { "name": "ValidityDesciption" } }, "StationTimetables": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.GeneralStationTimetable.GeneralStationTimetable" }, "description": "資料(陣列)", "xml": { "name": "List`1" } }, "Count": { "type": "integer", "description": "資料總筆數", "format": "int64", "nullable": true } }, "additionalProperties": false, "xml": { "name": "TRAGeneralStationWrapperOfGeneralStationTimetable", "namespace": "https://ptx.transportdata.tw/standard/schema/" } }, "PTX.Service.DTO.Rail.Specification.V3.TRA.GeneralStationTimetable.GeneralStationTimetable": { "title": "GeneralStationTimetable", "required": [ "Direction", "ServiceDay", "StationID", "Timetables" ], "type": "object", "properties": { "RouteID": { "title": "String", "type": "string", "description": "營運路線代碼", "nullable": true, "xml": { "name": "RouteID" } }, "StationID": { "title": "String", "minLength": 1, "type": "string", "description": "車站代碼", "xml": { "name": "StationID" } }, "StationName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "車站名稱", "nullable": true, "xml": { "name": "NameType" } }, "Direction": { "title": "Int32", "type": "integer", "description": "行駛方向 : [0:'順行',1:'逆行']", "format": "int32" }, "Timetables": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.GeneralStationTimetable.Timetable" }, "description": "車次停靠站資料", "xml": { "name": "Timetable" } }, "ServiceDay": { "title": "ServiceDay", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.GeneralStationTimetable.ServiceDay" } ], "description": "服務日型態", "xml": { "name": "ServiceDay" } } }, "additionalProperties": false, "description": "車站站別時刻表資料型別", "xml": { "name": "GeneralStationTimetable" } }, "PTX.Service.DTO.Rail.Specification.V3.TRA.GeneralStationTimetable.Timetable": { "title": "Timetable", "type": "object", "properties": { "Sequence": { "title": "Int32", "type": "integer", "description": "發車順序", "format": "int32" }, "TrainNo": { "title": "String", "type": "string", "description": "車次代碼", "nullable": true, "xml": { "name": "TrainNo" } }, "DestinationStationID": { "title": "String", "type": "string", "description": "目的站車站代號", "nullable": true, "xml": { "name": "DestinationStationID" } }, "DestinationStationName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "目的站車站", "nullable": true, "xml": { "name": "NameType" } }, "TrainTypeID": { "title": "String", "type": "string", "description": "車種代嗎", "nullable": true, "xml": { "name": "TrainTypeID" } }, "TrainTypeCode": { "title": "String", "type": "string", "description": "車種簡碼 = ['1: 太魯閣', '2: 普悠瑪', '3: 自強', '4: 莒光', '5: 復興', '6: 區間', '7: 普快', '10: 區間快']", "nullable": true, "xml": { "name": "TrainTypeCode" } }, "TrainTypeName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "車種名稱", "nullable": true, "xml": { "name": "NameType" } }, "ArrivalTime": { "title": "String", "type": "string", "description": "到站時刻", "nullable": true, "xml": { "name": "ArrivalTime" } }, "DepartureTime": { "title": "String", "type": "string", "description": "發車時刻", "nullable": true, "xml": { "name": "DepartureTime" } } }, "additionalProperties": false, "description": "車次停靠站資料", "xml": { "name": "Timetable" } }, "PTX.Service.DTO.Rail.Specification.V3.TRA.GeneralStationTimetable.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" } }, "Monday": { "title": "Boolean", "type": "boolean", "description": "星期一營運與否" }, "Tuesday": { "title": "Boolean", "type": "boolean", "description": "星期二營運與否" }, "Wednesday": { "title": "Boolean", "type": "boolean", "description": "星期三營運與否" }, "Thursday": { "title": "Boolean", "type": "boolean", "description": "星期四營運與否" }, "Friday": { "title": "Boolean", "type": "boolean", "description": "星期五營運與否" }, "Saturday": { "title": "Boolean", "type": "boolean", "description": "星期六營運與否" }, "Sunday": { "title": "Boolean", "type": "boolean", "description": "星期日營運與否" }, "NationalHolidays": { "type": "boolean", "description": "國定假日營運與否", "nullable": true }, "DayBeforeHoliday": { "type": "boolean", "description": "假日前一日營運與否", "nullable": true }, "DayAfterHoliday": { "type": "boolean", "description": "假日後一日營運與否", "nullable": true }, "TyphoonDay": { "type": "boolean", "description": "颱風停止上班上課期間營運與否", "nullable": true } }, "additionalProperties": false, "description": "服務日型態", "xml": { "name": "ServiceDay" } }, "PTX.API.Rail.Model.TRASpecificWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.SpecificTrainTimetable]": { "title": "TRASpecificTrainTimetableList", "required": [ "AuthorityCode", "EffectiveDate", "SrcUpdateInterval", "SrcUpdateTime", "TrainTimetables", "UpdateInterval", "UpdateTime" ], "type": "object", "properties": { "UpdateTime": { "type": "string", "description": "本平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "UpdateInterval": { "title": "Int32", "type": "integer", "description": "本平台資料更新週期(秒)", "format": "int32" }, "SrcUpdateTime": { "title": "DateTime", "type": "string", "description": "來源端平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "SrcUpdateInterval": { "title": "Int32", "type": "integer", "description": "來源端平台資料更新週期(秒)['-1: 不定期更新']", "format": "int32" }, "AuthorityCode": { "title": "String", "minLength": 1, "type": "string", "description": "業管機關簡碼", "xml": { "name": "AuthorityCode" } }, "EffectiveDate": { "title": "DateTime", "type": "string", "description": "有效起始日期", "format": "date-time" }, "ExpireDate": { "type": "string", "description": "有效終止日期", "format": "date-time", "nullable": true }, "SrcVersion": { "title": "String", "type": "string", "description": "來源版號", "nullable": true, "xml": { "name": "SrcVersion" } }, "TimetableName": { "title": "String", "type": "string", "description": "定期性站別時刻表名稱", "nullable": true, "xml": { "name": "TimetableName" } }, "ValidityDesciption": { "title": "String", "type": "string", "description": "時刻表適用情形說明", "nullable": true, "xml": { "name": "ValidityDesciption" } }, "TrainTimetables": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.SpecificTrainTimetable" }, "description": "資料(陣列)", "xml": { "name": "List`1" } }, "Count": { "type": "integer", "description": "資料總筆數", "format": "int64", "nullable": true } }, "additionalProperties": false, "xml": { "name": "TRASpecificWrapperOfSpecificTrainTimetable", "namespace": "https://ptx.transportdata.tw/standard/schema/" } }, "PTX.Service.DTO.Rail.Specification.V3.TRA.SpecificTrainTimetable": { "title": "SpecificTrainTimetable", "required": [ "SpecialDay", "StopTimes", "TrainInfo" ], "type": "object", "properties": { "TrainInfo": { "title": "TrainInfo", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.Common.TrainInfo" } ], "description": "定期車次資料", "xml": { "name": "TrainInfo" } }, "StopTimes": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.Common.StopTime" }, "description": "停靠時間資料", "xml": { "name": "StopTime" } }, "SpecialDay": { "title": "SpecialDay", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.Common.SpecialDay" } ], "description": "營運日型態", "xml": { "name": "SpecialDay" } } }, "additionalProperties": false, "description": "特殊車次時刻表資料型別", "xml": { "name": "SpecificTrainTimetable" } }, "PTX.Service.DTO.Rail.Specification.V3.TRA.Common.SpecialDay": { "title": "SpecialDay", "type": "object", "properties": { "Dates": { "title": "String", "type": "string", "description": "不連續特殊日期", "nullable": true, "xml": { "name": "Dates" } }, "StartDate": { "type": "string", "description": "開始日期", "format": "date-time", "nullable": true }, "EndDate": { "type": "string", "description": "結束日期", "format": "date-time", "nullable": true }, "ServiceStatus": { "title": "Int32", "type": "integer", "description": "營運服務狀態代碼 : [0:'停止營運',1:'正常營運',2:'加班營運']", "format": "int32", "nullable": true }, "Description": { "title": "String", "type": "string", "description": "特殊營運描述", "nullable": true, "xml": { "name": "Description" } } }, "additionalProperties": false, "description": "特定日期", "xml": { "name": "SpecialDay" } }, "PTX.API.Rail.Model.TraDailyTrainWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.DailyTrainTimeTable.TrainTimetable]": { "title": "TRADailyTrainTimeTableList", "required": [ "AuthorityCode", "SrcUpdateInterval", "SrcUpdateTime", "TrainDate", "UpdateInterval", "UpdateTime" ], "type": "object", "properties": { "UpdateTime": { "type": "string", "description": "本平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "UpdateInterval": { "title": "Int32", "type": "integer", "description": "本平台資料更新週期(秒)", "format": "int32" }, "SrcUpdateTime": { "title": "DateTime", "type": "string", "description": "來源端平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "SrcUpdateInterval": { "title": "Int32", "type": "integer", "description": "來源端平台資料更新週期(秒)['-1: 不定期更新']", "format": "int32" }, "AuthorityCode": { "title": "String", "minLength": 1, "type": "string", "description": "業管機關簡碼", "xml": { "name": "AuthorityCode" } }, "TrainDate": { "title": "String", "minLength": 1, "type": "string", "description": "營運日說明(yyyy-MM-dd)", "xml": { "name": "TrainDate" } }, "TrainTimetables": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.DailyTrainTimeTable.TrainTimetable" }, "description": "資料(陣列)", "nullable": true, "xml": { "name": "List`1" } }, "Count": { "type": "integer", "description": "資料總筆數", "format": "int64", "nullable": true } }, "additionalProperties": false, "xml": { "name": "TraDailyTrainWrapperOfTrainTimetable", "namespace": "https://ptx.transportdata.tw/standard/schema/" } }, "PTX.Service.DTO.Rail.Specification.V3.TRA.DailyTrainTimeTable.TrainTimetable": { "title": "TrainTimetable", "required": [ "StopTimes", "TrainInfo" ], "type": "object", "properties": { "TrainInfo": { "title": "TrainInfo", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.DailyTrainTimeTable.TrainInfo" } ], "description": "車次資料", "xml": { "name": "TrainInfo" } }, "StopTimes": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.DailyTrainTimeTable.StopTime" }, "description": "停靠站資料", "xml": { "name": "StopTime" } } }, "additionalProperties": false, "xml": { "name": "TrainTimetable" } }, "PTX.Service.DTO.Rail.Specification.V3.TRA.DailyTrainTimeTable.StopTime": { "title": "StopTime", "required": [ "StationID", "StationName", "StopSequence", "SuspendedFlag" ], "type": "object", "properties": { "StopSequence": { "title": "Int32", "type": "integer", "description": "停靠站序", "format": "int32" }, "StationID": { "title": "String", "minLength": 1, "type": "string", "description": "車站代碼", "xml": { "name": "StationID" } }, "StationName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "車站名稱", "xml": { "name": "NameType" } }, "ArrivalTime": { "title": "String", "type": "string", "description": "到站時間", "nullable": true, "xml": { "name": "ArrivalTime" } }, "DepartureTime": { "title": "String", "type": "string", "description": "離站時間", "nullable": true, "xml": { "name": "DepartureTime" } }, "SuspendedFlag": { "title": "Int32", "type": "integer", "description": "本站是否停駛 : [0:'否',1:'是']", "format": "int32" } }, "additionalProperties": false, "xml": { "name": "StopTime" } }, "PTX.Service.DTO.Rail.Specification.V3.TRA.DailyTrainTimeTable.TrainInfo": { "title": "TrainInfo", "required": [ "BikeFlag", "BreastFeedFlag", "DailyFlag", "DiningFlag", "Direction", "EndingStationName", "ExtraTrainFlag", "PackageServiceFlag", "RouteID", "StartingStationName", "SuspendedFlag", "TrainNo", "TrainTypeName", "WheelChairFlag" ], "type": "object", "properties": { "TrainNo": { "title": "String", "minLength": 1, "type": "string", "description": "車次代碼", "xml": { "name": "TrainNo" } }, "RouteID": { "title": "String", "minLength": 1, "type": "string", "description": "營運路線代碼", "xml": { "name": "RouteID" } }, "Direction": { "title": "Int32", "type": "integer", "description": "行駛方向 : [0:'順行',1:'逆行']", "format": "int32" }, "TrainTypeID": { "title": "String", "type": "string", "description": "車種代嗎", "nullable": true, "xml": { "name": "TrainTypeID" } }, "TrainTypeCode": { "title": "String", "type": "string", "description": "車種簡碼 = ['1: 太魯閣', '2: 普悠瑪', '3: 自強', '4: 莒光', '5: 復興', '6: 區間', '7: 普快', '10: 區間快']", "nullable": true, "xml": { "name": "TrainTypeCode" } }, "TrainTypeName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "車種名稱", "xml": { "name": "NameType" } }, "TripHeadSign": { "title": "String", "type": "string", "description": "車次之目的地方向描述", "nullable": true, "xml": { "name": "TripHeadSign" } }, "StartingStationID": { "title": "String", "type": "string", "description": "車次之起始站車站代號", "nullable": true, "xml": { "name": "StartingStationID" } }, "StartingStationName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "車次之起始站車站名稱", "xml": { "name": "NameType" } }, "EndingStationID": { "title": "String", "type": "string", "description": "車次之終點站車站代號", "nullable": true, "xml": { "name": "EndingStationID" } }, "EndingStationName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "車次之終點站車站名稱", "xml": { "name": "NameType" } }, "OverNightStationID": { "title": "String", "type": "string", "description": "跨夜車站代碼", "nullable": true, "xml": { "name": "OverNightStationID" } }, "TripLine": { "title": "Int32", "type": "integer", "description": "山海線類型 : [0:'不經山海線',1:'山線',2:'海線',3:'成追線']", "format": "int32", "nullable": true }, "WheelChairFlag": { "title": "Int32", "type": "integer", "description": "是否設身障旅客專用座位車 : [0:'否',1:'是']", "format": "int32" }, "PackageServiceFlag": { "title": "Int32", "type": "integer", "description": "是否提供行李服務 : [0:'否',1:'是']", "format": "int32" }, "DiningFlag": { "title": "Int32", "type": "integer", "description": "是否提供訂便當服務 : [0:'否',1:'是']", "format": "int32" }, "DiningFlagSections": { "title": "DiningFlagSection[]", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.DailyTrainTimeTable.DiningFlagSection" }, "description": "提供訂便當服務之車站區間", "nullable": true, "xml": { "name": "DiningFlagSection[]" } }, "BreastFeedFlag": { "title": "Int32", "type": "integer", "description": "是否設有哺(集)乳室車廂 : [0:'否',1:'是']", "format": "int32" }, "BikeFlag": { "title": "Int32", "type": "integer", "description": "是否人車同行班次(置於攜車袋之自行車各級列車均可乘車) : [0:'否',1:'是']", "format": "int32" }, "CarFlag": { "title": "Int32", "type": "integer", "description": "是否提供小汽車上火車服務 : [0:'否',1:'是']", "format": "int32", "nullable": true }, "DailyFlag": { "title": "Int32", "type": "integer", "description": "是否每日行駛 : [0:'否',1:'是']", "format": "int32" }, "ExtraTrainFlag": { "title": "Int32", "type": "integer", "description": "是否為加班車 : [0:'否',1:'是']", "format": "int32" }, "SuspendedFlag": { "title": "Int32", "type": "integer", "description": "列車是否停駛 : [0:'正常行駛',1:'停駛',2:'部份停駛']", "format": "int32" }, "ServiceType": { "title": "Int32", "type": "integer", "description": "列車服務類型 : [1:'定期',2:'加開',3:'郵輪',4:'專列']", "format": "int32", "nullable": true }, "Note": { "title": "String", "type": "string", "description": "附註說明", "nullable": true, "xml": { "name": "Note" } } }, "additionalProperties": false, "xml": { "name": "TrainInfo" } }, "PTX.Service.DTO.Rail.Specification.V3.TRA.DailyTrainTimeTable.DiningFlagSection": { "title": "DiningFlagSection", "required": [ "EndSection", "StartSection" ], "type": "object", "properties": { "StartSection": { "title": "SectionAmong", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.DailyTrainTimeTable.SectionAmong" } ], "description": "乘客出發站所屬區間", "xml": { "name": "SectionAmong" } }, "EndSection": { "title": "SectionAmong", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.DailyTrainTimeTable.SectionAmong" } ], "description": "乘客目的站所屬區間", "xml": { "name": "SectionAmong" } } }, "additionalProperties": false, "xml": { "name": "DiningFlagSection" } }, "PTX.Service.DTO.Rail.Specification.V3.TRA.DailyTrainTimeTable.SectionAmong": { "title": "SectionAmong", "required": [ "EndStationID", "StartStationID" ], "type": "object", "properties": { "StartStationID": { "title": "String", "minLength": 1, "type": "string", "description": "起站車站代碼", "xml": { "name": "StartStationID" } }, "EndStationID": { "title": "String", "minLength": 1, "type": "string", "description": "迄站車站代碼", "xml": { "name": "EndStationID" } } }, "additionalProperties": false, "xml": { "name": "SectionAmong" } }, "PTX.API.Rail.Model.TrainDateList": { "title": "TrainDateList", "required": [ "AuthorityCode", "Count", "EndDate", "StartDate", "TrainDates", "UpdateInterval", "UpdateTime" ], "type": "object", "properties": { "UpdateTime": { "title": "DateTime", "type": "string", "description": "[平臺]資料更新日期時間(ISO8601格式: yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "UpdateInterval": { "title": "Int32", "type": "integer", "description": "[平臺]資料更新週期(秒)", "format": "int32" }, "AuthorityCode": { "title": "String", "minLength": 1, "type": "string", "description": "業管機關簡碼", "xml": { "name": "AuthorityCode" } }, "StartDate": { "title": "String", "minLength": 1, "type": "string", "description": "每日時刻表供應起始日期(格式: yyyy-MM-dd)", "xml": { "name": "StartDate" } }, "EndDate": { "title": "String", "minLength": 1, "type": "string", "description": "每日時刻表供應最終日期(格式: yyyy-MM-dd)", "xml": { "name": "EndDate" } }, "TrainDates": { "title": "Array", "type": "array", "items": { "title": "String", "type": "string", "xml": { } }, "description": "每日時刻表供應日期清單資料", "xml": { "name": "List`1" } }, "Count": { "title": "Int64", "type": "integer", "description": "資料總筆數", "format": "int64" } }, "additionalProperties": false, "xml": { "name": "TrainDateList" } }, "PTX.API.Rail.Model.TraDailyStationWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.DailyStationTimeTable.StationTimetable]": { "title": "TRADailyStationTimeTableList", "required": [ "AuthorityCode", "SrcUpdateInterval", "SrcUpdateTime", "StationTimetables", "TrainDate", "UpdateInterval", "UpdateTime" ], "type": "object", "properties": { "UpdateTime": { "type": "string", "description": "本平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "UpdateInterval": { "title": "Int32", "type": "integer", "description": "本平台資料更新週期(秒)", "format": "int32" }, "SrcUpdateTime": { "title": "DateTime", "type": "string", "description": "來源端平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "SrcUpdateInterval": { "title": "Int32", "type": "integer", "description": "來源端平台資料更新週期(秒)['-1: 不定期更新']", "format": "int32" }, "AuthorityCode": { "title": "String", "minLength": 1, "type": "string", "description": "業管機關簡碼", "xml": { "name": "AuthorityCode" } }, "TrainDate": { "title": "String", "minLength": 1, "type": "string", "description": "營運日說明(yyyy-MM-dd)", "xml": { "name": "TrainDate" } }, "StationTimetables": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.DailyStationTimeTable.StationTimetable" }, "description": "資料(陣列)", "xml": { "name": "List`1" } }, "Count": { "type": "integer", "description": "資料總筆數", "format": "int64", "nullable": true } }, "additionalProperties": false, "xml": { "name": "TraDailyStationWrapperOfStationTimetable", "namespace": "https://ptx.transportdata.tw/standard/schema/" } }, "PTX.Service.DTO.Rail.Specification.V3.TRA.DailyStationTimeTable.StationTimetable": { "title": "StationTimetable", "required": [ "TimeTables" ], "type": "object", "properties": { "RouteID": { "title": "String", "type": "string", "description": "營運路線代碼", "nullable": true, "xml": { "name": "RouteID" } }, "StationID": { "title": "String", "type": "string", "description": "車站代碼", "nullable": true, "xml": { "name": "StationID" } }, "StationName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "車站名稱", "nullable": true, "xml": { "name": "NameType" } }, "Direction": { "title": "Int32", "type": "integer", "description": "行駛方向 : [0:'順行',1:'逆行']", "format": "int32", "nullable": true }, "TimeTables": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.DailyStationTimeTable.TimeTable" }, "description": "目的站車站名稱", "xml": { "name": "List`1" } } }, "additionalProperties": false, "xml": { "name": "StationTimetable" } }, "PTX.Service.DTO.Rail.Specification.V3.TRA.DailyStationTimeTable.TimeTable": { "title": "TimeTable", "required": [ "Sequence", "SuspendedFlag" ], "type": "object", "properties": { "Sequence": { "title": "Int32", "type": "integer", "description": "發車順序", "format": "int32" }, "TrainNo": { "title": "String", "type": "string", "description": "車次代碼", "nullable": true, "xml": { "name": "TrainNo" } }, "DestinationStationID": { "title": "String", "type": "string", "description": "目的站車站代號", "nullable": true, "xml": { "name": "DestinationStationID" } }, "DestinationStationName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "目的站車站名稱", "nullable": true, "xml": { "name": "NameType" } }, "TrainTypeID": { "title": "String", "type": "string", "description": "車種代嗎", "nullable": true, "xml": { "name": "TrainTypeID" } }, "TrainTypeCode": { "title": "String", "type": "string", "description": "車種簡碼 = ['1: 太魯閣', '2: 普悠瑪', '3: 自強', '4: 莒光', '5: 復興', '6: 區間', '7: 普快', '10: 區間快']", "nullable": true, "xml": { "name": "TrainTypeCode" } }, "TrainTypeName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "車種名稱", "nullable": true, "xml": { "name": "NameType" } }, "ArrivalTime": { "title": "String", "type": "string", "description": "到站時刻", "nullable": true, "xml": { "name": "ArrivalTime" } }, "DepartureTime": { "title": "String", "type": "string", "description": "發車時刻", "nullable": true, "xml": { "name": "DepartureTime" } }, "SuspendedFlag": { "title": "Int32", "type": "integer", "description": "列車於本站停駛 : [0:'否',1:'是']", "format": "int32" }, "ServiceType": { "title": "Int32", "type": "integer", "description": "列車服務類型 : [1:'定期',2:'加開',3:'郵輪',4:'專列']", "format": "int32", "nullable": true } }, "additionalProperties": false, "xml": { "name": "TimeTable" } }, "PTX.API.Rail.Model.TRARealTimeWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.TRAStationLiveBoardList.StationLiveBoard]": { "title": "TRAStationLiveBoardList", "required": [ "AuthorityCode", "Items", "SrcUpdateInterval", "SrcUpdateTime", "UpdateInterval", "UpdateTime" ], "type": "object", "properties": { "UpdateTime": { "type": "string", "description": "本平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "UpdateInterval": { "title": "Int32", "type": "integer", "description": "本平台資料更新週期(秒)", "format": "int32" }, "SrcUpdateTime": { "title": "DateTime", "type": "string", "description": "來源端平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "SrcUpdateInterval": { "title": "Int32", "type": "integer", "description": "來源端平台資料更新週期(秒)['-1: 不定期更新']", "format": "int32" }, "AuthorityCode": { "title": "String", "minLength": 1, "type": "string", "description": "業管機關簡碼", "xml": { "name": "AuthorityCode" } }, "Items": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.TRAStationLiveBoardList.StationLiveBoard" }, "description": "資料(陣列)", "xml": { "name": "List`1" } }, "Count": { "type": "integer", "description": "資料總筆數", "format": "int64", "nullable": true } }, "additionalProperties": false, "xml": { "name": "TRARealTimeWrapperOfStationLiveBoard", "namespace": "https://ptx.transportdata.tw/standard/schema/" } }, "PTX.Service.DTO.Rail.Specification.V3.TRA.TRAStationLiveBoardList.StationLiveBoard": { "title": "StationLiveBoard", "required": [ "DelayTime", "EndingStationName", "StationID", "StationName", "TrainNo", "TrainTypeName", "UpdateTime" ], "type": "object", "properties": { "StationID": { "title": "String", "minLength": 1, "type": "string", "description": "車站代號", "xml": { "name": "StationID" } }, "StationName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "車站名稱", "xml": { "name": "NameType" } }, "TrainNo": { "title": "String", "minLength": 1, "type": "string", "description": "車次代碼", "xml": { "name": "TrainNo" } }, "Direction": { "title": "Int32", "type": "integer", "description": "行駛方向 : [0:'順行',1:'逆行']", "format": "int32", "nullable": true }, "TrainTypeID": { "title": "String", "type": "string", "description": "車種代嗎", "nullable": true, "xml": { "name": "TrainTypeID" } }, "TrainTypeCode": { "title": "String", "type": "string", "description": "車種簡碼 = ['1: 太魯閣', '2: 普悠瑪', '3: 自強', '4: 莒光', '5: 復興', '6: 區間', '7: 普快', '10: 區間快']", "nullable": true, "xml": { "name": "TrainTypeCode" } }, "TrainTypeName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "車種名稱", "xml": { "name": "NameType" } }, "EndingStationID": { "title": "String", "type": "string", "description": "終點站代碼", "nullable": true, "xml": { "name": "EndingStationID" } }, "EndingStationName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "終點站名稱", "xml": { "name": "NameType" } }, "TripLine": { "title": "Int32", "type": "integer", "description": "山海線類型 : [0:'不經山海線',1:'山線',2:'海線',3:'成追線']", "format": "int32", "nullable": true }, "Platform": { "title": "String", "type": "string", "description": "停靠月台(00代表當時尚未確定停靠的月台,待確定好停靠的月台後,就會更新Platfrom。)", "nullable": true, "xml": { "name": "Platform" } }, "ScheduleArrivalTime": { "title": "String", "type": "string", "description": "表訂到站時刻", "nullable": true, "xml": { "name": "ScheduleArrivalTime" } }, "ScheduleDepartureTime": { "title": "String", "type": "string", "description": "表定離站時刻", "nullable": true, "xml": { "name": "ScheduleDepartureTime" } }, "DelayTime": { "title": "Int32", "type": "integer", "description": "延誤分鐘", "format": "int32" }, "RunningStatus": { "title": "Int32", "type": "integer", "description": "列車狀態 : [0:'準點',1:'誤點',2:'取消']", "format": "int32", "nullable": true }, "UpdateTime": { "title": "DateTime", "type": "string", "description": "本筆資料之更新日期時間", "format": "date-time" } }, "additionalProperties": false, "xml": { "name": "StationLiveBoard" } }, "PTX.API.Rail.Model.TRARealTimeWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.TRATrainLiveBoardList.TrainLiveBoard]": { "title": "TRATrainLiveBoardList", "required": [ "AuthorityCode", "Items", "SrcUpdateInterval", "SrcUpdateTime", "UpdateInterval", "UpdateTime" ], "type": "object", "properties": { "UpdateTime": { "type": "string", "description": "本平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "UpdateInterval": { "title": "Int32", "type": "integer", "description": "本平台資料更新週期(秒)", "format": "int32" }, "SrcUpdateTime": { "title": "DateTime", "type": "string", "description": "來源端平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "SrcUpdateInterval": { "title": "Int32", "type": "integer", "description": "來源端平台資料更新週期(秒)['-1: 不定期更新']", "format": "int32" }, "AuthorityCode": { "title": "String", "minLength": 1, "type": "string", "description": "業管機關簡碼", "xml": { "name": "AuthorityCode" } }, "Items": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.TRATrainLiveBoardList.TrainLiveBoard" }, "description": "資料(陣列)", "xml": { "name": "List`1" } }, "Count": { "type": "integer", "description": "資料總筆數", "format": "int64", "nullable": true } }, "additionalProperties": false, "xml": { "name": "TRARealTimeWrapperOfTrainLiveBoard", "namespace": "https://ptx.transportdata.tw/standard/schema/" } }, "PTX.Service.DTO.Rail.Specification.V3.TRA.TRATrainLiveBoardList.TrainLiveBoard": { "title": "TrainLiveBoard", "required": [ "DelayTime", "StationName", "TrainTypeName", "UpdateTime" ], "type": "object", "properties": { "TrainNo": { "title": "String", "type": "string", "description": "車次代碼", "nullable": true, "xml": { "name": "TrainNo" } }, "TrainTypeID": { "title": "String", "type": "string", "description": "車種代嗎", "nullable": true, "xml": { "name": "TrainTypeID" } }, "TrainTypeCode": { "title": "String", "type": "string", "description": "車種簡碼 = ['1: 太魯閣', '2: 普悠瑪', '3: 自強', '4: 莒光', '5: 復興', '6: 區間', '7: 普快', '10: 區間快']", "nullable": true, "xml": { "name": "TrainTypeCode" } }, "TrainTypeName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "車種名稱", "xml": { "name": "NameType" } }, "StationID": { "title": "String", "type": "string", "description": "車站代號", "nullable": true, "xml": { "name": "StationID" } }, "StationName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "車站名稱", "xml": { "name": "NameType" } }, "TrainStationStatus": { "title": "Int32", "type": "integer", "description": "列車目前所在之車站狀態 : [0:'進站中',1:'在站上',2:'已離站']", "format": "int32", "nullable": true }, "DelayTime": { "title": "Int32", "type": "integer", "description": "延誤分鐘", "format": "int32" }, "UpdateTime": { "title": "DateTime", "type": "string", "description": "本筆位置資料之更新日期時間", "format": "date-time" } }, "additionalProperties": false, "xml": { "name": "TrainLiveBoard" } }, "PTX.API.Rail.Model.TRABaseWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.LineTransfer]": { "title": "TRALineTransferList", "required": [ "AuthorityCode", "Items", "SrcUpdateInterval", "SrcUpdateTime", "UpdateInterval", "UpdateTime" ], "type": "object", "properties": { "UpdateTime": { "type": "string", "description": "本平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "UpdateInterval": { "title": "Int32", "type": "integer", "description": "本平台資料更新週期(秒)", "format": "int32" }, "SrcUpdateTime": { "title": "DateTime", "type": "string", "description": "來源端平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "SrcUpdateInterval": { "title": "Int32", "type": "integer", "description": "來源端平台資料更新週期(秒)['-1: 不定期更新']", "format": "int32" }, "AuthorityCode": { "title": "String", "minLength": 1, "type": "string", "description": "業管機關簡碼", "xml": { "name": "AuthorityCode" } }, "Items": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.LineTransfer" }, "description": "資料(陣列)", "xml": { "name": "List`1" } }, "Count": { "type": "integer", "description": "資料總筆數", "format": "int64", "nullable": true } }, "additionalProperties": false, "xml": { "name": "TRABaseWrapperOfLineTransfer", "namespace": "https://ptx.transportdata.tw/standard/schema/" } }, "PTX.Service.DTO.Rail.Specification.V3.TRA.LineTransfer": { "title": "LineTransfer", "required": [ "FromLineID", "FromLineName", "FromStationID", "FromStationName", "MinTransferTime", "ToLineID", "ToLineName", "ToStationID", "ToStationName", "TransferDescription" ], "type": "object", "properties": { "FromLineID": { "title": "String", "minLength": 1, "type": "string", "description": "路線間轉乘(起)之路線代碼", "xml": { "name": "FromLineID" } }, "FromLineName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "路線間轉乘(起)之路線名稱", "xml": { "name": "NameType" } }, "FromStationID": { "title": "String", "minLength": 1, "type": "string", "description": "路線間轉乘(起)之車站代碼", "xml": { "name": "FromStationID" } }, "FromStationName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "路線間轉乘(起)之車站名稱", "xml": { "name": "NameType" } }, "ToLineID": { "title": "String", "minLength": 1, "type": "string", "description": "路線間轉乘(迄)之路線代碼", "xml": { "name": "ToLineID" } }, "ToLineName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "路線間轉乘(迄)之路線名稱", "xml": { "name": "NameType" } }, "ToStationID": { "title": "String", "minLength": 1, "type": "string", "description": "路線間轉乘(迄)之車站代碼", "xml": { "name": "ToStationID" } }, "ToStationName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "路線間轉乘(迄)之車站名稱", "xml": { "name": "NameType" } }, "MinTransferTime": { "title": "Double", "type": "number", "description": "轉乘耗時參考時間(分)", "format": "double" }, "TransferDescription": { "title": "String", "minLength": 1, "type": "string", "description": "轉乘方式文字描述", "xml": { "name": "TransferDescription" } } }, "additionalProperties": false, "description": "路線站間轉乘基本資料", "xml": { "name": "LineTransfer" } }, "PTX.API.Rail.Model.TRABaseWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.StationTransfer.StationTransfer]": { "title": "TRAStationTransferList", "required": [ "AuthorityCode", "Items", "SrcUpdateInterval", "SrcUpdateTime", "UpdateInterval", "UpdateTime" ], "type": "object", "properties": { "UpdateTime": { "type": "string", "description": "本平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "UpdateInterval": { "title": "Int32", "type": "integer", "description": "本平台資料更新週期(秒)", "format": "int32" }, "SrcUpdateTime": { "title": "DateTime", "type": "string", "description": "來源端平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "SrcUpdateInterval": { "title": "Int32", "type": "integer", "description": "來源端平台資料更新週期(秒)['-1: 不定期更新']", "format": "int32" }, "AuthorityCode": { "title": "String", "minLength": 1, "type": "string", "description": "業管機關簡碼", "xml": { "name": "AuthorityCode" } }, "Items": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.StationTransfer.StationTransfer" }, "description": "資料(陣列)", "xml": { "name": "List`1" } }, "Count": { "type": "integer", "description": "資料總筆數", "format": "int64", "nullable": true } }, "additionalProperties": false, "xml": { "name": "TRABaseWrapperOfStationTransfer", "namespace": "https://ptx.transportdata.tw/standard/schema/" } }, "PTX.Service.DTO.Rail.Specification.V3.TRA.StationTransfer.StationTransfer": { "title": "StationTransfer", "required": [ "ExteriorMapURLs", "InteriorMapURLs", "StationID", "StationName", "Transfers" ], "type": "object", "properties": { "StationID": { "title": "String", "minLength": 1, "type": "string", "description": "車站代碼", "xml": { "name": "StationID" } }, "StationName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "車站名稱", "xml": { "name": "NameType" } }, "TransferDescription": { "title": "String", "type": "string", "description": "轉乘文字描述", "nullable": true, "xml": { "name": "TransferDescription" } }, "InteriorMapURLs": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.StationTransfer.MapURL" }, "description": "車站內部地圖簡圖連結資訊", "xml": { "name": "List`1" } }, "ExteriorMapURLs": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.StationTransfer.MapURL" }, "description": "外部轉乘地圖簡圖連結資訊", "xml": { "name": "List`1" } }, "Transfers": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.StationTransfer.Transfer" }, "description": "跨運具轉乘資訊", "xml": { "name": "Transfer" } } }, "additionalProperties": false, "description": "車站跨運具轉乘資訊", "xml": { "name": "StationTransfer" } }, "PTX.Service.DTO.Rail.Specification.V3.TRA.StationTransfer.MapURL": { "title": "MapURL", "required": [ "MapName", "MapURL" ], "type": "object", "properties": { "MapName": { "title": "String", "minLength": 1, "type": "string", "description": "地圖名稱", "xml": { "name": "MapName" } }, "MapURL": { "title": "String", "minLength": 1, "type": "string", "description": "地圖簡圖連結", "xml": { "name": "MapUrl" } }, "FloorLevel": { "title": "String", "type": "string", "description": "樓層", "nullable": true, "xml": { "name": "FloorLevel" } } }, "additionalProperties": false, "description": "轉乘地圖簡圖連結資訊", "xml": { "name": "MapURL" } }, "PTX.Service.DTO.Rail.Specification.V3.TRA.StationTransfer.Transfer": { "title": "Transfer", "required": [ "AirportTransfers", "BikeTransfers", "BusTransfers", "ExitID", "ExitName", "FerryTransfers", "ParkingTransfers", "RailTransfers", "TaxiTransfers" ], "type": "object", "properties": { "ExitID": { "title": "String", "minLength": 1, "type": "string", "description": "出口代碼", "xml": { "name": "ExitID" } }, "ExitName": { "title": "String", "minLength": 1, "type": "string", "description": "出口名稱", "xml": { "name": "ExitName" } }, "RailTransfers": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.StationTransfer.RailTransfer" }, "description": "軌道轉乘資訊", "xml": { "name": "RailTransfer" } }, "BusTransfers": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.StationTransfer.BusTransfer" }, "description": "公車運具轉乘資訊", "xml": { "name": "BusTransfer" } }, "AirportTransfers": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.StationTransfer.AirportTransfer" }, "description": "航空運具轉乘資訊", "xml": { "name": "AirportTransfer" } }, "BikeTransfers": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.StationTransfer.BikeTransfer" }, "description": "公共自行車轉乘資訊", "xml": { "name": "BikeTransfer" } }, "ParkingTransfers": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.StationTransfer.ParkingTransfer" }, "description": "停車場轉乘資訊", "xml": { "name": "ParkingTransfer" } }, "TaxiTransfers": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.StationTransfer.TaxiTransfer" }, "description": "計程車轉乘資訊", "xml": { "name": "TaxiTransfer" } }, "FerryTransfers": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.StationTransfer.FerryTransfer" }, "description": "航運轉乘資訊", "xml": { "name": "FerryTransfer" } } }, "additionalProperties": false, "description": "跨運具轉乘資訊", "xml": { "name": "Transfer" } }, "PTX.Service.DTO.Rail.Specification.V3.TRA.StationTransfer.RailTransfer": { "title": "RailTransfer", "required": [ "Mode", "OperatorCode", "OperatorName", "StationID", "StationName" ], "type": "object", "properties": { "Mode": { "title": "String", "minLength": 1, "type": "string", "description": "運具種類代碼", "xml": { "name": "Mode" } }, "OperatorCode": { "title": "String", "minLength": 1, "type": "string", "description": "軌道營運業者簡碼", "xml": { "name": "OperatorCode" } }, "OperatorName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "軌道營運業者名稱", "xml": { "name": "NameType" } }, "StationID": { "title": "String", "minLength": 1, "type": "string", "description": "軌道場站代碼", "xml": { "name": "StationID" } }, "StationName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "軌道場站名稱", "xml": { "name": "NameType" } }, "MinTransferTime": { "type": "number", "description": "最短轉乘時間", "format": "double", "nullable": true }, "FloorLevel": { "title": "String", "type": "string", "description": "轉乘樓層", "nullable": true, "xml": { "name": "FloorLevel" } }, "Description": { "title": "String", "type": "string", "description": "轉乘描述", "nullable": true, "xml": { "name": "Description" } }, "IsOnSiteTransfer": { "type": "boolean", "description": "是否為站內或站外轉乘", "nullable": true } }, "additionalProperties": false, "description": "軌道轉乘資訊", "xml": { "name": "RailTransfer" } }, "PTX.Service.DTO.Rail.Specification.V3.TRA.StationTransfer.BusTransfer": { "title": "BusTransfer", "required": [ "Destination", "Mode", "OperatorCode", "OperatorName", "RouteID", "RouteName", "StopID", "StopName" ], "type": "object", "properties": { "Mode": { "title": "String", "minLength": 1, "type": "string", "description": "運具種類代碼", "xml": { "name": "Mode" } }, "OperatorCode": { "title": "String", "minLength": 1, "type": "string", "description": "公車營運業者簡碼", "xml": { "name": "OperatorCode" } }, "OperatorName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "公車營運業者名稱", "xml": { "name": "NameType" } }, "RouteID": { "title": "String", "minLength": 1, "type": "string", "description": "轉乘公車路線代碼", "xml": { "name": "RouteID" } }, "RouteName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "轉乘公車路線名稱", "xml": { "name": "NameType" } }, "StopID": { "title": "String", "minLength": 1, "type": "string", "description": "轉乘公車站牌代碼", "xml": { "name": "StopID" } }, "StopName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "轉乘公車站牌名稱", "xml": { "name": "NameType" } }, "Destination": { "title": "String", "minLength": 1, "type": "string", "description": "轉乘公車開往方向", "xml": { "name": "Destination" } }, "MinTransferTime": { "type": "number", "description": "最短轉乘時間", "format": "double", "nullable": true }, "FloorLevel": { "title": "String", "type": "string", "description": "轉乘樓層", "nullable": true, "xml": { "name": "FloorLevel" } }, "Description": { "title": "String", "type": "string", "description": "轉乘描述", "nullable": true, "xml": { "name": "Description" } }, "IsOnSiteTransfer": { "type": "boolean", "description": "是否為站內或站外轉乘", "nullable": true }, "Platform": { "title": "String", "type": "string", "description": "轉乘公車所在月台", "nullable": true, "xml": { "name": "Platform" } } }, "additionalProperties": false, "description": "公車運具轉乘資訊", "xml": { "name": "BusTransfer" } }, "PTX.Service.DTO.Rail.Specification.V3.TRA.StationTransfer.AirportTransfer": { "title": "AirportTransfer", "required": [ "AirportID", "AirportName", "Mode", "OperatorCode", "OperatorName" ], "type": "object", "properties": { "Mode": { "title": "String", "minLength": 1, "type": "string", "description": "運具種類代碼", "xml": { "name": "Mode" } }, "OperatorCode": { "title": "String", "minLength": 1, "type": "string", "description": "機場營運業者簡碼", "xml": { "name": "OperatorCode" } }, "OperatorName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "機場營運業者名稱", "xml": { "name": "NameType" } }, "AirportID": { "title": "String", "minLength": 1, "type": "string", "description": "機場代碼", "xml": { "name": "AirportID" } }, "AirportName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "機場名稱", "xml": { "name": "NameType" } }, "MinTransferTime": { "type": "number", "description": "最短轉乘時間", "format": "double", "nullable": true }, "FloorLevel": { "title": "String", "type": "string", "description": "轉乘樓層", "nullable": true, "xml": { "name": "FloorLevel" } }, "Description": { "title": "String", "type": "string", "description": "轉乘描述", "nullable": true, "xml": { "name": "Description" } }, "IsOnSiteTransfer": { "type": "boolean", "description": "是否為站內或站外轉乘", "nullable": true } }, "additionalProperties": false, "description": "航空運具轉乘資訊", "xml": { "name": "AirportTransfer" } }, "PTX.Service.DTO.Rail.Specification.V3.TRA.StationTransfer.BikeTransfer": { "title": "BikeTransfer", "required": [ "Mode", "OperatorCode", "OperatorName", "StationID", "StationName" ], "type": "object", "properties": { "Mode": { "title": "String", "minLength": 1, "type": "string", "description": "運具種類代碼", "xml": { "name": "Mode" } }, "OperatorCode": { "title": "String", "minLength": 1, "type": "string", "description": "公共自行車營運業者簡碼", "xml": { "name": "OperatorCode" } }, "OperatorName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "公共自行車營運業者名稱", "xml": { "name": "NameType" } }, "StationID": { "title": "String", "minLength": 1, "type": "string", "description": "公共自行車租借站位代碼", "xml": { "name": "StationID" } }, "StationName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "公共自行車租借站位名稱", "xml": { "name": "NameType" } }, "MinTransferTime": { "type": "number", "description": "最短轉乘時間", "format": "double", "nullable": true }, "FloorLevel": { "title": "String", "type": "string", "description": "轉乘樓層", "nullable": true, "xml": { "name": "FloorLevel" } }, "Description": { "title": "String", "type": "string", "description": "轉乘描述", "nullable": true, "xml": { "name": "Description" } }, "IsOnSiteTransfer": { "type": "boolean", "description": "是否為站內或站外轉乘", "nullable": true } }, "additionalProperties": false, "description": "公共自行車轉乘資訊", "xml": { "name": "BikeTransfer" } }, "PTX.Service.DTO.Rail.Specification.V3.TRA.StationTransfer.ParkingTransfer": { "title": "ParkingTransfer", "required": [ "CarParkID", "CarParkName", "Mode" ], "type": "object", "properties": { "Mode": { "title": "String", "minLength": 1, "type": "string", "description": "運具種類代碼", "xml": { "name": "Mode" } }, "CarParkID": { "title": "String", "minLength": 1, "type": "string", "description": "停車場代碼", "xml": { "name": "CarParkID" } }, "CarParkName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "停車場名稱", "xml": { "name": "NameType" } }, "MinTransferTime": { "type": "number", "description": "最短轉乘時間", "format": "double", "nullable": true }, "FloorLevel": { "title": "String", "type": "string", "description": "轉乘樓層", "nullable": true, "xml": { "name": "FloorLevel" } }, "Description": { "title": "String", "type": "string", "description": "轉乘描述", "nullable": true, "xml": { "name": "Description" } }, "IsOnSiteTransfer": { "type": "boolean", "description": "是否為站內或站外轉乘", "nullable": true } }, "additionalProperties": false, "description": "停車場轉乘資訊", "xml": { "name": "ParkingTransfer" } }, "PTX.Service.DTO.Rail.Specification.V3.TRA.StationTransfer.TaxiTransfer": { "title": "TaxiTransfer", "required": [ "Mode", "TaxiStopName" ], "type": "object", "properties": { "Mode": { "title": "String", "minLength": 1, "type": "string", "description": "運具種類代碼", "xml": { "name": "Mode" } }, "TaxiStopID": { "title": "String", "type": "string", "description": "計程車招呼站代碼", "nullable": true, "xml": { "name": "TaxiStopID" } }, "TaxiStopName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "計程車招呼站名稱", "xml": { "name": "NameType" } }, "MinTransferTime": { "type": "number", "description": "最短轉乘時間", "format": "double", "nullable": true }, "FloorLevel": { "title": "String", "type": "string", "description": "轉乘樓層", "nullable": true, "xml": { "name": "FloorLevel" } }, "Description": { "title": "String", "type": "string", "description": "轉乘描述", "nullable": true, "xml": { "name": "Description" } }, "IsOnSiteTransfer": { "type": "boolean", "description": "是否為站內或站外轉乘", "nullable": true } }, "additionalProperties": false, "description": "計程車轉乘資訊", "xml": { "name": "TaxiTransfer" } }, "PTX.Service.DTO.Rail.Specification.V3.TRA.StationTransfer.FerryTransfer": { "title": "FerryTransfer", "required": [ "FerryStationName", "Mode", "OperatorCode", "OperatorName" ], "type": "object", "properties": { "Mode": { "title": "String", "minLength": 1, "type": "string", "description": "運具種類代碼", "xml": { "name": "Mode" } }, "OperatorCode": { "title": "String", "minLength": 1, "type": "string", "description": "航運營運業者簡碼", "xml": { "name": "OperatorCode" } }, "OperatorName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "航運營運業者名稱", "xml": { "name": "NameType" } }, "FerryStationID": { "title": "String", "type": "string", "description": "計程車招呼站代碼", "nullable": true, "xml": { "name": "FerryStationID" } }, "FerryStationName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "計程車招呼站名稱", "xml": { "name": "NameType" } }, "MinTransferTime": { "type": "number", "description": "最短轉乘時間", "format": "double", "nullable": true }, "FloorLevel": { "title": "String", "type": "string", "description": "轉乘樓層", "nullable": true, "xml": { "name": "FloorLevel" } }, "Description": { "title": "String", "type": "string", "description": "轉乘描述", "nullable": true, "xml": { "name": "Description" } }, "IsOnSiteTransfer": { "type": "boolean", "description": "是否為站內或站外轉乘", "nullable": true } }, "additionalProperties": false, "description": "航運轉乘資訊", "xml": { "name": "FerryTransfer" } }, "PTX.API.Rail.Model.TRARealTimeWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.TRANewsList.News]": { "title": "TRANewsList", "required": [ "AuthorityCode", "Items", "SrcUpdateInterval", "SrcUpdateTime", "UpdateInterval", "UpdateTime" ], "type": "object", "properties": { "UpdateTime": { "type": "string", "description": "本平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "UpdateInterval": { "title": "Int32", "type": "integer", "description": "本平台資料更新週期(秒)", "format": "int32" }, "SrcUpdateTime": { "title": "DateTime", "type": "string", "description": "來源端平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "SrcUpdateInterval": { "title": "Int32", "type": "integer", "description": "來源端平台資料更新週期(秒)['-1: 不定期更新']", "format": "int32" }, "AuthorityCode": { "title": "String", "minLength": 1, "type": "string", "description": "業管機關簡碼", "xml": { "name": "AuthorityCode" } }, "Items": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.TRANewsList.News" }, "description": "資料(陣列)", "xml": { "name": "List`1" } }, "Count": { "type": "integer", "description": "資料總筆數", "format": "int64", "nullable": true } }, "additionalProperties": false, "xml": { "name": "TRARealTimeWrapperOfNews", "namespace": "https://ptx.transportdata.tw/standard/schema/" } }, "PTX.Service.DTO.Rail.Specification.V3.TRA.TRANewsList.News": { "title": "News", "required": [ "Description", "Language", "NewsCategory", "NewsID", "PublishTime", "Title", "UpdateTime" ], "type": "object", "properties": { "NewsID": { "title": "String", "minLength": 1, "type": "string", "description": "消息代碼", "xml": { "name": "NewsID" } }, "Language": { "title": "Int32", "type": "integer", "description": "語系 : [1:'Zh_tw',2:'En_us',3:'Zh_cn',4:'Ja',5:'Ko',99:'Other']", "format": "int32" }, "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:'新服務上架',8:'API修正',9:'來源異常',99:'其他']", "format": "int32" }, "Description": { "title": "String", "minLength": 1, "type": "string", "description": "內容描述", "xml": { "name": "Description" } }, "NewsURL": { "title": "String", "type": "string", "description": "消息網址連結", "nullable": true, "xml": { "name": "NewsURL" } }, "AttachmentURL": { "title": "String", "type": "string", "description": "附件網址連結", "nullable": true, "xml": { "name": "AttachmentURL" } }, "StartTime": { "type": "string", "description": "消息起始日期時間", "format": "date-time", "nullable": true }, "EndTime": { "type": "string", "description": "消息結束日期時間", "format": "date-time", "nullable": true }, "PublishTime": { "title": "DateTime", "type": "string", "description": "消息發佈日期時間", "format": "date-time" }, "UpdateTime": { "title": "DateTime", "type": "string", "description": "本筆資料之更新日期時間", "format": "date-time" } }, "additionalProperties": false, "xml": { "name": "News" } }, "PTX.API.Rail.Model.TRARealTimeWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.TRAAlertList.Alert]": { "title": "TRAAlertList", "required": [ "AuthorityCode", "Items", "SrcUpdateInterval", "SrcUpdateTime", "UpdateInterval", "UpdateTime" ], "type": "object", "properties": { "UpdateTime": { "type": "string", "description": "本平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "UpdateInterval": { "title": "Int32", "type": "integer", "description": "本平台資料更新週期(秒)", "format": "int32" }, "SrcUpdateTime": { "title": "DateTime", "type": "string", "description": "來源端平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "SrcUpdateInterval": { "title": "Int32", "type": "integer", "description": "來源端平台資料更新週期(秒)['-1: 不定期更新']", "format": "int32" }, "AuthorityCode": { "title": "String", "minLength": 1, "type": "string", "description": "業管機關簡碼", "xml": { "name": "AuthorityCode" } }, "Items": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.TRAAlertList.Alert" }, "description": "資料(陣列)", "xml": { "name": "List`1" } }, "Count": { "type": "integer", "description": "資料總筆數", "format": "int64", "nullable": true } }, "additionalProperties": false, "xml": { "name": "TRARealTimeWrapperOfAlert", "namespace": "https://ptx.transportdata.tw/standard/schema/" } }, "PTX.Service.DTO.Rail.Specification.V3.TRA.TRAAlertList.Alert": { "title": "Alert", "required": [ "AlertID", "Description", "Status", "Title", "UpdateTime" ], "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" } }, "Status": { "title": "Int32", "type": "integer", "description": "營運狀況 : [0:'全線營運停止',1:'全線營運正常',2:'有異常狀況']", "format": "int32" }, "Scope": { "title": "AlertScope", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.TRAAlertList.AlertScope" } ], "description": "影響範圍", "nullable": true, "xml": { "name": "AlertScope" } }, "Direction": { "title": "Int32", "type": "integer", "description": "影響方向 : [0:'南下',1:'北上',2:'雙向']", "format": "int32", "nullable": true }, "Level": { "title": "Int32", "type": "integer", "description": "影響等級程度 : [1:'重度',2:'中度',3:'輕度']", "format": "int32", "nullable": true }, "Effect": { "title": "String", "type": "string", "description": "影響說明", "nullable": true, "xml": { "name": "Effect" } }, "Reason": { "title": "String", "type": "string", "description": "影響原因", "nullable": true, "xml": { "name": "Reason" } }, "AlertURL": { "title": "String", "type": "string", "description": "通阻訊息網址連結", "nullable": true, "xml": { "name": "AlertURL" } }, "StartTime": { "type": "string", "description": "訊息起始日期時間", "format": "date-time", "nullable": true }, "EndTime": { "type": "string", "description": "訊息結束日期時間", "format": "date-time", "nullable": true }, "PublishTime": { "type": "string", "description": "消息發佈日期時間", "format": "date-time", "nullable": true }, "UpdateTime": { "title": "DateTime", "type": "string", "description": "消息更新日期時間", "format": "date-time" } }, "additionalProperties": false, "xml": { "name": "Alert" } }, "PTX.Service.DTO.Rail.Specification.V3.TRA.TRAAlertList.AlertScope": { "title": "AlertScope", "type": "object", "properties": { "NetworkList": { "title": "AlertScopeNetwork", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.TRAAlertList.AlertScopeNetwork" } ], "description": "受影響的路網", "nullable": true, "xml": { "name": "AlertScopeNetwork" } }, "Stations": { "title": "AlertScopeStation[]", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.TRAAlertList.AlertScopeStation" }, "description": "受影響的車站", "nullable": true, "xml": { "name": "AlertScopeStation[]" } }, "Lines": { "title": "AlertScopeLine[]", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.TRAAlertList.AlertScopeLine" }, "description": "受影響的實體路線", "nullable": true, "xml": { "name": "AlertScopeLine[]" } }, "Routes": { "title": "AlertScopeRoute[]", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.TRAAlertList.AlertScopeRoute" }, "description": "受影響的營運路線", "nullable": true, "xml": { "name": "AlertScopeRoute[]" } }, "Trains": { "title": "AlertScopeTrain[]", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.TRAAlertList.AlertScopeTrain" }, "description": "受影響的車次", "nullable": true, "xml": { "name": "AlertScopeTrain[]" } }, "LineSections": { "title": "AlertScopeLineSection[]", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.TRAAlertList.AlertScopeLineSection" }, "description": "受影響的路線區間", "nullable": true, "xml": { "name": "AlertScopeLineSection[]" } } }, "additionalProperties": false, "xml": { "name": "AlertScope" } }, "PTX.Service.DTO.Rail.Specification.V3.TRA.TRAAlertList.AlertScopeStation": { "title": "AlertScopeStation", "type": "object", "properties": { "StationID": { "title": "String", "type": "string", "description": "車站代碼", "nullable": true, "xml": { "name": "StationID" } }, "StationName": { "title": "String", "type": "string", "description": "車站名稱", "nullable": true, "xml": { "name": "StationName" } } }, "additionalProperties": false, "xml": { "name": "AlertScopeStation" } }, "PTX.Service.DTO.Rail.Specification.V3.TRA.TRAAlertList.AlertScopeLine": { "title": "AlertScopeLine", "type": "object", "properties": { "LineID": { "title": "String", "type": "string", "description": "實體路線代碼", "nullable": true, "xml": { "name": "LineID" } }, "LineName": { "title": "String", "type": "string", "description": "實體路線名稱", "nullable": true, "xml": { "name": "LineName" } } }, "additionalProperties": false, "xml": { "name": "AlertScopeLine" } }, "PTX.Service.DTO.Rail.Specification.V3.TRA.TRAAlertList.AlertScopeRoute": { "title": "AlertScopeRoute", "type": "object", "properties": { "RouteID": { "title": "String", "type": "string", "description": "營運路線代碼", "nullable": true, "xml": { "name": "RouteID" } }, "RouteName": { "title": "String", "type": "string", "description": "營運路線名稱", "nullable": true, "xml": { "name": "RouteName" } } }, "additionalProperties": false, "xml": { "name": "AlertScopeRoute" } }, "PTX.Service.DTO.Rail.Specification.V3.TRA.TRAAlertList.AlertScopeTrain": { "title": "AlertScopeTrain", "type": "object", "properties": { "TrainNo": { "title": "String", "type": "string", "description": "受影響的車次", "nullable": true, "xml": { "name": "TrainNo" } } }, "additionalProperties": false, "xml": { "name": "AlertScopeTrain" } }, "PTX.Service.DTO.Rail.Specification.V3.TRA.TRAAlertList.AlertScopeLineSection": { "title": "AlertScopeLineSection", "type": "object", "properties": { "LineID": { "title": "String", "type": "string", "description": "路線區間所在路線代碼", "nullable": true, "xml": { "name": "LineID" } }, "StartingStationID": { "title": "String", "type": "string", "description": "區間起站車站代碼", "nullable": true, "xml": { "name": "StartingStationID" } }, "StartingStationName": { "title": "String", "type": "string", "description": "區間起站車站名稱", "nullable": true, "xml": { "name": "StartingStationName" } }, "EndingStationID": { "title": "String", "type": "string", "description": "區間迄站車站代碼", "nullable": true, "xml": { "name": "EndingStationID" } }, "EndingStationName": { "title": "String", "type": "string", "description": "區間迄站車站名稱", "nullable": true, "xml": { "name": "EndingStationName" } }, "Description": { "title": "String", "type": "string", "description": "影響區間輔助描述", "nullable": true, "xml": { "name": "Description" } } }, "additionalProperties": false, "xml": { "name": "AlertScopeLineSection" } }, "PTX.Service.DTO.Rail.Specification.V3.TRA.TRAAlertList.AlertScopeNetwork": { "title": "AlertScopeNetwork", "type": "object", "properties": { "NetworkID": { "title": "String", "type": "string", "description": "路網代碼", "nullable": true, "xml": { "name": "NetworkID" } }, "NetworkName": { "title": "String", "type": "string", "description": "路網名稱", "nullable": true, "xml": { "name": "NetworkName" } } }, "additionalProperties": false, "xml": { "name": "AlertScopeNetwork" } }, "PTX.API.Rail.Model.TRABaseWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.Shape]": { "title": "TRAShapeList", "required": [ "AuthorityCode", "Items", "SrcUpdateInterval", "SrcUpdateTime", "UpdateInterval", "UpdateTime" ], "type": "object", "properties": { "UpdateTime": { "type": "string", "description": "本平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "UpdateInterval": { "title": "Int32", "type": "integer", "description": "本平台資料更新週期(秒)", "format": "int32" }, "SrcUpdateTime": { "title": "DateTime", "type": "string", "description": "來源端平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "SrcUpdateInterval": { "title": "Int32", "type": "integer", "description": "來源端平台資料更新週期(秒)['-1: 不定期更新']", "format": "int32" }, "AuthorityCode": { "title": "String", "minLength": 1, "type": "string", "description": "業管機關簡碼", "xml": { "name": "AuthorityCode" } }, "Items": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.Shape" }, "description": "資料(陣列)", "xml": { "name": "List`1" } }, "Count": { "type": "integer", "description": "資料總筆數", "format": "int64", "nullable": true } }, "additionalProperties": false, "xml": { "name": "TRABaseWrapperOfShape", "namespace": "https://ptx.transportdata.tw/standard/schema/" } }, "PTX.Service.DTO.Rail.Specification.V3.TRA.Shape": { "title": "Shape", "required": [ "Geometry", "LineID", "LineName", "LineNo", "UpdateTime" ], "type": "object", "properties": { "LineNo": { "title": "String", "minLength": 1, "type": "string", "description": "路線編號", "xml": { "name": "LineNo" } }, "LineID": { "title": "String", "minLength": 1, "type": "string", "description": "路線代碼", "xml": { "name": "LineID" } }, "LineName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "路線名稱", "xml": { "name": "NameType" } }, "Geometry": { "title": "String", "minLength": 1, "type": "string", "description": "well-known text,為路線軌跡資料", "xml": { "name": "Geometry" } }, "UpdateTime": { "title": "DateTime", "type": "string", "description": "資料更新日期時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" } }, "additionalProperties": false, "description": "線型資料", "xml": { "name": "Shape" } }, "PTX.API.Rail.Model.TRABaseWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.Operator]": { "title": "TRAOperatorList", "required": [ "AuthorityCode", "Items", "SrcUpdateInterval", "SrcUpdateTime", "UpdateInterval", "UpdateTime" ], "type": "object", "properties": { "UpdateTime": { "type": "string", "description": "本平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "UpdateInterval": { "title": "Int32", "type": "integer", "description": "本平台資料更新週期(秒)", "format": "int32" }, "SrcUpdateTime": { "title": "DateTime", "type": "string", "description": "來源端平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "SrcUpdateInterval": { "title": "Int32", "type": "integer", "description": "來源端平台資料更新週期(秒)['-1: 不定期更新']", "format": "int32" }, "AuthorityCode": { "title": "String", "minLength": 1, "type": "string", "description": "業管機關簡碼", "xml": { "name": "AuthorityCode" } }, "Items": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.Operator" }, "description": "資料(陣列)", "xml": { "name": "List`1" } }, "Count": { "type": "integer", "description": "資料總筆數", "format": "int64", "nullable": true } }, "additionalProperties": false, "xml": { "name": "TRABaseWrapperOfOperator", "namespace": "https://ptx.transportdata.tw/standard/schema/" } }, "PTX.Service.DTO.Rail.Specification.V3.TRA.Operator": { "title": "Operator", "required": [ "OperatorCode", "OperatorName" ], "type": "object", "properties": { "OperatorCode": { "title": "String", "minLength": 1, "type": "string", "description": "營運業者簡碼", "xml": { "name": "OperatorCode" } }, "OperatorName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.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" } }, "FareURL": { "title": "String", "type": "string", "description": "營運業者票價查詢網站連結", "nullable": true, "xml": { "name": "FareURL" } }, "ReservationURL": { "title": "String", "type": "string", "description": "營運業者訂票網站", "nullable": true, "xml": { "name": "ReservationURL" } }, "ReservationPhone": { "title": "String", "type": "string", "description": "營運業者訂票電話", "nullable": true, "xml": { "name": "ReservationPhone" } }, "OperatorLogoURL": { "title": "String", "type": "string", "description": "營運業者Logo網址", "nullable": true, "xml": { "name": "OperatorLogoURL" } } }, "additionalProperties": false, "description": "營運業者基本資料", "xml": { "name": "Operator" } }, "PTX.API.Rail.Model.TRABaseWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.LineNetwork.LineNetwork]": { "title": "TRALineNetworkList", "required": [ "AuthorityCode", "Items", "SrcUpdateInterval", "SrcUpdateTime", "UpdateInterval", "UpdateTime" ], "type": "object", "properties": { "UpdateTime": { "type": "string", "description": "本平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "UpdateInterval": { "title": "Int32", "type": "integer", "description": "本平台資料更新週期(秒)", "format": "int32" }, "SrcUpdateTime": { "title": "DateTime", "type": "string", "description": "來源端平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "SrcUpdateInterval": { "title": "Int32", "type": "integer", "description": "來源端平台資料更新週期(秒)['-1: 不定期更新']", "format": "int32" }, "AuthorityCode": { "title": "String", "minLength": 1, "type": "string", "description": "業管機關簡碼", "xml": { "name": "AuthorityCode" } }, "Items": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.LineNetwork.LineNetwork" }, "description": "資料(陣列)", "xml": { "name": "List`1" } }, "Count": { "type": "integer", "description": "資料總筆數", "format": "int64", "nullable": true } }, "additionalProperties": false, "xml": { "name": "TRABaseWrapperOfLineNetwork", "namespace": "https://ptx.transportdata.tw/standard/schema/" } }, "PTX.Service.DTO.Rail.Specification.V3.TRA.LineNetwork.LineNetwork": { "title": "LineNetwork", "required": [ "LineID", "LineName" ], "type": "object", "properties": { "LineID": { "title": "String", "minLength": 1, "type": "string", "description": "路線編號", "xml": { "name": "LineID" } }, "LineName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "路線名稱", "xml": { "name": "NameType" } }, "LineSegments": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.LineNetwork.LineSegment" }, "description": "路線站點間線段資訊", "nullable": true, "xml": { "name": "List`1" } } }, "additionalProperties": false, "description": "路線網路拓撲基本資料", "xml": { "name": "LineNetwork" } }, "PTX.Service.DTO.Rail.Specification.V3.TRA.LineNetwork.LineSegment": { "title": "LineSegment", "required": [ "Distance", "FromStationID", "LineSegmentID", "LineSegmentName", "SegmentType", "ToStationID" ], "type": "object", "properties": { "LineSegmentID": { "title": "String", "minLength": 1, "type": "string", "description": "線段代碼", "xml": { "name": "LineSegmentID" } }, "LineSegmentName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "路段名稱", "xml": { "name": "NameType" } }, "FromStationID": { "title": "String", "minLength": 1, "type": "string", "description": "線段起點站代碼", "xml": { "name": "FromStationID" } }, "ToStationID": { "title": "String", "minLength": 1, "type": "string", "description": "線段迄點站代碼", "xml": { "name": "ToStationID" } }, "SegmentType": { "title": "String", "minLength": 1, "type": "string", "description": "線段種類 = ['M: 主路線', 'B: 分支路線']", "xml": { "name": "SegmentType" } }, "Distance": { "title": "Single", "type": "number", "description": "站間距離", "format": "float" } }, "additionalProperties": false, "description": "路線站點間線段資料", "xml": { "name": "LineSegment" } }, "PTX.API.Rail.Model.LiteTrain.LiteTrainBaseWrapper[PTX.Service.DTO.Rail.Specification.V3.LiteTrain.Network.Network]": { "title": "LiteTrainNetworkList", "required": [ "AuthorityCode", "Items", "SrcUpdateInterval", "SrcUpdateTime", "UpdateInterval", "UpdateTime" ], "type": "object", "properties": { "UpdateTime": { "type": "string", "description": "本平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "UpdateInterval": { "title": "Int32", "type": "integer", "description": "本平台資料更新週期(秒)", "format": "int32" }, "SrcUpdateTime": { "title": "DateTime", "type": "string", "description": "來源端平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "SrcUpdateInterval": { "title": "Int32", "type": "integer", "description": "來源端平台資料更新週期(秒)['-1: 不定期更新']", "format": "int32" }, "AuthorityCode": { "title": "String", "minLength": 1, "type": "string", "description": "業管機關簡碼", "xml": { "name": "AuthorityCode" } }, "Items": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.LiteTrain.Network.Network" }, "description": "資料(陣列)", "xml": { "name": "List`1" } }, "Count": { "type": "integer", "description": "資料總筆數", "format": "int64", "nullable": true } }, "additionalProperties": false, "xml": { "name": "LiteTrainBaseWrapperOfNetwork", "namespace": "https://ptx.transportdata.tw/standard/schema/" } }, "PTX.Service.DTO.Rail.Specification.V3.LiteTrain.Network.Network": { "title": "Network", "required": [ "Lines", "NetworkID", "NetworkMapURL", "NetworkName", "OperatorCode", "OperatorName" ], "type": "object", "properties": { "NetworkID": { "title": "String", "minLength": 1, "type": "string", "description": "路網代碼", "xml": { "name": "NetworkID" } }, "NetworkName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "路網名稱", "xml": { "name": "NameType" } }, "OperatorCode": { "title": "String", "minLength": 1, "type": "string", "description": "營運業者代碼", "xml": { "name": "OperatorCode" } }, "OperatorName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "營運業者名稱", "xml": { "name": "NameType" } }, "NetworkMapURL": { "title": "MapNameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.Network.MapNameType" } ], "description": "路網圖網址URL", "xml": { "name": "MapNameType" } }, "Lines": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.Network.Line" }, "description": "路線資訊", "xml": { "name": "List`1" } } }, "additionalProperties": false, "description": "小火車路網資料", "xml": { "name": "Network" } }, "PTX.API.Rail.Model.LiteTrain.LiteTrainBaseWrapper[PTX.Service.DTO.Rail.Specification.V3.LiteTrain.Station]": { "title": "LiteTrainStationList", "required": [ "AuthorityCode", "Items", "SrcUpdateInterval", "SrcUpdateTime", "UpdateInterval", "UpdateTime" ], "type": "object", "properties": { "UpdateTime": { "type": "string", "description": "本平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "UpdateInterval": { "title": "Int32", "type": "integer", "description": "本平台資料更新週期(秒)", "format": "int32" }, "SrcUpdateTime": { "title": "DateTime", "type": "string", "description": "來源端平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "SrcUpdateInterval": { "title": "Int32", "type": "integer", "description": "來源端平台資料更新週期(秒)['-1: 不定期更新']", "format": "int32" }, "AuthorityCode": { "title": "String", "minLength": 1, "type": "string", "description": "業管機關簡碼", "xml": { "name": "AuthorityCode" } }, "Items": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.LiteTrain.Station" }, "description": "資料(陣列)", "xml": { "name": "List`1" } }, "Count": { "type": "integer", "description": "資料總筆數", "format": "int64", "nullable": true } }, "additionalProperties": false, "xml": { "name": "LiteTrainBaseWrapperOfStation", "namespace": "https://ptx.transportdata.tw/standard/schema/" } }, "PTX.Service.DTO.Rail.Specification.V3.LiteTrain.Station": { "title": "Station", "required": [ "StationClass", "StationID", "StationName", "StationPosition", "StationUID" ], "type": "object", "properties": { "StationUID": { "title": "String", "minLength": 1, "type": "string", "description": "車站唯一識別代碼", "xml": { "name": "StationUID" } }, "StationID": { "title": "String", "minLength": 1, "type": "string", "description": "車站代碼", "xml": { "name": "StationID" } }, "ReservationCode": { "title": "String", "type": "string", "description": "訂票車站代碼", "nullable": true, "xml": { "name": "ReservationCode" } }, "StationName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "車站名稱", "xml": { "name": "NameType" } }, "StationPosition": { "title": "PointType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.PointType" } ], "description": "車站座標(WGS84)", "xml": { "name": "PointType" } }, "StationAddress": { "title": "String", "type": "string", "description": "車站地址", "nullable": true, "xml": { "name": "StationAddress" } }, "StationPhone": { "title": "String", "type": "string", "description": "車站聯絡電話", "nullable": true, "xml": { "name": "StationPhone" } }, "StationURL": { "title": "String", "type": "string", "description": "車站資訊說明網址", "nullable": true, "xml": { "name": "StationURL" } }, "StationClass": { "title": "String", "minLength": 1, "type": "string", "description": "車站級別 = ['0: 特等', '1: 一等', '2: 二等', '3: 三等', '4: 簡易', '5: 招呼', '6: 號誌', '7:其他']", "xml": { "name": "StationClass" } } }, "additionalProperties": false, "description": "小火車車站資料", "xml": { "name": "Station" } }, "PTX.API.Rail.Model.LiteTrain.LiteTrainBaseWrapper[PTX.Service.DTO.Rail.Specification.V3.LiteTrain.Line]": { "title": "LiteTrainLineList", "required": [ "AuthorityCode", "Items", "SrcUpdateInterval", "SrcUpdateTime", "UpdateInterval", "UpdateTime" ], "type": "object", "properties": { "UpdateTime": { "type": "string", "description": "本平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "UpdateInterval": { "title": "Int32", "type": "integer", "description": "本平台資料更新週期(秒)", "format": "int32" }, "SrcUpdateTime": { "title": "DateTime", "type": "string", "description": "來源端平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "SrcUpdateInterval": { "title": "Int32", "type": "integer", "description": "來源端平台資料更新週期(秒)['-1: 不定期更新']", "format": "int32" }, "AuthorityCode": { "title": "String", "minLength": 1, "type": "string", "description": "業管機關簡碼", "xml": { "name": "AuthorityCode" } }, "Items": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.LiteTrain.Line" }, "description": "資料(陣列)", "xml": { "name": "List`1" } }, "Count": { "type": "integer", "description": "資料總筆數", "format": "int64", "nullable": true } }, "additionalProperties": false, "xml": { "name": "LiteTrainBaseWrapperOfLine", "namespace": "https://ptx.transportdata.tw/standard/schema/" } }, "PTX.Service.DTO.Rail.Specification.V3.LiteTrain.Line": { "title": "Line", "required": [ "IsBranch", "LineID", "LineName", "LineNo", "LineSectionName" ], "type": "object", "properties": { "LineNo": { "title": "String", "minLength": 1, "type": "string", "description": "路線編號", "xml": { "name": "LineNo" } }, "LineID": { "title": "String", "minLength": 1, "type": "string", "description": "路線代碼", "xml": { "name": "LineID" } }, "LineName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "路線名稱", "xml": { "name": "NameType" } }, "LineSectionName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "路線區間名稱", "xml": { "name": "NameType" } }, "LineColor": { "title": "String", "type": "string", "description": "路線顏色", "nullable": true, "xml": { "name": "LineColor" } }, "IsBranch": { "title": "Boolean", "type": "boolean", "description": "是否位於支線" }, "LineGroup": { "title": "String", "type": "string", "description": "路線群組", "nullable": true, "xml": { "name": "LineGroup" } }, "LineURL": { "title": "String", "type": "string", "description": "路線群組", "nullable": true, "xml": { "name": "LineURL" } } }, "additionalProperties": false, "description": "路線基本資料", "xml": { "name": "Line" } }, "PTX.API.Rail.Model.LiteTrain.LiteTrainBaseWrapper[PTX.Service.DTO.Rail.Specification.V3.LiteTrain.Operator]": { "title": "LiteTrainOperatorList", "required": [ "AuthorityCode", "Items", "SrcUpdateInterval", "SrcUpdateTime", "UpdateInterval", "UpdateTime" ], "type": "object", "properties": { "UpdateTime": { "type": "string", "description": "本平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "UpdateInterval": { "title": "Int32", "type": "integer", "description": "本平台資料更新週期(秒)", "format": "int32" }, "SrcUpdateTime": { "title": "DateTime", "type": "string", "description": "來源端平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "SrcUpdateInterval": { "title": "Int32", "type": "integer", "description": "來源端平台資料更新週期(秒)['-1: 不定期更新']", "format": "int32" }, "AuthorityCode": { "title": "String", "minLength": 1, "type": "string", "description": "業管機關簡碼", "xml": { "name": "AuthorityCode" } }, "Items": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.LiteTrain.Operator" }, "description": "資料(陣列)", "xml": { "name": "List`1" } }, "Count": { "type": "integer", "description": "資料總筆數", "format": "int64", "nullable": true } }, "additionalProperties": false, "xml": { "name": "LiteTrainBaseWrapperOfOperator", "namespace": "https://ptx.transportdata.tw/standard/schema/" } }, "PTX.Service.DTO.Rail.Specification.V3.LiteTrain.Operator": { "title": "Operator", "required": [ "OperatorCode", "OperatorName" ], "type": "object", "properties": { "OperatorCode": { "title": "String", "minLength": 1, "type": "string", "description": "營運業者簡碼", "xml": { "name": "OperatorCode" } }, "OperatorName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.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" } }, "FareURL": { "title": "String", "type": "string", "description": "營運業者票價查詢網站連結", "nullable": true, "xml": { "name": "FareURL" } }, "ReservationURL": { "title": "String", "type": "string", "description": "營運業者訂票網站", "nullable": true, "xml": { "name": "ReservationURL" } }, "ReservationPhone": { "title": "String", "type": "string", "description": "營運業者訂票電話", "nullable": true, "xml": { "name": "ReservationPhone" } }, "OperatorLogoURL": { "title": "String", "type": "string", "description": "營運業者Logo網址", "nullable": true, "xml": { "name": "OperatorLogoURL" } } }, "additionalProperties": false, "description": "小火車者營運業者基本資料", "xml": { "name": "Operator" } }, "PTX.API.Rail.Model.LiteTrain.LiteTrainGeneralTrainWrapper[PTX.Service.DTO.Rail.Specification.V3.LiteTrain.GeneralTrainTimetable]": { "title": "LiteTrainGeneralTrainTimetableList", "required": [ "AuthorityCode", "EffectiveDate", "SrcUpdateInterval", "SrcUpdateTime", "TrainTimetables", "UpdateInterval", "UpdateTime" ], "type": "object", "properties": { "UpdateTime": { "type": "string", "description": "本平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "UpdateInterval": { "title": "Int32", "type": "integer", "description": "本平台資料更新週期(秒)", "format": "int32" }, "SrcUpdateTime": { "title": "DateTime", "type": "string", "description": "來源端平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "SrcUpdateInterval": { "title": "Int32", "type": "integer", "description": "來源端平台資料更新週期(秒)['-1: 不定期更新']", "format": "int32" }, "AuthorityCode": { "title": "String", "minLength": 1, "type": "string", "description": "業管機關簡碼", "xml": { "name": "AuthorityCode" } }, "EffectiveDate": { "title": "DateTime", "type": "string", "description": "有效起始日期", "format": "date-time" }, "ExpireDate": { "type": "string", "description": "有效終止日期", "format": "date-time", "nullable": true }, "SrcVersion": { "title": "String", "type": "string", "description": "來源版號", "nullable": true, "xml": { "name": "SrcVersion" } }, "TimetableName": { "title": "String", "type": "string", "description": "定期性站別時刻表名稱", "nullable": true, "xml": { "name": "TimetableName" } }, "ValidityDesciption": { "title": "String", "type": "string", "description": "時刻表適用情形說明", "nullable": true, "xml": { "name": "ValidityDesciption" } }, "TrainTimetables": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.LiteTrain.GeneralTrainTimetable" }, "description": "資料(陣列)", "xml": { "name": "List`1" } }, "Count": { "type": "integer", "description": "資料總筆數", "format": "int64", "nullable": true } }, "additionalProperties": false, "xml": { "name": "LiteTrainGeneralTrainWrapperOfGeneralTrainTimetable", "namespace": "https://ptx.transportdata.tw/standard/schema/" } }, "PTX.Service.DTO.Rail.Specification.V3.LiteTrain.GeneralTrainTimetable": { "title": "GeneralTrainTimetable", "required": [ "ServiceDay", "StopTimes", "TrainInfo" ], "type": "object", "properties": { "TrainInfo": { "title": "TrainInfo", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.Common.TrainInfo" } ], "description": "定期車次資料", "xml": { "name": "TrainInfo" } }, "StopTimes": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.Common.StopTime" }, "description": "停靠時間資料", "xml": { "name": "StopTime" } }, "ServiceDay": { "title": "ServiceDay", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.Common.ServiceDay" } ], "description": "營運日型態", "xml": { "name": "ServiceDay" } } }, "additionalProperties": false, "description": "小火車定期時刻表資料型別", "xml": { "name": "GeneralTrainTimetable" } }, "PTX.API.Rail.Model.LiteTrain.LiteTrainODFareWrapper[PTX.Service.DTO.Rail.Specification.V3.LiteTrain.ODFare.ODFare]": { "title": "LiteTrainODFareList", "required": [ "AuthorityCode", "ODFares", "SrcUpdateInterval", "SrcUpdateTime", "UpdateInterval", "UpdateTime" ], "type": "object", "properties": { "UpdateTime": { "type": "string", "description": "本平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "UpdateInterval": { "title": "Int32", "type": "integer", "description": "本平台資料更新週期(秒)", "format": "int32" }, "SrcUpdateTime": { "title": "DateTime", "type": "string", "description": "來源端平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "SrcUpdateInterval": { "title": "Int32", "type": "integer", "description": "來源端平台資料更新週期(秒)['-1: 不定期更新']", "format": "int32" }, "AuthorityCode": { "title": "String", "minLength": 1, "type": "string", "description": "業管機關簡碼", "xml": { "name": "AuthorityCode" } }, "EffectiveDate": { "title": "String", "type": "string", "description": "有效起始日期", "nullable": true, "xml": { "name": "EffectiveDate" } }, "ExpireDate": { "title": "String", "type": "string", "description": "有效終止日期", "nullable": true, "xml": { "name": "ExpireDate" } }, "SrcVersion": { "title": "String", "type": "string", "description": "資料版本", "nullable": true, "xml": { "name": "SrcVersion" } }, "ODFares": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.LiteTrain.ODFare.ODFare" }, "description": "資料(陣列)", "xml": { "name": "List`1" } }, "Count": { "type": "integer", "description": "資料總筆數", "format": "int64", "nullable": true } }, "additionalProperties": false, "xml": { "name": "LiteTrainODFareWrapperOfODFare", "namespace": "https://ptx.transportdata.tw/standard/schema/" } }, "PTX.Service.DTO.Rail.Specification.V3.LiteTrain.ODFare.ODFare": { "title": "ODFare", "required": [ "DestinationStationID", "DestinationStationName", "Fares", "OriginStationID", "OriginStationName", "TrainType" ], "type": "object", "properties": { "OriginStationID": { "title": "String", "minLength": 1, "type": "string", "description": "起點車站代碼", "xml": { "name": "OriginStationID" } }, "OriginStationName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "起點車站名稱", "xml": { "name": "NameType" } }, "DestinationStationID": { "title": "String", "minLength": 1, "type": "string", "description": "迄點車站代碼", "xml": { "name": "DestinationStationID" } }, "DestinationStationName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "迄點車站名稱", "xml": { "name": "NameType" } }, "Direction": { "title": "Int32", "type": "integer", "description": "方向 : [0:'順行',1:'逆行']", "format": "int32", "nullable": true }, "TrainType": { "title": "Int32", "type": "integer", "description": "車種簡碼 = ['1: 太魯閣', '2: 普悠瑪', '3: 自強', '4: 莒光', '5: 復興', '6: 區間', '7: 普快', '10: 區間快']", "format": "int32" }, "Fares": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.ODFare.Fare" }, "description": "票價", "xml": { "name": "Fare" } }, "TravelDistance": { "type": "number", "description": "起迄站間乘車距離", "format": "float", "nullable": true } }, "additionalProperties": false, "xml": { "name": "ODFare" } }, "PTX.API.Rail.Model.LiteTrain.LiteTrainBaseWrapper[PTX.Service.DTO.Rail.Specification.V3.LiteTrain.Route]": { "title": "LiteTrainRouteList", "required": [ "AuthorityCode", "Items", "SrcUpdateInterval", "SrcUpdateTime", "UpdateInterval", "UpdateTime" ], "type": "object", "properties": { "UpdateTime": { "type": "string", "description": "本平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "UpdateInterval": { "title": "Int32", "type": "integer", "description": "本平台資料更新週期(秒)", "format": "int32" }, "SrcUpdateTime": { "title": "DateTime", "type": "string", "description": "來源端平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "SrcUpdateInterval": { "title": "Int32", "type": "integer", "description": "來源端平台資料更新週期(秒)['-1: 不定期更新']", "format": "int32" }, "AuthorityCode": { "title": "String", "minLength": 1, "type": "string", "description": "業管機關簡碼", "xml": { "name": "AuthorityCode" } }, "Items": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.LiteTrain.Route" }, "description": "資料(陣列)", "xml": { "name": "List`1" } }, "Count": { "type": "integer", "description": "資料總筆數", "format": "int64", "nullable": true } }, "additionalProperties": false, "xml": { "name": "LiteTrainBaseWrapperOfRoute", "namespace": "https://ptx.transportdata.tw/standard/schema/" } }, "PTX.Service.DTO.Rail.Specification.V3.LiteTrain.Route": { "title": "Route", "required": [ "EndStationID", "EndStationName", "LineID", "OperatorCode", "RouteID", "RouteName", "RouteType", "RouteURL", "StartStationID", "StartStationName" ], "type": "object", "properties": { "LineNo": { "title": "String", "type": "string", "description": "營運路線所屬之路線編號", "nullable": true, "xml": { "name": "LineNo" } }, "LineID": { "title": "String", "minLength": 1, "type": "string", "description": "營運路線所屬之路線代碼", "xml": { "name": "LineID" } }, "RouteID": { "title": "String", "minLength": 1, "type": "string", "description": "營運路線代碼", "xml": { "name": "RouteID" } }, "OperatorCode": { "title": "String", "minLength": 1, "type": "string", "description": "營運業者代碼", "xml": { "name": "OperatorCode" } }, "RouteName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "營運路線名稱", "xml": { "name": "NameType" } }, "RouteType": { "title": "Int32", "type": "integer", "description": "營運路線種類", "format": "int32" }, "StartStationID": { "title": "String", "minLength": 1, "type": "string", "description": "營運路線起站代號", "xml": { "name": "StartStationID" } }, "StartStationName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "營運路線起站名稱", "xml": { "name": "NameType" } }, "EndStationID": { "title": "String", "minLength": 1, "type": "string", "description": "營運路線迄站代號", "xml": { "name": "EndStationID" } }, "EndStationName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "營運路線迄站名稱", "xml": { "name": "NameType" } }, "RouteURL": { "title": "String", "minLength": 1, "type": "string", "description": "營運路線來源網址", "xml": { "name": "RouteURL" } }, "RouteDistance": { "type": "number", "description": "路線旅行長度", "format": "float", "nullable": true } }, "additionalProperties": false, "description": "營運路線基本資料", "xml": { "name": "Route" } }, "PTX.API.Rail.Model.LiteTrain.LiteTrainBaseWrapper[PTX.Service.DTO.Rail.Specification.V3.LiteTrain.StationOfLine.StationOfLine]": { "title": "LiteTrainStationOfLineList", "required": [ "AuthorityCode", "Items", "SrcUpdateInterval", "SrcUpdateTime", "UpdateInterval", "UpdateTime" ], "type": "object", "properties": { "UpdateTime": { "type": "string", "description": "本平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "UpdateInterval": { "title": "Int32", "type": "integer", "description": "本平台資料更新週期(秒)", "format": "int32" }, "SrcUpdateTime": { "title": "DateTime", "type": "string", "description": "來源端平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "SrcUpdateInterval": { "title": "Int32", "type": "integer", "description": "來源端平台資料更新週期(秒)['-1: 不定期更新']", "format": "int32" }, "AuthorityCode": { "title": "String", "minLength": 1, "type": "string", "description": "業管機關簡碼", "xml": { "name": "AuthorityCode" } }, "Items": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.LiteTrain.StationOfLine.StationOfLine" }, "description": "資料(陣列)", "xml": { "name": "List`1" } }, "Count": { "type": "integer", "description": "資料總筆數", "format": "int64", "nullable": true } }, "additionalProperties": false, "xml": { "name": "LiteTrainBaseWrapperOfStationOfLine", "namespace": "https://ptx.transportdata.tw/standard/schema/" } }, "PTX.Service.DTO.Rail.Specification.V3.LiteTrain.StationOfLine.StationOfLine": { "title": "StationOfLine", "required": [ "LineID", "LineNo", "Stations" ], "type": "object", "properties": { "LineNo": { "title": "String", "minLength": 1, "type": "string", "description": "路線編號", "xml": { "name": "LineNo" } }, "LineID": { "title": "String", "minLength": 1, "type": "string", "description": "路線代碼", "xml": { "name": "LineID" } }, "Stations": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.StationOfLine.LineStation" }, "description": "路線車站資訊", "xml": { "name": "Station" } } }, "additionalProperties": false, "description": "路線車站基本資料", "xml": { "name": "StationOfLine" } }, "PTX.API.Rail.Model.LiteTrain.LiteTrainBaseWrapper[PTX.Service.DTO.Rail.Specification.V3.LiteTrain.TrainType]": { "title": "LiteTrainTrainTypeList", "required": [ "AuthorityCode", "Items", "SrcUpdateInterval", "SrcUpdateTime", "UpdateInterval", "UpdateTime" ], "type": "object", "properties": { "UpdateTime": { "type": "string", "description": "本平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "UpdateInterval": { "title": "Int32", "type": "integer", "description": "本平台資料更新週期(秒)", "format": "int32" }, "SrcUpdateTime": { "title": "DateTime", "type": "string", "description": "來源端平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "SrcUpdateInterval": { "title": "Int32", "type": "integer", "description": "來源端平台資料更新週期(秒)['-1: 不定期更新']", "format": "int32" }, "AuthorityCode": { "title": "String", "minLength": 1, "type": "string", "description": "業管機關簡碼", "xml": { "name": "AuthorityCode" } }, "Items": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.LiteTrain.TrainType" }, "description": "資料(陣列)", "xml": { "name": "List`1" } }, "Count": { "type": "integer", "description": "資料總筆數", "format": "int64", "nullable": true } }, "additionalProperties": false, "xml": { "name": "LiteTrainBaseWrapperOfTrainType", "namespace": "https://ptx.transportdata.tw/standard/schema/" } }, "PTX.Service.DTO.Rail.Specification.V3.LiteTrain.TrainType": { "title": "TrainType", "required": [ "TrainTypeCode", "TrainTypeID", "TrainTypeName" ], "type": "object", "properties": { "TrainTypeID": { "title": "String", "minLength": 1, "type": "string", "description": "列車車種代碼", "xml": { "name": "TrainTypeID" } }, "TrainTypeName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "列車車種名稱", "xml": { "name": "NameType" } }, "TrainTypeCode": { "title": "String", "minLength": 1, "type": "string", "description": "車種簡碼 = ['1: 中興號', '2: 區間', '3: 主題式列車', '5: 阿里山號', '6: 祝客', '7: 祝客(祝山線)', '8: 檜木車廂']", "xml": { "name": "TrainTypeCode" } } }, "additionalProperties": false, "description": "小火車列車車種資料", "xml": { "name": "TrainType" } }, "PTX.API.Rail.Model.LiteTrain.LiteTrainBaseWrapper[PTX.Service.DTO.Rail.Specification.V3.LiteTrain.StationOfRoute.StationOfRoute]": { "title": "LiteTrainStationOfRouteList", "required": [ "AuthorityCode", "Items", "SrcUpdateInterval", "SrcUpdateTime", "UpdateInterval", "UpdateTime" ], "type": "object", "properties": { "UpdateTime": { "type": "string", "description": "本平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "UpdateInterval": { "title": "Int32", "type": "integer", "description": "本平台資料更新週期(秒)", "format": "int32" }, "SrcUpdateTime": { "title": "DateTime", "type": "string", "description": "來源端平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "SrcUpdateInterval": { "title": "Int32", "type": "integer", "description": "來源端平台資料更新週期(秒)['-1: 不定期更新']", "format": "int32" }, "AuthorityCode": { "title": "String", "minLength": 1, "type": "string", "description": "業管機關簡碼", "xml": { "name": "AuthorityCode" } }, "Items": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.LiteTrain.StationOfRoute.StationOfRoute" }, "description": "資料(陣列)", "xml": { "name": "List`1" } }, "Count": { "type": "integer", "description": "資料總筆數", "format": "int64", "nullable": true } }, "additionalProperties": false, "xml": { "name": "LiteTrainBaseWrapperOfStationOfRoute", "namespace": "https://ptx.transportdata.tw/standard/schema/" } }, "PTX.Service.DTO.Rail.Specification.V3.LiteTrain.StationOfRoute.StationOfRoute": { "title": "StationOfRoute", "required": [ "Direction", "LineID", "LineNo", "RouteID", "RouteName", "Stations" ], "type": "object", "properties": { "LineNo": { "title": "String", "minLength": 1, "type": "string", "description": "營運路線所屬之路線編號", "xml": { "name": "LineNo" } }, "LineID": { "title": "String", "minLength": 1, "type": "string", "description": "營運路線所屬之路線代碼", "xml": { "name": "LineID" } }, "RouteID": { "title": "String", "minLength": 1, "type": "string", "description": "營運路線代碼", "xml": { "name": "RouteID" } }, "RouteName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "營運路線名稱", "xml": { "name": "NameType" } }, "Direction": { "title": "Int32", "type": "integer", "description": "營運路線方向描述(0:去程,1:返程)", "format": "int32" }, "Stations": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.LiteTrain.StationOfRoute.RouteStation" }, "description": "營運路線車站資訊", "xml": { "name": "Station" } } }, "additionalProperties": false, "description": "營運路線車站基本資料", "xml": { "name": "StationOfRoute" } }, "PTX.Service.DTO.Rail.Specification.V3.LiteTrain.StationOfRoute.RouteStation": { "title": "RouteStation", "required": [ "CumulativeDistance", "Sequence", "StationID", "StationName" ], "type": "object", "properties": { "Sequence": { "title": "Int32", "type": "integer", "description": "站序", "format": "int32" }, "StationID": { "title": "String", "minLength": 1, "type": "string", "description": "車站代碼", "xml": { "name": "StationID" } }, "StationName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "車站名稱", "xml": { "name": "NameType" } }, "CumulativeDistance": { "title": "Single", "type": "number", "description": "已累積之里程距離(公里)", "format": "float" } }, "additionalProperties": false, "description": "路線車站資訊", "xml": { "name": "RouteStation" } }, "PTX.API.Rail.Model.LiteTrain.LiteTrainRealTimeWrapper[PTX.Service.DTO.Rail.Specification.V3.TRA.TRANewsList.News]": { "title": "LiteTrainNewsList", "required": [ "AuthorityCode", "Items", "SrcUpdateInterval", "SrcUpdateTime", "UpdateInterval", "UpdateTime" ], "type": "object", "properties": { "UpdateTime": { "type": "string", "description": "本平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "UpdateInterval": { "title": "Int32", "type": "integer", "description": "本平台資料更新週期(秒)", "format": "int32" }, "SrcUpdateTime": { "title": "DateTime", "type": "string", "description": "來源端平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "SrcUpdateInterval": { "title": "Int32", "type": "integer", "description": "來源端平台資料更新週期(秒)['-1: 不定期更新']", "format": "int32" }, "AuthorityCode": { "title": "String", "minLength": 1, "type": "string", "description": "業管機關簡碼", "xml": { "name": "AuthorityCode" } }, "Items": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.TRA.TRANewsList.News" }, "description": "資料(陣列)", "xml": { "name": "List`1" } }, "Count": { "type": "integer", "description": "資料總筆數", "format": "int64", "nullable": true } }, "additionalProperties": false, "xml": { "name": "LiteTrainRealTimeWrapperOfNews", "namespace": "https://ptx.transportdata.tw/standard/schema/" } }, "PTX.API.Rail.Model.LiteTrain.LiteTrainBaseWrapper[PTX.Service.DTO.Rail.Specification.V3.LiteTrain.Shape]": { "title": "LiteTrainShapeList", "required": [ "AuthorityCode", "Items", "SrcUpdateInterval", "SrcUpdateTime", "UpdateInterval", "UpdateTime" ], "type": "object", "properties": { "UpdateTime": { "type": "string", "description": "本平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "UpdateInterval": { "title": "Int32", "type": "integer", "description": "本平台資料更新週期(秒)", "format": "int32" }, "SrcUpdateTime": { "title": "DateTime", "type": "string", "description": "來源端平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" }, "SrcUpdateInterval": { "title": "Int32", "type": "integer", "description": "來源端平台資料更新週期(秒)['-1: 不定期更新']", "format": "int32" }, "AuthorityCode": { "title": "String", "minLength": 1, "type": "string", "description": "業管機關簡碼", "xml": { "name": "AuthorityCode" } }, "Items": { "title": "Array", "type": "array", "items": { "$ref": "#/components/schemas/PTX.Service.DTO.Rail.Specification.V3.LiteTrain.Shape" }, "description": "資料(陣列)", "xml": { "name": "List`1" } }, "Count": { "type": "integer", "description": "資料總筆數", "format": "int64", "nullable": true } }, "additionalProperties": false, "xml": { "name": "LiteTrainBaseWrapperOfShape", "namespace": "https://ptx.transportdata.tw/standard/schema/" } }, "PTX.Service.DTO.Rail.Specification.V3.LiteTrain.Shape": { "title": "Shape", "required": [ "Geometry", "LineID", "LineName", "LineNo", "UpdateTime" ], "type": "object", "properties": { "LineNo": { "title": "String", "minLength": 1, "type": "string", "description": "路線編號", "xml": { "name": "LineNo" } }, "LineID": { "title": "String", "minLength": 1, "type": "string", "description": "路線代碼", "xml": { "name": "LineID" } }, "LineName": { "title": "NameType", "allOf": [ { "$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.NameType" } ], "description": "路線名稱", "xml": { "name": "NameType" } }, "Geometry": { "title": "String", "minLength": 1, "type": "string", "description": "well-known text,為路線軌跡資料", "xml": { "name": "Geometry" } }, "UpdateTime": { "title": "DateTime", "type": "string", "description": "資料更新日期時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)", "format": "date-time" } }, "additionalProperties": false, "description": "小火車線型資料", "xml": { "name": "Shape" } } }, "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": "TRA", "description": "臺鐵" }, { "name": "AFR", "description": "阿里山林業鐵路" } ] }