{
"openapi": "3.0.1",
"info": {
"title": "公共運輸-公車",
"description": "本平臺提供涵蓋全國尺度之交通旅運資料服務API,歡迎各產政學單位介接使用。\n
利用本平臺開放資料進行各項應用服務開發時,請考量不同特性使用者(如:性別/身心障礙/老幼等)的需求,並歡迎回饋寶貴意見。\n
計費方式:\n
計次:1,500次/1點\n
計量:150MB/1點\n---\n##### API使用說明與注意事項:\n1. 如您尚未註冊平臺會員帳號,或未以帳號登入,您將僅能以「訪客模式」使用平臺服務,包含:限以瀏覽器存取,限使用`【基礎服務】`,且限制每個呼叫來源端IP每日存取至多20次。。\n2. 如您已註冊平臺會員帳號,請務必確保在存取服務(包含瀏覽器、程式呼叫API)時帶入您的API金鑰,方能以「會員模式」使用完整平臺服務,包含平臺各類資料服務,如`【基礎服務】`、`【進階服務】`、`【加值服務】`、`【歷史服務】`、`【圖資服務】`、`【第三方服務】`等。\n3. 建議您立即[註冊平臺會員帳號](/register),依您用量需求訂閱服務方案,並於[【會員中心->資料服務->API金鑰】](/user/dataservice/key)取得API金鑰(即Client Id和Client Secret資訊)。\n4. 會員訂閱服務方案之級別不同,將決定其API金鑰之存取頻率有不同限制,各個方案的存取頻率限制說明請參考[訂閱收費](/pricing)。\n5. 以瀏覽器帶入API金鑰之操作方式:請點選Swagger UI上的Authorize按鈕,依指示填入Client Id和Client Secret資訊並進行驗證,驗證完成後可開始於Swagger UI使用API。\n6. 以程式呼叫API帶入API金鑰之操作方式:請參考[範例程式](https://github.com/tdxmotc/SampleCode)。\n7. 不論您是以瀏覽器或是以程式呼叫API,所有服務存取行為均將被記錄並定期檢視,以確保系統資源使用的合理分配與避免遭受濫用。\n\nAPI OAS文本 :[請點我](https://tdx.transportdata.tw/webapi/File/Swagger/V3/2998e851-81d0-40f5-b26d-77e2f5ac4118)",
"version": "v2"
},
"servers": [
{
"url": "https://tdx.transportdata.tw/api/basic"
}
],
"paths": {
"/v2/Bus/RealTimeByFrequency/Streaming/City/{City}": {
"get": {
"tags": [
"CityBus"
],
"summary": "取得指定[縣市]的公車動態定時資料(A1)[逐筆更新]",
"description": "### 市區公車之定時資料(A1) ###\n- [逐筆更新]與[批次更新]之差異請詳見運輸資料使用指引([連結](https://motc-ptx.gitbook.io/tdx-zi-liao-shi-yong-kui-hua-bao-dian/data_notice/public_transportation_data/bus_dynamic_data))",
"operationId": "CityBusApi_RealTimeByFrequency_UDP_2046",
"parameters": [
{
"name": "City",
"in": "path",
"description": "欲查詢縣市",
"required": true,
"schema": {
"title": "String",
"enum": [
"Hsinchu",
"HsinchuCounty",
"MiaoliCounty",
"ChanghuaCounty",
"NantouCounty",
"YunlinCounty",
"ChiayiCounty",
"Chiayi",
"PingtungCounty",
"YilanCounty",
"HualienCounty",
"TaitungCounty",
"PenghuCounty",
"Keelung"
],
"type": "string",
"xml": { }
}
},
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA1Data"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA1Data"
},
"xml": {
"name": "ArrayOfBusA1Data",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/RealTimeByFrequency/Streaming/City/{City}/{RouteName}": {
"get": {
"tags": [
"CityBus"
],
"summary": "取得指定[縣市],[路線名稱]的公車動態定時資料(A1)[逐筆更新]",
"description": "### 市區公車之定時資料(A1) ###\n- [逐筆更新]與[批次更新]之差異請詳見運輸資料使用指引([連結](https://motc-ptx.gitbook.io/tdx-zi-liao-shi-yong-kui-hua-bao-dian/data_notice/public_transportation_data/bus_dynamic_data))",
"operationId": "CityBusApi_RealTimeByFrequency_UDP_2046_1",
"parameters": [
{
"name": "City",
"in": "path",
"description": "欲查詢縣市",
"required": true,
"schema": {
"title": "String",
"enum": [
"Hsinchu",
"HsinchuCounty",
"MiaoliCounty",
"ChanghuaCounty",
"NantouCounty",
"YunlinCounty",
"ChiayiCounty",
"Chiayi",
"PingtungCounty",
"YilanCounty",
"HualienCounty",
"TaitungCounty",
"PenghuCounty",
"Keelung"
],
"type": "string",
"xml": { }
}
},
{
"name": "RouteName",
"in": "path",
"description": "繁體中文路線名稱,如'307'",
"required": true,
"schema": {
"title": "String",
"type": "string",
"xml": { }
}
},
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA1Data"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA1Data"
},
"xml": {
"name": "ArrayOfBusA1Data",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/RealTimeNearStop/Streaming/City/{City}": {
"get": {
"tags": [
"CityBus"
],
"summary": "取得指定[縣市]的公車動態定點資料(A2)[逐筆更新]",
"description": "### 市區公車之定點資料(A2) ###\n- [逐筆更新]與[批次更新]之差異請詳見運輸資料使用指引([連結](https://motc-ptx.gitbook.io/tdx-zi-liao-shi-yong-kui-hua-bao-dian/data_notice/public_transportation_data/bus_dynamic_data))",
"operationId": "CityBusApi_RealTimeNearStop_UDP_2047",
"parameters": [
{
"name": "City",
"in": "path",
"description": "欲查詢縣市",
"required": true,
"schema": {
"title": "String",
"enum": [
"Hsinchu",
"HsinchuCounty",
"MiaoliCounty",
"ChanghuaCounty",
"NantouCounty",
"YunlinCounty",
"ChiayiCounty",
"Chiayi",
"PingtungCounty",
"YilanCounty",
"HualienCounty",
"TaitungCounty",
"PenghuCounty",
"Keelung"
],
"type": "string",
"xml": { }
}
},
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA2Data"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA2Data"
},
"xml": {
"name": "ArrayOfBusA2Data",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/RealTimeNearStop/Streaming/City/{City}/{RouteName}": {
"get": {
"tags": [
"CityBus"
],
"summary": "取得指定[縣市],[路線名稱]的公車動態定點資料(A2)[逐筆更新]",
"description": "### 市區公車之定點資料(A2) ###\n- [逐筆更新]與[批次更新]之差異請詳見運輸資料使用指引([連結](https://motc-ptx.gitbook.io/tdx-zi-liao-shi-yong-kui-hua-bao-dian/data_notice/public_transportation_data/bus_dynamic_data))",
"operationId": "CityBusApi_RealTimeNearStop_UDP_2047_1",
"parameters": [
{
"name": "City",
"in": "path",
"description": "欲查詢縣市",
"required": true,
"schema": {
"title": "String",
"enum": [
"Hsinchu",
"HsinchuCounty",
"MiaoliCounty",
"ChanghuaCounty",
"NantouCounty",
"YunlinCounty",
"ChiayiCounty",
"Chiayi",
"PingtungCounty",
"YilanCounty",
"HualienCounty",
"TaitungCounty",
"PenghuCounty",
"Keelung"
],
"type": "string",
"xml": { }
}
},
{
"name": "RouteName",
"in": "path",
"description": "繁體中文路線名稱,如'307'",
"required": true,
"schema": {
"title": "String",
"type": "string",
"xml": { }
}
},
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA2Data"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA2Data"
},
"xml": {
"name": "ArrayOfBusA2Data",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/EstimatedTimeOfArrival/Streaming/City/{City}": {
"get": {
"tags": [
"CityBus"
],
"summary": "取得指定[縣市]的公車預估到站資料(N1)[逐筆更新]",
"description": "### 市區公車之預估到站資料(N1) ###\n- [部分縣市] 當 StopStatus = 1(尚未發車) 且 EstimateTime > 0 (有值) 的情形, 屬正常情形, 雖目前尚未發車, 但提供EstimateTime值為預計多久後開始發車之時間。\n- [逐筆更新]與[批次更新]之差異請詳見運輸資料使用指引([連結](https://motc-ptx.gitbook.io/tdx-zi-liao-shi-yong-kui-hua-bao-dian/data_notice/public_transportation_data/bus_dynamic_data))\n- N1僅於該路線上有任一車輛離站時,來源端才會重新計算並發佈,因此使用者需自行處理時間遞減機制,或以EstimateTime-(收到資料時間-SrcTrasTime)(秒)作為實際預估抵達時間。",
"operationId": "CityBusApi_EstimatedTimeOfArrival_UDP_2048",
"parameters": [
{
"name": "City",
"in": "path",
"description": "欲查詢縣市",
"required": true,
"schema": {
"title": "String",
"enum": [
"Hsinchu",
"HsinchuCounty",
"MiaoliCounty",
"ChanghuaCounty",
"NantouCounty",
"YunlinCounty",
"ChiayiCounty",
"Chiayi",
"PingtungCounty",
"YilanCounty",
"HualienCounty",
"TaitungCounty",
"PenghuCounty",
"Keelung"
],
"type": "string",
"xml": { }
}
},
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusN1EstimateTime"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusN1EstimateTime"
},
"xml": {
"name": "ArrayOfBusN1EstimateTime",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/EstimatedTimeOfArrival/Streaming/City/{City}/{RouteName}": {
"get": {
"tags": [
"CityBus"
],
"summary": "取得指定[縣市],[路線名稱]的公車預估到站資料(N1)[逐筆更新]",
"description": "### 市區公車之預估到站資料(N1) ###\n- [部分縣市] 當 StopStatus = 1(尚未發車) 且 EstimateTime > 0 (有值) 的情形, 屬正常情形, 雖目前尚未發車, 但提供EstimateTime值為預計多久後開始發車之時間。\n- [逐筆更新]與[批次更新]之差異請詳見運輸資料使用指引([連結](https://motc-ptx.gitbook.io/tdx-zi-liao-shi-yong-kui-hua-bao-dian/data_notice/public_transportation_data/bus_dynamic_data))\n- N1僅於該路線上有任一車輛離站時,來源端才會重新計算並發佈,因此使用者需自行處理時間遞減機制,或以EstimateTime-(收到資料時間-SrcTrasTime)(秒)作為實際預估抵達時間。",
"operationId": "CityBusApi_EstimatedTimeOfArrival_UDP_2048_1",
"parameters": [
{
"name": "City",
"in": "path",
"description": "欲查詢縣市",
"required": true,
"schema": {
"title": "String",
"enum": [
"Hsinchu",
"HsinchuCounty",
"MiaoliCounty",
"ChanghuaCounty",
"NantouCounty",
"YunlinCounty",
"ChiayiCounty",
"Chiayi",
"PingtungCounty",
"YilanCounty",
"HualienCounty",
"TaitungCounty",
"PenghuCounty",
"Keelung"
],
"type": "string",
"xml": { }
}
},
{
"name": "RouteName",
"in": "path",
"description": "繁體中文路線名稱,如'307'",
"required": true,
"schema": {
"title": "String",
"type": "string",
"xml": { }
}
},
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusN1EstimateTime"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusN1EstimateTime"
},
"xml": {
"name": "ArrayOfBusN1EstimateTime",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/RealTimeByFrequency/City/{City}": {
"get": {
"tags": [
"CityBus"
],
"summary": "取得指定[縣市]的公車動態定時資料(A1)[批次更新]",
"description": "### 市區公車之定時資料(A1) ###\n- [逐筆更新]與[批次更新]之差異請詳見運輸資料使用指引([連結](https://motc-ptx.gitbook.io/tdx-zi-liao-shi-yong-kui-hua-bao-dian/data_notice/public_transportation_data/bus_dynamic_data))",
"operationId": "CityBusApi_RealTimeByFrequency_2030",
"parameters": [
{
"name": "City",
"in": "path",
"description": "欲查詢縣市",
"required": true,
"schema": {
"title": "String",
"enum": [
"Taipei",
"NewTaipei",
"Taoyuan",
"Taichung",
"Tainan",
"Kaohsiung",
"Keelung",
"Hsinchu",
"HsinchuCounty",
"MiaoliCounty",
"ChanghuaCounty",
"NantouCounty",
"YunlinCounty",
"ChiayiCounty",
"Chiayi",
"PingtungCounty",
"YilanCounty",
"HualienCounty",
"TaitungCounty",
"KinmenCounty",
"PenghuCounty",
"LienchiangCounty"
],
"type": "string",
"xml": { }
}
},
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA1Data"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA1Data"
},
"xml": {
"name": "ArrayOfBusA1Data",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/RealTimeByFrequency/City/{City}/{RouteName}": {
"get": {
"tags": [
"CityBus"
],
"summary": "取得指定[縣市],[路線名稱]的公車動態定時資料(A1)[批次更新]",
"description": "### 市區公車之定時資料(A1) ###\n- [逐筆更新]與[批次更新]之差異請詳見運輸資料使用指引([連結](https://motc-ptx.gitbook.io/tdx-zi-liao-shi-yong-kui-hua-bao-dian/data_notice/public_transportation_data/bus_dynamic_data))",
"operationId": "CityBusApi_RealTimeByFrequency_2030_1",
"parameters": [
{
"name": "City",
"in": "path",
"description": "欲查詢縣市",
"required": true,
"schema": {
"title": "String",
"enum": [
"Taipei",
"NewTaipei",
"Taoyuan",
"Taichung",
"Tainan",
"Kaohsiung",
"Keelung",
"Hsinchu",
"HsinchuCounty",
"MiaoliCounty",
"ChanghuaCounty",
"NantouCounty",
"YunlinCounty",
"ChiayiCounty",
"Chiayi",
"PingtungCounty",
"YilanCounty",
"HualienCounty",
"TaitungCounty",
"KinmenCounty",
"PenghuCounty",
"LienchiangCounty"
],
"type": "string",
"xml": { }
}
},
{
"name": "RouteName",
"in": "path",
"description": "繁體中文路線名稱,如'307'",
"required": true,
"schema": {
"title": "String",
"type": "string",
"xml": { }
}
},
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA1Data"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA1Data"
},
"xml": {
"name": "ArrayOfBusA1Data",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/RealTimeNearStop/City/{City}": {
"get": {
"tags": [
"CityBus"
],
"summary": "取得指定[縣市]的公車動態定點資料(A2)[批次更新]",
"description": "### 市區公車之定點資料(A2) ###\n- [逐筆更新]與[批次更新]之差異請詳見運輸資料使用指引([連結](https://motc-ptx.gitbook.io/tdx-zi-liao-shi-yong-kui-hua-bao-dian/data_notice/public_transportation_data/bus_dynamic_data))",
"operationId": "CityBusApi_RealTimeNearStop_2031",
"parameters": [
{
"name": "City",
"in": "path",
"description": "欲查詢縣市",
"required": true,
"schema": {
"title": "String",
"enum": [
"Taipei",
"NewTaipei",
"Taoyuan",
"Taichung",
"Tainan",
"Kaohsiung",
"Keelung",
"Hsinchu",
"HsinchuCounty",
"MiaoliCounty",
"ChanghuaCounty",
"NantouCounty",
"YunlinCounty",
"ChiayiCounty",
"Chiayi",
"PingtungCounty",
"YilanCounty",
"HualienCounty",
"TaitungCounty",
"KinmenCounty",
"PenghuCounty",
"LienchiangCounty"
],
"type": "string",
"xml": { }
}
},
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA2Data"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA2Data"
},
"xml": {
"name": "ArrayOfBusA2Data",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/RealTimeNearStop/City/{City}/{RouteName}": {
"get": {
"tags": [
"CityBus"
],
"summary": "取得指定[縣市],[路線名稱]的公車動態定點資料(A2)[批次更新]",
"description": "### 市區公車之定點資料(A2) ###\n- [逐筆更新]與[批次更新]之差異請詳見運輸資料使用指引([連結](https://motc-ptx.gitbook.io/tdx-zi-liao-shi-yong-kui-hua-bao-dian/data_notice/public_transportation_data/bus_dynamic_data))",
"operationId": "CityBusApi_RealTimeNearStop_2031_1",
"parameters": [
{
"name": "City",
"in": "path",
"description": "欲查詢縣市",
"required": true,
"schema": {
"title": "String",
"enum": [
"Taipei",
"NewTaipei",
"Taoyuan",
"Taichung",
"Tainan",
"Kaohsiung",
"Keelung",
"Hsinchu",
"HsinchuCounty",
"MiaoliCounty",
"ChanghuaCounty",
"NantouCounty",
"YunlinCounty",
"ChiayiCounty",
"Chiayi",
"PingtungCounty",
"YilanCounty",
"HualienCounty",
"TaitungCounty",
"KinmenCounty",
"PenghuCounty",
"LienchiangCounty"
],
"type": "string",
"xml": { }
}
},
{
"name": "RouteName",
"in": "path",
"description": "繁體中文路線名稱,如'307'",
"required": true,
"schema": {
"title": "String",
"type": "string",
"xml": { }
}
},
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA2Data"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA2Data"
},
"xml": {
"name": "ArrayOfBusA2Data",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/EstimatedTimeOfArrival/City/{City}": {
"get": {
"tags": [
"CityBus"
],
"summary": "取得指定[縣市]的公車預估到站資料(N1)[批次更新]",
"description": " ### 市區公車之預估到站資料(N1) ###\n- [部分縣市] 當 StopStatus = 1(尚未發車) 且 EstimateTime > 0 (有值) 的情形, 屬正常情形, 雖目前尚未發車, 但提供EstimateTime值為預計多久後開始發車之時間。\n- [逐筆更新]與[批次更新]之差異請詳見運輸資料使用指引([連結](https://motc-ptx.gitbook.io/tdx-zi-liao-shi-yong-kui-hua-bao-dian/data_notice/public_transportation_data/bus_dynamic_data))",
"operationId": "CityBusApi_EstimatedTimeOfArrival_2032",
"parameters": [
{
"name": "City",
"in": "path",
"description": "欲查詢縣市",
"required": true,
"schema": {
"title": "String",
"enum": [
"Taipei",
"NewTaipei",
"Taoyuan",
"Taichung",
"Tainan",
"Kaohsiung",
"Keelung",
"Hsinchu",
"HsinchuCounty",
"MiaoliCounty",
"ChanghuaCounty",
"NantouCounty",
"YunlinCounty",
"ChiayiCounty",
"Chiayi",
"PingtungCounty",
"YilanCounty",
"HualienCounty",
"TaitungCounty",
"KinmenCounty",
"PenghuCounty",
"LienchiangCounty"
],
"type": "string",
"xml": { }
}
},
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusN1EstimateTime"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusN1EstimateTime"
},
"xml": {
"name": "ArrayOfBusN1EstimateTime",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/EstimatedTimeOfArrival/City/{City}/{RouteName}": {
"get": {
"tags": [
"CityBus"
],
"summary": "取得指定[縣市],[路線名稱]的公車預估到站資料(N1)[批次更新]",
"description": " ### 市區公車之預估到站資料(N1) ###\n- [部分縣市] 當 StopStatus = 1(尚未發車) 且 EstimateTime > 0 (有值) 的情形, 屬正常情形, 雖目前尚未發車, 但提供EstimateTime值為預計多久後開始發車之時間。\n- [逐筆更新]與[批次更新]之差異請詳見運輸資料使用指引([連結](https://motc-ptx.gitbook.io/tdx-zi-liao-shi-yong-kui-hua-bao-dian/data_notice/public_transportation_data/bus_dynamic_data))",
"operationId": "CityBusApi_EstimatedTimeOfArrival_2032_1",
"parameters": [
{
"name": "City",
"in": "path",
"description": "欲查詢縣市",
"required": true,
"schema": {
"title": "String",
"enum": [
"Taipei",
"NewTaipei",
"Taoyuan",
"Taichung",
"Tainan",
"Kaohsiung",
"Keelung",
"Hsinchu",
"HsinchuCounty",
"MiaoliCounty",
"ChanghuaCounty",
"NantouCounty",
"YunlinCounty",
"ChiayiCounty",
"Chiayi",
"PingtungCounty",
"YilanCounty",
"HualienCounty",
"TaitungCounty",
"KinmenCounty",
"PenghuCounty",
"LienchiangCounty"
],
"type": "string",
"xml": { }
}
},
{
"name": "RouteName",
"in": "path",
"description": "繁體中文路線名稱,如'307'",
"required": true,
"schema": {
"title": "String",
"type": "string",
"xml": { }
}
},
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusN1EstimateTime"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusN1EstimateTime"
},
"xml": {
"name": "ArrayOfBusN1EstimateTime",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/DataVersion/City/{City}": {
"get": {
"tags": [
"CityBus"
],
"summary": "取得指定[縣市]目前資料的最新版本資訊",
"description": "版本詳細資訊",
"operationId": "CityBusApi_DataVersion_2033",
"parameters": [
{
"name": "City",
"in": "path",
"description": "欲查詢縣市",
"required": true,
"schema": {
"title": "String",
"enum": [
"Taipei",
"NewTaipei",
"Taoyuan",
"Taichung",
"Tainan",
"Kaohsiung",
"Keelung",
"Hsinchu",
"HsinchuCounty",
"MiaoliCounty",
"ChanghuaCounty",
"NantouCounty",
"YunlinCounty",
"ChiayiCounty",
"Chiayi",
"PingtungCounty",
"YilanCounty",
"HualienCounty",
"TaitungCounty",
"KinmenCounty",
"PenghuCounty",
"LienchiangCounty"
],
"type": "string",
"xml": { }
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusVersion"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusVersion"
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/Operator/City/{City}": {
"get": {
"tags": [
"CityBus"
],
"summary": "取得指定[縣市]的市區公車營運業者資料",
"description": "市區公車之營運業者資料",
"operationId": "CityBusApi_Operator_2034",
"parameters": [
{
"name": "City",
"in": "path",
"description": "欲查詢縣市",
"required": true,
"schema": {
"title": "String",
"enum": [
"Taipei",
"NewTaipei",
"Taoyuan",
"Taichung",
"Tainan",
"Kaohsiung",
"Keelung",
"Hsinchu",
"HsinchuCounty",
"MiaoliCounty",
"ChanghuaCounty",
"NantouCounty",
"YunlinCounty",
"ChiayiCounty",
"Chiayi",
"PingtungCounty",
"YilanCounty",
"HualienCounty",
"TaitungCounty",
"KinmenCounty",
"PenghuCounty",
"LienchiangCounty"
],
"type": "string",
"xml": { }
}
},
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.Operator"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.Operator"
},
"xml": {
"name": "ArrayOfOperator",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/Route/City/{City}": {
"get": {
"tags": [
"CityBus"
],
"summary": "取得指定[縣市]的市區公車路線資料",
"description": "市區公車之路線資料",
"operationId": "CityBusApi_Route_2035",
"parameters": [
{
"name": "City",
"in": "path",
"description": "欲查詢縣市",
"required": true,
"schema": {
"title": "String",
"enum": [
"Taipei",
"NewTaipei",
"Taoyuan",
"Taichung",
"Tainan",
"Kaohsiung",
"Keelung",
"Hsinchu",
"HsinchuCounty",
"MiaoliCounty",
"ChanghuaCounty",
"NantouCounty",
"YunlinCounty",
"ChiayiCounty",
"Chiayi",
"PingtungCounty",
"YilanCounty",
"HualienCounty",
"TaitungCounty",
"KinmenCounty",
"PenghuCounty",
"LienchiangCounty"
],
"type": "string",
"xml": { }
}
},
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRoute"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRoute"
},
"xml": {
"name": "ArrayOfBusRoute",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/Route/City/{City}/{RouteName}": {
"get": {
"tags": [
"CityBus"
],
"summary": "取得指定[縣市],[路線名稱]的路線資料",
"description": "市區公車之路線資料",
"operationId": "CityBusApi_Route_2035_1",
"parameters": [
{
"name": "City",
"in": "path",
"description": "欲查詢縣市",
"required": true,
"schema": {
"title": "String",
"enum": [
"Taipei",
"NewTaipei",
"Taoyuan",
"Taichung",
"Tainan",
"Kaohsiung",
"Keelung",
"Hsinchu",
"HsinchuCounty",
"MiaoliCounty",
"ChanghuaCounty",
"NantouCounty",
"YunlinCounty",
"ChiayiCounty",
"Chiayi",
"PingtungCounty",
"YilanCounty",
"HualienCounty",
"TaitungCounty",
"KinmenCounty",
"PenghuCounty",
"LienchiangCounty"
],
"type": "string",
"xml": { }
}
},
{
"name": "RouteName",
"in": "path",
"description": "繁體中文路線名稱,如'307'",
"required": true,
"schema": {
"title": "String",
"type": "string",
"xml": { }
}
},
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRoute"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRoute"
},
"xml": {
"name": "ArrayOfBusRoute",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/Stop/City/{City}": {
"get": {
"tags": [
"CityBus"
],
"summary": "取得指定[縣市]的市區公車站牌資料",
"description": "市區公車之站牌資料",
"operationId": "CityBusApi_Stop_2036",
"parameters": [
{
"name": "City",
"in": "path",
"description": "欲查詢縣市",
"required": true,
"schema": {
"title": "String",
"enum": [
"NewTaipei",
"Taoyuan",
"Taichung",
"Tainan",
"Kaohsiung",
"Keelung",
"Hsinchu",
"HsinchuCounty",
"MiaoliCounty",
"ChanghuaCounty",
"NantouCounty",
"YunlinCounty",
"ChiayiCounty",
"Chiayi",
"PingtungCounty",
"YilanCounty",
"HualienCounty",
"TaitungCounty",
"KinmenCounty",
"PenghuCounty",
"LienchiangCounty",
"Taipei"
],
"type": "string",
"xml": { }
}
},
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusStop"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusStop"
},
"xml": {
"name": "ArrayOfBusStop",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/Station/City/{City}": {
"get": {
"tags": [
"CityBus"
],
"summary": "取得指定[縣市]的市區公車站位資料",
"description": "市區公車之各站牌所屬的站位資料",
"operationId": "CityBusApi_Station_2037",
"parameters": [
{
"name": "City",
"in": "path",
"description": "欲查詢縣市",
"required": true,
"schema": {
"title": "String",
"enum": [
"Taipei",
"NewTaipei",
"Kaohsiung",
"Hsinchu",
"HsinchuCounty",
"MiaoliCounty",
"ChanghuaCounty",
"NantouCounty",
"YunlinCounty",
"ChiayiCounty",
"Chiayi",
"PingtungCounty",
"YilanCounty",
"HualienCounty",
"TaitungCounty",
"PenghuCounty",
"Tainan",
"KinmenCounty",
"Taoyuan",
"Taichung",
"Keelung"
],
"type": "string",
"xml": { }
}
},
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusStation"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusStation"
},
"xml": {
"name": "ArrayOfBusStation",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/DisplayStopOfRoute/City/{City}": {
"get": {
"tags": [
"CityBus"
],
"summary": "取得指定[縣市]的市區公車顯示用路線站序資料",
"description": "市區公車之顯示用路線站序資料",
"operationId": "CityBusApi_DisplayStopOfRoute_2038",
"parameters": [
{
"name": "City",
"in": "path",
"description": "欲查詢縣市",
"required": true,
"schema": {
"title": "String",
"enum": [
"Taipei",
"Tainan",
"NewTaipei",
"Taoyuan",
"Taichung"
],
"type": "string",
"xml": { }
}
},
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusDisplayStopOfRoute"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusDisplayStopOfRoute"
},
"xml": {
"name": "ArrayOfBusDisplayStopOfRoute",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/DisplayStopOfRoute/City/{City}/{RouteName}": {
"get": {
"tags": [
"CityBus"
],
"summary": "取得指定[縣市],[路線名稱]的市區公車顯示用路線站序資料",
"description": "市區公車之顯示用路線站序資料",
"operationId": "CityBusApi_DisplayStopOfRoute_2038_1",
"parameters": [
{
"name": "City",
"in": "path",
"description": "欲查詢縣市",
"required": true,
"schema": {
"title": "String",
"enum": [
"Taipei",
"Tainan",
"NewTaipei",
"Taoyuan",
"Taichung"
],
"type": "string",
"xml": { }
}
},
{
"name": "RouteName",
"in": "path",
"description": "繁體中文路線名稱,如'307'",
"required": true,
"schema": {
"title": "String",
"type": "string",
"xml": { }
}
},
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusDisplayStopOfRoute"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusDisplayStopOfRoute"
},
"xml": {
"name": "ArrayOfBusDisplayStopOfRoute",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/StopOfRoute/City/{City}": {
"get": {
"tags": [
"CityBus"
],
"summary": "取得指定[縣市]的市區公車路線站序資料",
"description": "市區公車之路線站序資料",
"operationId": "CityBusApi_StopOfRoute_2039",
"parameters": [
{
"name": "City",
"in": "path",
"description": "欲查詢縣市",
"required": true,
"schema": {
"title": "String",
"enum": [
"Taipei",
"NewTaipei",
"Taoyuan",
"Taichung",
"Tainan",
"Kaohsiung",
"Keelung",
"Hsinchu",
"HsinchuCounty",
"MiaoliCounty",
"ChanghuaCounty",
"NantouCounty",
"YunlinCounty",
"ChiayiCounty",
"Chiayi",
"PingtungCounty",
"YilanCounty",
"HualienCounty",
"TaitungCounty",
"KinmenCounty",
"PenghuCounty",
"LienchiangCounty"
],
"type": "string",
"xml": { }
}
},
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusStopOfRoute"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusStopOfRoute"
},
"xml": {
"name": "ArrayOfBusStopOfRoute",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/StopOfRoute/City/{City}/{RouteName}": {
"get": {
"tags": [
"CityBus"
],
"summary": "取得指定[縣市],[路線名稱]的市區公車路線站序資料",
"description": "市區公車之路線站序資料",
"operationId": "CityBusApi_StopOfRoute_2039_1",
"parameters": [
{
"name": "City",
"in": "path",
"description": "欲查詢縣市",
"required": true,
"schema": {
"title": "String",
"enum": [
"Taipei",
"NewTaipei",
"Taoyuan",
"Taichung",
"Tainan",
"Kaohsiung",
"Keelung",
"Hsinchu",
"HsinchuCounty",
"MiaoliCounty",
"ChanghuaCounty",
"NantouCounty",
"YunlinCounty",
"ChiayiCounty",
"Chiayi",
"PingtungCounty",
"YilanCounty",
"HualienCounty",
"TaitungCounty",
"KinmenCounty",
"PenghuCounty",
"LienchiangCounty"
],
"type": "string",
"xml": { }
}
},
{
"name": "RouteName",
"in": "path",
"description": "繁體中文路線名稱,如'307'",
"required": true,
"schema": {
"title": "String",
"type": "string",
"xml": { }
}
},
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusStopOfRoute"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusStopOfRoute"
},
"xml": {
"name": "ArrayOfBusStopOfRoute",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/Schedule/City/{City}": {
"get": {
"tags": [
"CityBus"
],
"summary": "取得指定[縣市]的市區公車路線班表資料",
"description": "市區公車之班表及班距資料。一般市區公車班次較多時會採用【班距】式時刻表;班次較少時會採用【班表】式時刻表",
"operationId": "CityBusApi_Schedule_2040",
"parameters": [
{
"name": "City",
"in": "path",
"description": "欲查詢縣市",
"required": true,
"schema": {
"title": "String",
"enum": [
"Taipei",
"NewTaipei",
"Tainan",
"Keelung",
"Hsinchu",
"HsinchuCounty",
"MiaoliCounty",
"ChanghuaCounty",
"NantouCounty",
"YunlinCounty",
"ChiayiCounty",
"Chiayi",
"PingtungCounty",
"YilanCounty",
"HualienCounty",
"TaitungCounty",
"KinmenCounty",
"PenghuCounty",
"Taoyuan",
"Taichung",
"Kaohsiung",
"LienchiangCounty"
],
"type": "string",
"xml": { }
}
},
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusSchedule"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusSchedule"
},
"xml": {
"name": "ArrayOfBusSchedule",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/Schedule/City/{City}/{RouteName}": {
"get": {
"tags": [
"CityBus"
],
"summary": "取得指定[縣市],[路線名稱]的市區公車路線班表資料",
"description": "市區公車之預定班表及班距資料。一般市區公車班次較多時會採用【班距】式時刻表;班次較少時會採用【班表】式時刻表",
"operationId": "CityBusApi_Schedule_2040_1",
"parameters": [
{
"name": "City",
"in": "path",
"description": "欲查詢縣市",
"required": true,
"schema": {
"title": "String",
"enum": [
"Taipei",
"NewTaipei",
"Tainan",
"Keelung",
"Hsinchu",
"HsinchuCounty",
"MiaoliCounty",
"ChanghuaCounty",
"NantouCounty",
"YunlinCounty",
"ChiayiCounty",
"Chiayi",
"PingtungCounty",
"YilanCounty",
"HualienCounty",
"TaitungCounty",
"KinmenCounty",
"PenghuCounty",
"Taoyuan",
"Taichung",
"Kaohsiung",
"LienchiangCounty"
],
"type": "string",
"xml": { }
}
},
{
"name": "RouteName",
"in": "path",
"description": "繁體中文路線名稱,如'307'",
"required": true,
"schema": {
"title": "String",
"type": "string",
"xml": { }
}
},
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusSchedule"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusSchedule"
},
"xml": {
"name": "ArrayOfBusSchedule",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/Vehicle/City/{City}": {
"get": {
"tags": [
"CityBus"
],
"summary": "取得指定[縣市]的市區公車車輛資料",
"description": "市區公車之車輛資料",
"operationId": "CityBusApi_Vehicle_2041",
"parameters": [
{
"name": "City",
"in": "path",
"description": "欲查詢縣市",
"required": true,
"schema": {
"title": "String",
"enum": [
"Taipei",
"NewTaipei",
"Taoyuan",
"Taichung",
"Tainan",
"Kaohsiung"
],
"type": "string",
"xml": { }
}
},
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusVehicleInfo"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusVehicleInfo"
},
"xml": {
"name": "ArrayOfBusVehicleInfo",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/Shape/City/{City}": {
"get": {
"tags": [
"CityBus"
],
"summary": "取得指定[縣市]的市區公車線型資料",
"description": "市區公車之線型資料",
"operationId": "CityBusApi_Shape_2042",
"parameters": [
{
"name": "City",
"in": "path",
"description": "欲查詢縣市",
"required": true,
"schema": {
"title": "String",
"enum": [
"Taipei",
"NewTaipei",
"Taoyuan",
"Taichung",
"Tainan",
"Kaohsiung",
"Keelung",
"KinmenCounty",
"Hsinchu",
"HsinchuCounty",
"MiaoliCounty",
"ChanghuaCounty",
"NantouCounty",
"YunlinCounty",
"ChiayiCounty",
"Chiayi",
"PingtungCounty",
"YilanCounty",
"HualienCounty",
"TaitungCounty",
"PenghuCounty",
"LienchiangCounty"
],
"type": "string",
"xml": { }
}
},
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusShape"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusShape"
},
"xml": {
"name": "ArrayOfBusShape",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/Shape/City/{City}/{RouteName}": {
"get": {
"tags": [
"CityBus"
],
"summary": "取得指定[縣市],[路線名稱]的市區公車線型資料",
"description": "市區公車之線型資料",
"operationId": "CityBusApi_Shape_2042_1",
"parameters": [
{
"name": "City",
"in": "path",
"description": "欲查詢縣市",
"required": true,
"schema": {
"title": "String",
"enum": [
"Taipei",
"NewTaipei",
"Taoyuan",
"Taichung",
"Tainan",
"Kaohsiung",
"Keelung",
"KinmenCounty",
"Hsinchu",
"HsinchuCounty",
"MiaoliCounty",
"ChanghuaCounty",
"NantouCounty",
"YunlinCounty",
"ChiayiCounty",
"Chiayi",
"PingtungCounty",
"YilanCounty",
"HualienCounty",
"TaitungCounty",
"PenghuCounty",
"LienchiangCounty"
],
"type": "string",
"xml": { }
}
},
{
"name": "RouteName",
"in": "path",
"description": "繁體中文路線名稱,如'307'",
"required": true,
"schema": {
"title": "String",
"type": "string",
"xml": { }
}
},
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusShape"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusShape"
},
"xml": {
"name": "ArrayOfBusShape",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/RouteFare/City/{City}": {
"get": {
"tags": [
"CityBus"
],
"summary": "取得指定[縣市]的市區公車路線票價資料",
"description": "市區公車路線票價資料",
"operationId": "CityBusApi_RouteFare_2043",
"parameters": [
{
"name": "City",
"in": "path",
"description": "欲查詢縣市",
"required": true,
"schema": {
"title": "String",
"enum": [
"Taipei",
"NewTaipei",
"Taoyuan",
"Taichung",
"Kaohsiung",
"Hsinchu",
"HsinchuCounty",
"MiaoliCounty",
"ChanghuaCounty",
"NantouCounty",
"YunlinCounty",
"ChiayiCounty",
"Chiayi",
"PingtungCounty",
"YilanCounty",
"HualienCounty",
"TaitungCounty",
"KinmenCounty",
"PenghuCounty"
],
"type": "string",
"xml": { }
}
},
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRouteFare"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRouteFare"
},
"xml": {
"name": "ArrayOfBusRouteFare",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/RouteFare/City/{City}/{RouteName}": {
"get": {
"tags": [
"CityBus"
],
"summary": "取得指定[縣市],[路線名稱]的的市區公車路線票價資料",
"description": "市區公車路線票價資料",
"operationId": "CityBusApi_RouteFare_2043_1",
"parameters": [
{
"name": "City",
"in": "path",
"description": "欲查詢縣市",
"required": true,
"schema": {
"title": "String",
"enum": [
"Taipei",
"NewTaipei",
"Taoyuan",
"Taichung",
"Kaohsiung",
"Hsinchu",
"HsinchuCounty",
"MiaoliCounty",
"ChanghuaCounty",
"NantouCounty",
"YunlinCounty",
"ChiayiCounty",
"Chiayi",
"PingtungCounty",
"YilanCounty",
"HualienCounty",
"TaitungCounty",
"KinmenCounty",
"PenghuCounty"
],
"type": "string",
"xml": { }
}
},
{
"name": "RouteName",
"in": "path",
"description": "繁體中文路線名稱,如'307'",
"required": true,
"schema": {
"title": "String",
"type": "string",
"xml": { }
}
},
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRouteFare"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRouteFare"
},
"xml": {
"name": "ArrayOfBusRouteFare",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/News/City/{City}": {
"get": {
"tags": [
"CityBus"
],
"summary": "取得指定[縣市]的市區公車最新消息資料",
"description": "市區公車最新消息資料",
"operationId": "CityBusApi_News_2044",
"parameters": [
{
"name": "City",
"in": "path",
"description": "欲查詢縣市",
"required": true,
"schema": {
"title": "String",
"enum": [
"Keelung",
"Tainan",
"KinmenCounty",
"Hsinchu",
"HsinchuCounty",
"MiaoliCounty",
"ChanghuaCounty",
"NantouCounty",
"YunlinCounty",
"ChiayiCounty",
"Chiayi",
"PingtungCounty",
"YilanCounty",
"HualienCounty",
"TaitungCounty",
"PenghuCounty",
"Taichung",
"Kaohsiung",
"Taipei",
"NewTaipei",
"Taoyuan"
],
"type": "string",
"xml": { }
}
},
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusNews"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusNews"
},
"xml": {
"name": "ArrayOfBusNews",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/StationGroup/City/{City}": {
"get": {
"tags": [
"CityBus"
],
"summary": "取得指定[縣市]的市區公車組站位資料",
"description": "市區公車之各站牌所屬的組站位資料",
"operationId": "CityBusApi_StationGroup_2050",
"parameters": [
{
"name": "City",
"in": "path",
"description": "欲查詢縣市",
"required": true,
"schema": {
"title": "String",
"enum": [
"Hsinchu",
"HsinchuCounty",
"MiaoliCounty",
"ChanghuaCounty",
"NantouCounty",
"YunlinCounty",
"ChiayiCounty",
"Chiayi",
"PingtungCounty",
"YilanCounty",
"HualienCounty",
"TaitungCounty",
"PenghuCounty",
"Keelung"
],
"type": "string",
"xml": { }
}
},
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusStationGroup"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusStationGroup"
},
"xml": {
"name": "ArrayOfBusStationGroup",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/FirstLastTripInfo/City/{City}": {
"get": {
"tags": [
"CityBus"
],
"summary": "取得指定[縣市]的市區公車路線首末班車資料",
"description": "市區公車之路線首末班車資料",
"operationId": "CityBusApi_FirstLastTripInfo_2052",
"parameters": [
{
"name": "City",
"in": "path",
"description": "欲查詢縣市",
"required": true,
"schema": {
"title": "String",
"enum": [
"KinmenCounty",
"Taichung",
"Taoyuan",
"Keelung",
"Hsinchu",
"HsinchuCounty",
"MiaoliCounty",
"ChanghuaCounty",
"NantouCounty",
"YunlinCounty",
"ChiayiCounty",
"Chiayi",
"PingtungCounty",
"YilanCounty",
"HualienCounty",
"TaitungCounty",
"PenghuCounty",
"Kaohsiung"
],
"type": "string",
"xml": { }
}
},
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusFirstLastTripInfo"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusFirstLastTripInfo"
},
"xml": {
"name": "ArrayOfBusFirstLastTripInfo",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/FirstLastTripInfo/City/{City}/{RouteName}": {
"get": {
"tags": [
"CityBus"
],
"summary": "取得指定[縣市],[路線名稱]的路線首末班車資料",
"description": "市區公車之路線首末班車資料",
"operationId": "CityBusApi_FirstLastTripInfo_2052_1",
"parameters": [
{
"name": "City",
"in": "path",
"description": "欲查詢縣市",
"required": true,
"schema": {
"title": "String",
"enum": [
"KinmenCounty",
"Taichung",
"Taoyuan",
"Keelung",
"Hsinchu",
"HsinchuCounty",
"MiaoliCounty",
"ChanghuaCounty",
"NantouCounty",
"YunlinCounty",
"ChiayiCounty",
"Chiayi",
"PingtungCounty",
"YilanCounty",
"HualienCounty",
"TaitungCounty",
"PenghuCounty",
"Kaohsiung"
],
"type": "string",
"xml": { }
}
},
{
"name": "RouteName",
"in": "path",
"description": "繁體中文路線名稱,如'307'",
"required": true,
"schema": {
"title": "String",
"type": "string",
"xml": { }
}
},
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusFirstLastTripInfo"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusFirstLastTripInfo"
},
"xml": {
"name": "ArrayOfBusFirstLastTripInfo",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/Alert/City/{City}": {
"get": {
"tags": [
"CityBus"
],
"summary": "取得指定[縣市]的市區公車營運通阻資料",
"description": "市區公車營運通阻資料",
"operationId": "CityBusApi_Alert_2053",
"parameters": [
{
"name": "City",
"in": "path",
"description": "欲查詢縣市",
"required": true,
"schema": {
"title": "String",
"enum": [
"Hsinchu",
"HsinchuCounty",
"MiaoliCounty",
"ChanghuaCounty",
"NantouCounty",
"YunlinCounty",
"ChiayiCounty",
"Chiayi",
"PingtungCounty",
"YilanCounty",
"HualienCounty",
"TaitungCounty",
"PenghuCounty",
"Taichung",
"Kaohsiung",
"Taoyuan",
"Taipei",
"NewTaipei",
"Keelung"
],
"type": "string",
"xml": { }
}
},
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusAlert"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusAlert"
},
"xml": {
"name": "ArrayOfBusAlert",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/RouteNetwork/City/{City}": {
"get": {
"tags": [
"CityBus"
],
"summary": "取得指定[縣市]的市區公車路線網路拓撲資料",
"description": "市區公車路線網路拓撲資料",
"operationId": "CityBusApi_RouteNetwork_2055",
"parameters": [
{
"name": "City",
"in": "path",
"description": "欲查詢縣市",
"required": true,
"schema": {
"title": "String",
"enum": [
"Taoyuan"
],
"type": "string",
"xml": { }
}
},
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRouteNetwork"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRouteNetwork"
},
"xml": {
"name": "ArrayOfBusRouteNetwork",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/RouteNetwork/City/{City}/{RouteName}": {
"get": {
"tags": [
"CityBus"
],
"summary": "取得指定[縣市],[路線名稱]的市區公車顯示用路線站序資料",
"description": "市區公車之顯示用路線站序資料",
"operationId": "CityBusApi_RouteNetwork_2055_1",
"parameters": [
{
"name": "City",
"in": "path",
"description": "欲查詢縣市",
"required": true,
"schema": {
"title": "String",
"enum": [
"Taoyuan"
],
"type": "string",
"xml": { }
}
},
{
"name": "RouteName",
"in": "path",
"description": "繁體中文路線名稱,如'307'",
"required": true,
"schema": {
"title": "String",
"type": "string",
"xml": { }
}
},
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRouteNetwork"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRouteNetwork"
},
"xml": {
"name": "ArrayOfBusRouteNetwork",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/S2STravelTime/City/{City}/{RouteID}": {
"get": {
"tags": [
"CityBus"
],
"summary": "取得指定[縣市],[路線代碼]的市區公車站間旅行時間資料",
"description": "指定[縣市],[路線代碼]的市區公車站間旅行時間資料",
"operationId": "CityBusApi_S2STravelTimeDetail_2056",
"parameters": [
{
"name": "City",
"in": "path",
"description": "欲查詢縣市",
"required": true,
"schema": {
"title": "String",
"enum": [
"Taipei",
"Taoyuan",
"Taichung",
"Keelung",
"Hsinchu",
"HsinchuCounty",
"MiaoliCounty",
"ChanghuaCounty",
"NantouCounty",
"YunlinCounty",
"ChiayiCounty",
"Chiayi",
"PingtungCounty",
"YilanCounty",
"HualienCounty",
"TaitungCounty",
"PenghuCounty"
],
"type": "string",
"xml": { }
}
},
{
"name": "RouteID",
"in": "path",
"description": "路線代碼",
"required": true,
"schema": {
"title": "String",
"type": "string",
"xml": { }
}
},
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusS2STravelTime"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusS2STravelTime"
},
"xml": {
"name": "ArrayOfBusS2STravelTime",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/RealTimeByFrequency/Streaming/InterCity": {
"get": {
"tags": [
"InterCityBus"
],
"summary": "取得公路客運的動態定時資料(A1)[逐筆更新]",
"description": "### 公路客運之定時資料(A1) ###\n- [逐筆更新]與[批次更新]之差異請詳見運輸資料使用指引([連結](https://motc-ptx.gitbook.io/tdx-zi-liao-shi-yong-kui-hua-bao-dian/data_notice/public_transportation_data/bus_dynamic_data))",
"operationId": "InterCityBusApi_RealTimeByFrequency_UDP_2057",
"parameters": [
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA1Data"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA1Data"
},
"xml": {
"name": "ArrayOfBusA1Data",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/RealTimeByFrequency/Streaming/InterCity/{RouteName}": {
"get": {
"tags": [
"InterCityBus"
],
"summary": "取得指定[路線名稱]的公路客運動態定時資料(A1)[逐筆更新]",
"description": "### 公路客運之定時資料(A1) ###\n- [逐筆更新]與[批次更新]之差異請詳見運輸資料使用指引([連結](https://motc-ptx.gitbook.io/tdx-zi-liao-shi-yong-kui-hua-bao-dian/data_notice/public_transportation_data/bus_dynamic_data))",
"operationId": "InterCityBusApi_RealTimeByFrequency_UDP_2057_1",
"parameters": [
{
"name": "RouteName",
"in": "path",
"description": "繁體中文路線名稱,如'9001'",
"required": true,
"schema": {
"title": "String",
"type": "string",
"xml": { }
}
},
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA1Data"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA1Data"
},
"xml": {
"name": "ArrayOfBusA1Data",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/RealTimeNearStop/Streaming/InterCity": {
"get": {
"tags": [
"InterCityBus"
],
"summary": "取得公路客運的動態定點資料(A2)[逐筆更新]",
"description": "### 公路客運之定點資料(A2) ###\n- [逐筆更新]與[批次更新]之差異請詳見運輸資料使用指引([連結](https://motc-ptx.gitbook.io/tdx-zi-liao-shi-yong-kui-hua-bao-dian/data_notice/public_transportation_data/bus_dynamic_data))",
"operationId": "InterCityBusApi_RealTimeNearStop_UDP_2058",
"parameters": [
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA2Data"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA2Data"
},
"xml": {
"name": "ArrayOfBusA2Data",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/RealTimeNearStop/Streaming/InterCity/{RouteName}": {
"get": {
"tags": [
"InterCityBus"
],
"summary": "取得指定[路線名稱]的公路客運動態定點資料(A2)[逐筆更新]",
"description": "### 公路客運之定點資料(A2) ###\n- [逐筆更新]與[批次更新]之差異請詳見運輸資料使用指引([連結](https://motc-ptx.gitbook.io/tdx-zi-liao-shi-yong-kui-hua-bao-dian/data_notice/public_transportation_data/bus_dynamic_data))",
"operationId": "InterCityBusApi_RealTimeNearStop_UDP_2058_1",
"parameters": [
{
"name": "RouteName",
"in": "path",
"description": "繁體中文路線名稱,如'9001'",
"required": true,
"schema": {
"title": "String",
"type": "string",
"xml": { }
}
},
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA2Data"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA2Data"
},
"xml": {
"name": "ArrayOfBusA2Data",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/EstimatedTimeOfArrival/Streaming/InterCity": {
"get": {
"tags": [
"InterCityBus"
],
"summary": "取得公路客運的預估到站資料(N1)[逐筆更新]",
"description": "### 公路客運之預估到站資料(N1) ###\n- 不保留[現在時間]超過[本平台資料更新時間]兩分鐘的資料\n- [逐筆更新]與[批次更新]之差異請詳見運輸資料使用指引([連結](https://motc-ptx.gitbook.io/tdx-zi-liao-shi-yong-kui-hua-bao-dian/data_notice/public_transportation_data/bus_dynamic_data))\n- N1僅於該路線上有任一車輛離站時,來源端才會重新計算並發佈,因此使用者需自行處理時間遞減機制,或以EstimateTime-(收到資料時間-SrcTrasTime)(秒)作為實際預估抵達時間。",
"operationId": "InterCityBusApi_EstimatedTimeOfArrival_UDP_2059",
"parameters": [
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusN1EstimateTime"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusN1EstimateTime"
},
"xml": {
"name": "ArrayOfBusN1EstimateTime",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/EstimatedTimeOfArrival/Streaming/InterCity/{RouteName}": {
"get": {
"tags": [
"InterCityBus"
],
"summary": "取得指定[路線名稱]的公路客運預估到站資料(N1)[逐筆更新]",
"description": "### 公路客運之預估到站資料(N1) ###\n- 不保留[現在時間]超過[本平台資料更新時間]兩分鐘的資料\n- [逐筆更新]與[批次更新]之差異請詳見運輸資料使用指引([連結](https://motc-ptx.gitbook.io/tdx-zi-liao-shi-yong-kui-hua-bao-dian/data_notice/public_transportation_data/bus_dynamic_data))\n- N1僅於該路線上有任一車輛離站時,來源端才會重新計算並發佈,因此使用者需自行處理時間遞減機制,或以EstimateTime-(收到資料時間-SrcTrasTime)(秒)作為實際預估抵達時間。",
"operationId": "InterCityBusApi_EstimatedTimeOfArrival_UDP_2059_1",
"parameters": [
{
"name": "RouteName",
"in": "path",
"description": "繁體中文路線名稱,如'9001'",
"required": true,
"schema": {
"title": "String",
"type": "string",
"xml": { }
}
},
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusN1EstimateTime"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusN1EstimateTime"
},
"xml": {
"name": "ArrayOfBusN1EstimateTime",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/RealTimeByFrequency/InterCity": {
"get": {
"tags": [
"InterCityBus"
],
"summary": "取得公路客運的動態定時資料(A1)[批次更新]",
"description": "### 公路客運之定時資料(A1) ###\n- [逐筆更新]與[批次更新]之差異請詳見運輸資料使用指引([連結](https://motc-ptx.gitbook.io/tdx-zi-liao-shi-yong-kui-hua-bao-dian/data_notice/public_transportation_data/bus_dynamic_data))",
"operationId": "InterCityBusApi_RealTimeByFrequency_2060",
"parameters": [
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA1Data"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA1Data"
},
"xml": {
"name": "ArrayOfBusA1Data",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/RealTimeByFrequency/InterCity/{RouteName}": {
"get": {
"tags": [
"InterCityBus"
],
"summary": "取得指定[路線名稱]的公路客運動態定時資料(A1)[批次更新]",
"description": "### 公路客運之定時資料(A1) ###\n- [逐筆更新]與[批次更新]之差異請詳見運輸資料使用指引([連結](https://motc-ptx.gitbook.io/tdx-zi-liao-shi-yong-kui-hua-bao-dian/data_notice/public_transportation_data/bus_dynamic_data))",
"operationId": "InterCityBusApi_RealTimeByFrequency_2060_1",
"parameters": [
{
"name": "RouteName",
"in": "path",
"description": "繁體中文路線名稱,如'9001'",
"required": true,
"schema": {
"title": "String",
"type": "string",
"xml": { }
}
},
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA1Data"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA1Data"
},
"xml": {
"name": "ArrayOfBusA1Data",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/RealTimeNearStop/InterCity": {
"get": {
"tags": [
"InterCityBus"
],
"summary": "取得公路客運的動態定點資料(A2)[批次更新]",
"description": "### 公路客運之定點資料(A2) ###\n- [逐筆更新]與[批次更新]之差異請詳見運輸資料使用指引([連結](https://motc-ptx.gitbook.io/tdx-zi-liao-shi-yong-kui-hua-bao-dian/data_notice/public_transportation_data/bus_dynamic_data))",
"operationId": "InterCityBusApi_RealTimeNearStop_2061",
"parameters": [
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA2Data"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA2Data"
},
"xml": {
"name": "ArrayOfBusA2Data",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/RealTimeNearStop/InterCity/{RouteName}": {
"get": {
"tags": [
"InterCityBus"
],
"summary": "取得指定[路線名稱]的公路客運動態定點資料(A2)[批次更新]",
"description": "### 公路客運之定點資料(A2) ###\n- [逐筆更新]與[批次更新]之差異請詳見運輸資料使用指引([連結](https://motc-ptx.gitbook.io/tdx-zi-liao-shi-yong-kui-hua-bao-dian/data_notice/public_transportation_data/bus_dynamic_data))",
"operationId": "InterCityBusApi_RealTimeNearStop_2061_1",
"parameters": [
{
"name": "RouteName",
"in": "path",
"description": "繁體中文路線名稱,如'9001'",
"required": true,
"schema": {
"title": "String",
"type": "string",
"xml": { }
}
},
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA2Data"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA2Data"
},
"xml": {
"name": "ArrayOfBusA2Data",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/EstimatedTimeOfArrival/InterCity": {
"get": {
"tags": [
"InterCityBus"
],
"summary": "取得公路客運的預估到站資料(N1)[批次更新]",
"description": "###公路客運之預估到站資料(N1)###\n- 不保留[現在時間]超過[本平台資料更新時間]兩分鐘的資料\n- [逐筆更新]與[批次更新]之差異請詳見運輸資料使用指引([連結](https://motc-ptx.gitbook.io/tdx-zi-liao-shi-yong-kui-hua-bao-dian/data_notice/public_transportation_data/bus_dynamic_data))",
"operationId": "InterCityBusApi_EstimatedTimeOfArrival_2062",
"parameters": [
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusN1EstimateTime"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusN1EstimateTime"
},
"xml": {
"name": "ArrayOfBusN1EstimateTime",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/EstimatedTimeOfArrival/InterCity/{RouteName}": {
"get": {
"tags": [
"InterCityBus"
],
"summary": "取得指定[路線名稱]的公路客運預估到站資料(N1)[批次更新]",
"description": "### 公路客運之預估到站資料(N1) ###\n- 不保留[現在時間]超過[本平台資料更新時間]兩分鐘的資料\n- [逐筆更新]與[批次更新]之差異請詳見運輸資料使用指引([連結](https://motc-ptx.gitbook.io/tdx-zi-liao-shi-yong-kui-hua-bao-dian/data_notice/public_transportation_data/bus_dynamic_data))",
"operationId": "InterCityBusApi_EstimatedTimeOfArrival_2062_1",
"parameters": [
{
"name": "RouteName",
"in": "path",
"description": "繁體中文路線名稱,如'9001'",
"required": true,
"schema": {
"title": "String",
"type": "string",
"xml": { }
}
},
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusN1EstimateTime"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusN1EstimateTime"
},
"xml": {
"name": "ArrayOfBusN1EstimateTime",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/DataVersion/InterCity": {
"get": {
"tags": [
"InterCityBus"
],
"summary": "取得公路客運目前資料的最新版本資訊",
"description": "版本詳細資訊",
"operationId": "InterCityBusApi_DataVersion_2063",
"parameters": [
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusVersion"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusVersion"
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/Operator/InterCity": {
"get": {
"tags": [
"InterCityBus"
],
"summary": "取得公路客運的營運業者資料",
"description": "公路客運之營運業者資料",
"operationId": "InterCityBusApi_Operator_2064",
"parameters": [
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.Operator"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.Operator"
},
"xml": {
"name": "ArrayOfOperator",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/Route/InterCity": {
"get": {
"tags": [
"InterCityBus"
],
"summary": "取得公路客運路線資料",
"description": "公路客運之路線資料",
"operationId": "InterCityBusApi_Route_2065",
"parameters": [
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRoute"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRoute"
},
"xml": {
"name": "ArrayOfBusRoute",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/Route/InterCity/{RouteName}": {
"get": {
"tags": [
"InterCityBus"
],
"summary": "取得指定[路線名稱]的公路客運路線資料",
"description": "公路客運之路線資料",
"operationId": "InterCityBusApi_Route_2065_1",
"parameters": [
{
"name": "RouteName",
"in": "path",
"description": "繁體中文路線名稱,如'9001'",
"required": true,
"schema": {
"title": "String",
"type": "string",
"xml": { }
}
},
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRoute"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRoute"
},
"xml": {
"name": "ArrayOfBusRoute",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/Stop/InterCity": {
"get": {
"tags": [
"InterCityBus"
],
"summary": "取得公路客運站牌資料",
"description": "公路客運之站牌資料",
"operationId": "InterCityBusApi_Stop_2066",
"parameters": [
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusStop"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusStop"
},
"xml": {
"name": "ArrayOfBusStop",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/Station/InterCity": {
"get": {
"tags": [
"InterCityBus"
],
"summary": "取得公路客運站位資料",
"description": "公路客運之各站牌所屬的站位資料",
"operationId": "InterCityBusApi_Station_2067",
"parameters": [
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusStation"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusStation"
},
"xml": {
"name": "ArrayOfBusStation",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/StopOfRoute/InterCity": {
"get": {
"tags": [
"InterCityBus"
],
"summary": "取得公路客運路線與站牌資料",
"description": "公路客運之路線與站牌資料",
"operationId": "InterCityBusApi_StopOfRoute_2068",
"parameters": [
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusStopOfRoute"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusStopOfRoute"
},
"xml": {
"name": "ArrayOfBusStopOfRoute",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/StopOfRoute/InterCity/{RouteName}": {
"get": {
"tags": [
"InterCityBus"
],
"summary": "取得指定[路線名稱]的公路客運路線與站牌資料",
"description": "公路客運之路線與站牌資料",
"operationId": "InterCityBusApi_StopOfRoute_2068_1",
"parameters": [
{
"name": "RouteName",
"in": "path",
"description": "繁體中文路線名稱,如'9001'",
"required": true,
"schema": {
"title": "String",
"type": "string",
"xml": { }
}
},
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusStopOfRoute"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusStopOfRoute"
},
"xml": {
"name": "ArrayOfBusStopOfRoute",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/Schedule/InterCity": {
"get": {
"tags": [
"InterCityBus"
],
"summary": "取得公路客運路線班表資料",
"description": "公路客運之預定班表及班距資料。公路及國道客運多採用【班表】式時刻表",
"operationId": "InterCityBusApi_Schedule_2069",
"parameters": [
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusSchedule"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusSchedule"
},
"xml": {
"name": "ArrayOfBusSchedule",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/Schedule/InterCity/{RouteName}": {
"get": {
"tags": [
"InterCityBus"
],
"summary": "取得指定[路線名稱]的公路客運路線班表資料",
"description": "公路客運之預定班表及班距資料。公路及國道客運多採用【班表】式時刻表",
"operationId": "InterCityBusApi_Schedule_2069_1",
"parameters": [
{
"name": "RouteName",
"in": "path",
"description": "繁體中文路線名稱,如'9001'",
"required": true,
"schema": {
"title": "String",
"type": "string",
"xml": { }
}
},
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusSchedule"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusSchedule"
},
"xml": {
"name": "ArrayOfBusSchedule",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/News/InterCity": {
"get": {
"tags": [
"InterCityBus"
],
"summary": "取得公路客運之最新消息",
"description": "公路客運之最新消息",
"operationId": "InterCityBusApi_News_2070",
"parameters": [
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusNews"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusNews"
},
"xml": {
"name": "ArrayOfBusNews",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/RouteFare/InterCity": {
"get": {
"tags": [
"InterCityBus"
],
"summary": "取得公路客運之路線票價資料",
"description": "公路客運之路線票價資料",
"operationId": "InterCityBusApi_RouteFare_2072",
"parameters": [
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRouteFare"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRouteFare"
},
"xml": {
"name": "ArrayOfBusRouteFare",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/RouteFare/InterCity/{RouteName}": {
"get": {
"tags": [
"InterCityBus"
],
"summary": "取得指定[路線名稱]的公路客運路線票價資料",
"description": "公路客運之路線票價資料",
"operationId": "InterCityBusApi_RouteFare_2072_1",
"parameters": [
{
"name": "RouteName",
"in": "path",
"description": "繁體中文路線名稱,如'9001'",
"required": true,
"schema": {
"title": "String",
"type": "string",
"xml": { }
}
},
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRouteFare"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRouteFare"
},
"xml": {
"name": "ArrayOfBusRouteFare",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/FirstLastTripInfo/InterCity": {
"get": {
"tags": [
"InterCityBus"
],
"summary": "取得公路客運首末班車資料",
"description": "公路客運之首末班車資料",
"operationId": "InterCityBusApi_FirstLastTripInfo_2073",
"parameters": [
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusFirstLastTripInfo"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusFirstLastTripInfo"
},
"xml": {
"name": "ArrayOfBusFirstLastTripInfo",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/StationGroup/InterCity": {
"get": {
"tags": [
"InterCityBus"
],
"summary": "取得公路客運組站位資料",
"description": "公路客運之各站牌所屬的組站位資料",
"operationId": "InterCityBusApi_StationGroup_2075",
"parameters": [
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusStationGroup"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusStationGroup"
},
"xml": {
"name": "ArrayOfBusStationGroup",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/Shape/InterCity": {
"get": {
"tags": [
"InterCityBus"
],
"summary": "取得公路公車線型資料",
"description": "公路客運之線型資料",
"operationId": "InterCityBusApi_Shape_2076",
"parameters": [
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusShape"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusShape"
},
"xml": {
"name": "ArrayOfBusShape",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/Shape/InterCity/{RouteName}": {
"get": {
"tags": [
"InterCityBus"
],
"summary": "取得指定[路線名稱]的公路公車線型資料",
"description": "公路客運之線型資料",
"operationId": "InterCityBusApi_Shape_2076_1",
"parameters": [
{
"name": "RouteName",
"in": "path",
"description": "繁體中文路線名稱,如'9001'",
"required": true,
"schema": {
"title": "String",
"type": "string",
"xml": { }
}
},
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusShape"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusShape"
},
"xml": {
"name": "ArrayOfBusShape",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/S2STravelTime/InterCity/{RouteID}": {
"get": {
"tags": [
"InterCityBus"
],
"summary": "取得指定[路線代碼]的公路客運站間旅行時間資料",
"description": "指定[路線代碼]的公路客運站間旅行時間資料",
"operationId": "InterCityBusApi_S2STravelTimeDetail_2078",
"parameters": [
{
"name": "RouteID",
"in": "path",
"description": "路線代碼",
"required": true,
"schema": {
"title": "String",
"type": "string",
"xml": { }
}
},
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusS2STravelTime"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusS2STravelTime"
},
"xml": {
"name": "ArrayOfBusS2STravelTime",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/Alert/InterCity": {
"get": {
"tags": [
"InterCityBus"
],
"summary": "取得公路客運之營運通阻資料",
"description": "公路客運之營運通阻資料",
"operationId": "InterCityBusApi_Alert_2079",
"parameters": [
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusAlert"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusAlert"
},
"xml": {
"name": "ArrayOfBusAlert",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/Vehicle": {
"get": {
"tags": [
"Bus(CityBus+InterCityBus)"
],
"summary": "取得全臺公路客運與公路局代管縣市市區公車車輛資料",
"description": "公路局代管縣市,包含:基隆市、新竹縣、新竹市、苗栗縣、彰化縣、南投縣、雲林縣、嘉義縣、嘉義市、屏東縣、宜蘭縣、花蓮縣、臺東縣、澎湖縣,若需六都市區公車車輛資料,請至縣市市區公車車輛資料取用",
"operationId": "BusApi_Vehicle_2080",
"parameters": [
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusVehicleInfo"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusVehicleInfo"
},
"xml": {
"name": "ArrayOfBusVehicleInfo",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/RouteTPASS/City/{City}": {
"get": {
"tags": [
"CityBus"
],
"summary": "取得指定[縣市]的市區公車路線適用通勤月票方案資料",
"description": "市區公車之路線適用通勤月票方案資料",
"operationId": "CityBusApi_RouteTPASS_2430",
"parameters": [
{
"name": "City",
"in": "path",
"description": "欲查詢縣市",
"required": true,
"schema": {
"title": "String",
"enum": [
"Keelung",
"Hsinchu",
"HsinchuCounty",
"MiaoliCounty",
"ChanghuaCounty",
"NantouCounty",
"YunlinCounty",
"ChiayiCounty",
"Chiayi",
"PingtungCounty",
"YilanCounty",
"HualienCounty",
"TaitungCounty",
"PenghuCounty"
],
"type": "string",
"xml": { }
}
},
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRouteTPASS"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRouteTPASS"
},
"xml": {
"name": "ArrayOfBusRouteTPASS",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/RouteTPASS/City/{City}/{RouteName}": {
"get": {
"tags": [
"CityBus"
],
"summary": "取得指定[縣市],[路線名稱]的路線適用通勤月票方案資料",
"description": "市區公車之路線適用通勤月票方案資料",
"operationId": "CityBusApi_RouteTPASS_2430_1",
"parameters": [
{
"name": "City",
"in": "path",
"description": "欲查詢縣市",
"required": true,
"schema": {
"title": "String",
"enum": [
"Keelung",
"Hsinchu",
"HsinchuCounty",
"MiaoliCounty",
"ChanghuaCounty",
"NantouCounty",
"YunlinCounty",
"ChiayiCounty",
"Chiayi",
"PingtungCounty",
"YilanCounty",
"HualienCounty",
"TaitungCounty",
"PenghuCounty"
],
"type": "string",
"xml": { }
}
},
{
"name": "RouteName",
"in": "path",
"description": "繁體中文路線名稱,如'307'",
"required": true,
"schema": {
"title": "String",
"type": "string",
"xml": { }
}
},
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRouteTPASS"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRouteTPASS"
},
"xml": {
"name": "ArrayOfBusRouteTPASS",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/DailyTimeTable/City/{City}": {
"get": {
"tags": [
"CityBus"
],
"summary": "取得指定[縣市]的市區公車每日營運時刻表資料",
"description": "市區公車每日營運時刻表資料",
"operationId": "CityBusApi_DailyTimeTable_2436",
"parameters": [
{
"name": "City",
"in": "path",
"description": "欲查詢縣市",
"required": true,
"schema": {
"title": "String",
"enum": [
"Taichung",
"Taoyuan",
"Keelung",
"Hsinchu",
"HsinchuCounty",
"MiaoliCounty",
"ChanghuaCounty",
"NantouCounty",
"YunlinCounty",
"ChiayiCounty",
"Chiayi",
"PingtungCounty",
"YilanCounty",
"HualienCounty",
"TaitungCounty",
"Kaohsiung",
"PenghuCounty"
],
"type": "string",
"xml": { }
}
},
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusDailyTimeTable"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusDailyTimeTable"
},
"xml": {
"name": "ArrayOfBusDailyTimeTable",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/DailyTimeTable/City/{City}/{RouteName}": {
"get": {
"tags": [
"CityBus"
],
"summary": "取得指定[縣市],[路線名稱]的市區公車每日營運時刻表資料",
"description": "市區公車之每日營運時刻表資料",
"operationId": "CityBusApi_DailyTimeTable_2436_1",
"parameters": [
{
"name": "City",
"in": "path",
"description": "欲查詢縣市",
"required": true,
"schema": {
"title": "String",
"enum": [
"Taichung",
"Taoyuan",
"Keelung",
"Hsinchu",
"HsinchuCounty",
"MiaoliCounty",
"ChanghuaCounty",
"NantouCounty",
"YunlinCounty",
"ChiayiCounty",
"Chiayi",
"PingtungCounty",
"YilanCounty",
"HualienCounty",
"TaitungCounty",
"Kaohsiung",
"PenghuCounty"
],
"type": "string",
"xml": { }
}
},
{
"name": "RouteName",
"in": "path",
"description": "繁體中文路線名稱,如'307'",
"required": true,
"schema": {
"title": "String",
"type": "string",
"xml": { }
}
},
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusDailyTimeTable"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusDailyTimeTable"
},
"xml": {
"name": "ArrayOfBusDailyTimeTable",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/DailyStopTimeTable/City/{City}": {
"get": {
"tags": [
"CityBus"
],
"summary": "取得指定[縣市]的市區公車每日站別時刻表資料",
"description": "市區公車每日站別時刻表資料",
"operationId": "CityBusApi_DailyStopTimeTable_2437",
"parameters": [
{
"name": "City",
"in": "path",
"description": "欲查詢縣市",
"required": true,
"schema": {
"title": "String",
"enum": [
"Taichung",
"Taoyuan",
"Kaohsiung"
],
"type": "string",
"xml": { }
}
},
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusDailyStopTimeTable"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusDailyStopTimeTable"
},
"xml": {
"name": "ArrayOfBusDailyStopTimeTable",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/DailyStopTimeTable/City/{City}/{RouteName}": {
"get": {
"tags": [
"CityBus"
],
"summary": "取得指定[縣市],[路線名稱]的市區公車每日站別時刻表資料",
"description": "市區公車每日站別時刻表資料",
"operationId": "CityBusApi_DailyStopTimeTable_2437_1",
"parameters": [
{
"name": "City",
"in": "path",
"description": "欲查詢縣市",
"required": true,
"schema": {
"title": "String",
"enum": [
"Taichung",
"Taoyuan",
"Kaohsiung"
],
"type": "string",
"xml": { }
}
},
{
"name": "RouteName",
"in": "path",
"description": "繁體中文路線名稱,如'307'",
"required": true,
"schema": {
"title": "String",
"type": "string",
"xml": { }
}
},
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusDailyStopTimeTable"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusDailyStopTimeTable"
},
"xml": {
"name": "ArrayOfBusDailyStopTimeTable",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/DailyTimeTable/InterCity": {
"get": {
"tags": [
"InterCityBus"
],
"summary": "取得公路客運每日營運時刻表資料",
"description": "公路客運每日營運時刻表資料",
"operationId": "InterCityBusApi_DailyTimeTable_2440",
"parameters": [
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusDailyTimeTable"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusDailyTimeTable"
},
"xml": {
"name": "ArrayOfBusDailyTimeTable",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/DailyTimeTable/InterCity/{RouteName}": {
"get": {
"tags": [
"InterCityBus"
],
"summary": "取得指定[路線名稱]的公路客運每日營運時刻表資料",
"description": "公路客運之每日營運時刻表資料",
"operationId": "InterCityBusApi_DailyTimeTable_2440_1",
"parameters": [
{
"name": "RouteName",
"in": "path",
"description": "繁體中文路線名稱,如'9001'",
"required": true,
"schema": {
"title": "String",
"type": "string",
"xml": { }
}
},
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusDailyTimeTable"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusDailyTimeTable"
},
"xml": {
"name": "ArrayOfBusDailyTimeTable",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"304": {
"description": "服務端會在 Response 加上 Last-Modified header,表示最近的更新時間。客戶端能利用此時間,於 Request 加上 If-Modified-Since header,若沒有更新,服務端會回應 304 StatusCode 且空值 Content"
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/RouteTPASS/InterCity": {
"get": {
"tags": [
"InterCityBus"
],
"summary": "取得公路客運之路線適用通勤月票方案資料",
"description": "公路客運之路線適用通勤月票方案資料",
"operationId": "InterCityBusApi_RouteTPASS_2441",
"parameters": [
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRouteTPASS"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRouteTPASS"
},
"xml": {
"name": "ArrayOfBusRouteTPASS",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
},
"/v2/Bus/RouteTPASS/InterCity/{RouteName}": {
"get": {
"tags": [
"InterCityBus"
],
"summary": "取得指定[路線名稱]的公路客運路線適用通勤月票方案資料",
"description": "公路客運之路線適用通勤月票方案資料",
"operationId": "InterCityBusApi_RouteTPASS_2441_1",
"parameters": [
{
"name": "RouteName",
"in": "path",
"description": "繁體中文路線名稱,如'9001'",
"required": true,
"schema": {
"title": "String",
"type": "string",
"xml": { }
}
},
{
"name": "$select",
"in": "query",
"description": "挑選",
"schema": {
"type": "string"
}
},
{
"name": "$filter",
"in": "query",
"description": "過濾",
"schema": {
"type": "string"
}
},
{
"name": "$orderby",
"in": "query",
"description": "排序",
"schema": {
"type": "string"
}
},
{
"name": "$top",
"in": "query",
"description": "取前幾筆",
"schema": {
"type": "integer",
"default": 30
}
},
{
"name": "$skip",
"in": "query",
"description": "跳過前幾筆",
"schema": {
"type": "string"
}
},
{
"name": "health",
"in": "query",
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"schema": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
{
"name": "$format",
"in": "query",
"description": "指定來源格式",
"required": true,
"schema": {
"enum": [
"JSON",
"XML"
],
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRouteTPASS"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRouteTPASS"
},
"xml": {
"name": "ArrayOfBusRouteTPASS",
"namespace": "https://ptx.transportdata.tw/standard/schema/",
"wrapped": true
}
}
}
}
},
"299": {
"description": "加入參數'?health=true'即可查詢此API服務的健康狀態",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
},
"application/xml": {
"schema": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth"
}
}
}
}
}
}
}
},
"components": {
"schemas": {
"PTX.Service.DTO.Bus.Specification.V2.BusA1Data": {
"title": "BusA1Data",
"required": [
"GPSTime",
"PlateNumb",
"UpdateTime"
],
"type": "object",
"properties": {
"PlateNumb": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "車牌號碼",
"xml": {
"name": "PlateNumb"
}
},
"OperatorID": {
"title": "String",
"type": "string",
"description": "營運業者代碼",
"nullable": true,
"xml": {
"name": "OperatorID"
}
},
"OperatorNo": {
"title": "String",
"type": "string",
"description": "營運業者編號[交通部票證資料系統定義]",
"nullable": true,
"xml": {
"name": "OperatorNo"
}
},
"RouteUID": {
"title": "String",
"type": "string",
"description": "路線唯一識別代碼,規則為 {業管機關簡碼} + {RouteID},其中 {業管機關簡碼} 可於Authority API中的AuthorityCode欄位查詢",
"nullable": true,
"xml": {
"name": "RouteUID"
}
},
"RouteID": {
"title": "String",
"type": "string",
"description": "地區既用中之路線代碼(為原資料內碼)",
"nullable": true,
"xml": {
"name": "RouteID"
}
},
"RouteName": {
"title": "NameType",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType"
}
],
"description": "路線名稱",
"nullable": true,
"xml": {
"name": "NameType"
}
},
"SubRouteUID": {
"title": "String",
"type": "string",
"description": "子路線唯一識別代碼,規則為 {業管機關簡碼} + {SubRouteID},其中 {業管機關簡碼} 可於Authority API中的AuthorityCode欄位查詢",
"nullable": true,
"xml": {
"name": "SubRouteUID"
}
},
"SubRouteID": {
"title": "String",
"type": "string",
"description": "地區既用中之子路線代碼(為原資料內碼)",
"nullable": true,
"xml": {
"name": "SubRouteID"
}
},
"SubRouteName": {
"title": "NameType",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType"
}
],
"description": "子路線名稱",
"nullable": true,
"xml": {
"name": "NameType"
}
},
"Direction": {
"title": "Int32",
"type": "integer",
"description": "去返程 : [0:'去程',1:'返程',2:'迴圈',10:'循環線',255:'未知']",
"format": "int32",
"nullable": true
},
"BusPosition": {
"title": "PointType",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.PointType"
}
],
"description": "車輛位置經度",
"nullable": true,
"xml": {
"name": "PointType"
}
},
"Speed": {
"type": "number",
"description": "行駛速度(kph)",
"format": "double",
"nullable": true
},
"Azimuth": {
"type": "number",
"description": "方位角",
"format": "double",
"nullable": true
},
"DutyStatus": {
"title": "Int32",
"type": "integer",
"description": "勤務狀態 : [0:'正常',1:'開始',2:'結束']",
"format": "int32",
"nullable": true
},
"BusStatus": {
"title": "Int32",
"type": "integer",
"description": "行車狀況 : [0:'正常',1:'車禍',2:'故障',3:'塞車',4:'緊急求援',5:'加油',90:'不明',91:'去回不明',98:'偏移路線',99:'非營運狀態',100:'客滿',101:'包車出租',255:'未知']",
"format": "int32",
"nullable": true
},
"MessageType": {
"title": "Int32",
"type": "integer",
"description": "資料型態種類 : [0:'未知',1:'定期',2:'非定期']",
"format": "int32",
"nullable": true
},
"GPSTime": {
"title": "DateTime",
"type": "string",
"description": "車機時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)",
"format": "date-time"
},
"TransTime": {
"type": "string",
"description": "車機資料傳輸時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)[多數單位沒有提供此欄位資訊]",
"format": "date-time",
"nullable": true
},
"SrcRecTime": {
"type": "string",
"description": "來源端平台接收時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)",
"format": "date-time",
"nullable": true
},
"SrcTransTime": {
"type": "string",
"description": "來源端平台資料傳出時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)[公總使用動態即時推播故有提供此欄位, 而非公總系統因使用整包資料更新, 故沒有提供此欄位]",
"format": "date-time",
"nullable": true
},
"SrcUpdateTime": {
"type": "string",
"description": "來源端平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)[公總使用動態即時推播故沒有提供此欄位, 而非公總系統因提供整包資料更新, 故有提供此欄]",
"format": "date-time",
"nullable": true
},
"UpdateTime": {
"title": "DateTime",
"type": "string",
"description": "本平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)",
"format": "date-time"
}
},
"additionalProperties": false,
"description": "定時車機資料型別",
"xml": {
"name": "BusA1Data"
}
},
"PTX.Service.DTO.Bus.Specification.V2.BusA1Data0": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA1Data"
},
"PTX.Service.DTO.Shared.Specification.V2.Base.NameType": {
"title": "NameType",
"type": "object",
"properties": {
"Zh_tw": {
"title": "String",
"type": "string",
"description": "中文繁體名稱",
"nullable": true,
"xml": {
"name": "Zh_tw"
}
},
"En": {
"title": "String",
"type": "string",
"description": "英文名稱",
"nullable": true,
"xml": {
"name": "En"
}
}
},
"additionalProperties": false,
"description": "名稱資料型別",
"xml": {
"name": "NameType"
}
},
"PTX.Service.DTO.Shared.Specification.V2.Base.PointType": {
"title": "PointType",
"type": "object",
"properties": {
"PositionLon": {
"type": "number",
"description": "位置經度(WGS84)",
"format": "double",
"nullable": true
},
"PositionLat": {
"type": "number",
"description": "位置緯度(WGS84)",
"format": "double",
"nullable": true
},
"GeoHash": {
"title": "String",
"type": "string",
"description": "地理空間編碼",
"nullable": true,
"xml": {
"name": "GeoHash"
}
}
},
"additionalProperties": false,
"description": "座標資料型別",
"xml": {
"name": "PointType"
}
},
"PTX.Service.DTO.Shared.Specification.V3.Base.DisplayHealth": {
"title": "DisplayHealth",
"required": [
"Inbound",
"Outbound",
"ServiceID",
"ServiceName"
],
"type": "object",
"properties": {
"ServiceID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "API服務代碼",
"xml": {
"name": "ServiceID"
}
},
"ServiceName": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "API服務中文名稱",
"xml": {
"name": "ServiceName"
}
},
"Inbound": {
"title": "Inbound",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.Inbound"
}
],
"description": "本平台資料來源轉入狀態",
"nullable": true,
"xml": {
"name": "Inbound"
}
},
"Outbound": {
"title": "Outbound",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V3.Base.Outbound"
}
],
"description": "本平台API狀態",
"nullable": true,
"xml": {
"name": "Outbound"
}
}
},
"additionalProperties": false,
"description": "API服務健康狀態",
"xml": {
"name": "DisplayHealth"
}
},
"PTX.Service.DTO.Shared.Specification.V3.Base.Inbound": {
"title": "Inbound",
"required": [
"CheckTime",
"Status"
],
"type": "object",
"properties": {
"CheckTime": {
"title": "DateTime",
"type": "string",
"description": "檢核時間",
"format": "date-time"
},
"Status": {
"title": "Int32",
"type": "integer",
"description": "檢核結果狀態 : [0:'失敗',1:'成功',2:'資料清洗中']",
"format": "int32"
},
"Reason": {
"title": "String",
"type": "string",
"description": "檢核失敗原因",
"nullable": true,
"xml": {
"name": "Reason"
}
}
},
"additionalProperties": false,
"description": "本平台資料來源轉入狀態",
"xml": {
"name": "Inbound"
}
},
"PTX.Service.DTO.Shared.Specification.V3.Base.Outbound": {
"title": "Outbound",
"required": [
"CheckTime",
"Status"
],
"type": "object",
"properties": {
"CheckTime": {
"title": "DateTime",
"type": "string",
"description": "檢核時間",
"format": "date-time"
},
"Status": {
"title": "Int32",
"type": "integer",
"description": "檢核結果狀態 : [0:'失敗',1:'成功',2:'資料清洗中']",
"format": "int32"
},
"Reason": {
"title": "String",
"type": "string",
"description": "檢核失敗原因",
"nullable": true,
"xml": {
"name": "Reason"
}
}
},
"additionalProperties": false,
"description": "本平台API狀態",
"xml": {
"name": "Outbound"
}
},
"PTX.Service.DTO.Bus.Specification.V2.BusA2Data": {
"title": "BusA2Data",
"required": [
"Direction",
"GPSTime",
"PlateNumb",
"TripStartTimeType",
"UpdateTime"
],
"type": "object",
"properties": {
"PlateNumb": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "車牌號碼",
"xml": {
"name": "PlateNumb"
}
},
"OperatorID": {
"title": "String",
"type": "string",
"description": "營運業者代碼",
"nullable": true,
"xml": {
"name": "OperatorID"
}
},
"OperatorNo": {
"title": "String",
"type": "string",
"description": "營運業者編號[交通部票證資料系統定義]",
"nullable": true,
"xml": {
"name": "OperatorNo"
}
},
"RouteUID": {
"title": "String",
"type": "string",
"description": "路線唯一識別代碼,規則為 {業管機關簡碼} + {RouteID},其中 {業管機關簡碼} 可於Authority API中的AuthorityCode欄位查詢",
"nullable": true,
"xml": {
"name": "RouteUID"
}
},
"RouteID": {
"title": "String",
"type": "string",
"description": "地區既用中之路線代碼(為原資料內碼)",
"nullable": true,
"xml": {
"name": "RouteID"
}
},
"RouteName": {
"title": "NameType",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType"
}
],
"description": "路線名",
"nullable": true,
"xml": {
"name": "NameType"
}
},
"SubRouteUID": {
"title": "String",
"type": "string",
"description": "子路線唯一識別代碼,規則為 {業管機關簡碼} + {SubRouteID},其中 {業管機關簡碼} 可於Authority API中的AuthorityCode欄位查詢",
"nullable": true,
"xml": {
"name": "SubRouteUID"
}
},
"SubRouteID": {
"title": "String",
"type": "string",
"description": "地區既用中之子路線代碼(為原資料內碼)",
"nullable": true,
"xml": {
"name": "SubRouteID"
}
},
"SubRouteName": {
"title": "NameType",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType"
}
],
"description": "子路線名稱",
"nullable": true,
"xml": {
"name": "NameType"
}
},
"Direction": {
"title": "Int32",
"type": "integer",
"description": "去返程 : [0:'去程',1:'返程',2:'迴圈',10:'循環線',255:'未知']",
"format": "int32"
},
"StopUID": {
"title": "String",
"type": "string",
"description": "站牌唯一識別代碼,規則為 {業管機關簡碼} + {StopID},其中 {業管機關簡碼} 可於Authority API中的AuthorityCode欄位查詢",
"nullable": true,
"xml": {
"name": "StopUID"
}
},
"StopID": {
"title": "String",
"type": "string",
"description": "地區既用中之站牌代號(為原資料內碼)",
"nullable": true,
"xml": {
"name": "StopID"
}
},
"StopName": {
"title": "NameType",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType"
}
],
"description": "站牌名",
"nullable": true,
"xml": {
"name": "NameType"
}
},
"StopSequence": {
"title": "Int32",
"type": "integer",
"description": "路線經過站牌之順序",
"format": "int32"
},
"MessageType": {
"title": "Int32",
"type": "integer",
"description": "資料型態種類 : [0:'未知',1:'定期',2:'非定期']",
"format": "int32",
"nullable": true
},
"DutyStatus": {
"title": "Int32",
"type": "integer",
"description": "勤務狀態 : [0:'正常',1:'開始',2:'結束']",
"format": "int32",
"nullable": true
},
"BusStatus": {
"title": "Int32",
"type": "integer",
"description": "行車狀況 : [0:'正常',1:'車禍',2:'故障',3:'塞車',4:'緊急求援',5:'加油',90:'不明',91:'去回不明',98:'偏移路線',99:'非營運狀態',100:'客滿',101:'包車出租',255:'未知']",
"format": "int32",
"nullable": true
},
"A2EventType": {
"title": "Int32",
"type": "integer",
"description": "進站離站 : [0:'離站',1:'進站']",
"format": "int32",
"nullable": true
},
"GPSTime": {
"title": "DateTime",
"type": "string",
"description": "車機時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz) [觸發到離站的GPS時間]",
"format": "date-time"
},
"TripStartTimeType": {
"title": "Int32",
"type": "integer",
"description": "班次發車時間類型 : [0:'實際發車時間',1:'預估發車時間',2:'無法推估發車時間']",
"format": "int32"
},
"TripStartTime": {
"title": "String",
"type": "string",
"description": "首站發車時間(yyyy-MM-ddTHH:mm:sszzz)",
"nullable": true,
"xml": {
"name": "TripStartTime"
}
},
"TransTime": {
"type": "string",
"description": "車機資料傳輸時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)[多數單位沒有提供此欄位資訊]",
"format": "date-time",
"nullable": true
},
"SrcRecTime": {
"type": "string",
"description": "來源端平台接收時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)",
"format": "date-time",
"nullable": true
},
"SrcTransTime": {
"type": "string",
"description": "來源端平台資料傳出時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)[公總使用動態即時推播故有提供此欄位, 而非公總系統因使用整包資料更新, 故沒有提供此欄位]",
"format": "date-time",
"nullable": true
},
"SrcUpdateTime": {
"type": "string",
"description": "來源端平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)[公總使用動態即時推播故沒有提供此欄位, 而非公總系統因提供整包資料更新, 故有提供此欄]",
"format": "date-time",
"nullable": true
},
"UpdateTime": {
"title": "DateTime",
"type": "string",
"description": "本平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)",
"format": "date-time"
}
},
"additionalProperties": false,
"description": "定點車機資料型別",
"xml": {
"name": "BusA2Data"
}
},
"PTX.Service.DTO.Bus.Specification.V2.BusA2Data1": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusA2Data"
},
"PTX.Service.DTO.Bus.Specification.V2.BusN1EstimateTime": {
"title": "BusN1EstimateTime",
"required": [
"Direction",
"UpdateTime"
],
"type": "object",
"properties": {
"PlateNumb": {
"title": "String",
"type": "string",
"description": "車牌號碼 [値為値為-1時,表示目前該站位無車輛行駛]",
"nullable": true,
"xml": {
"name": "PlateNumb"
}
},
"StopUID": {
"title": "String",
"type": "string",
"description": "站牌唯一識別代碼,規則為 {業管機關簡碼} + {StopID},其中 {業管機關簡碼} 可於Authority API中的AuthorityCode欄位查詢",
"nullable": true,
"xml": {
"name": "StopUID"
}
},
"StopID": {
"title": "String",
"type": "string",
"description": "地區既用中之站牌代碼(為原資料內碼)",
"nullable": true,
"xml": {
"name": "StopID"
}
},
"StopName": {
"title": "NameType",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType"
}
],
"description": "站牌名",
"nullable": true,
"xml": {
"name": "NameType"
}
},
"RouteUID": {
"title": "String",
"type": "string",
"description": "路線唯一識別代碼,規則為 {業管機關代碼} + {RouteID},其中 {業管機關代碼} 可於Authority API中的AuthorityCode欄位查詢",
"nullable": true,
"xml": {
"name": "RouteUID"
}
},
"RouteID": {
"title": "String",
"type": "string",
"description": "地區既用中之路線代碼(為原資料內碼)",
"nullable": true,
"xml": {
"name": "RouteID"
}
},
"RouteName": {
"title": "NameType",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType"
}
],
"description": "路線名稱",
"nullable": true,
"xml": {
"name": "NameType"
}
},
"SubRouteUID": {
"title": "String",
"type": "string",
"description": "子路線唯一識別代碼,規則為 {業管機關簡碼} + {SubRouteID},其中 {業管機關簡碼} 可於Authority API中的AuthorityCode欄位查詢",
"nullable": true,
"xml": {
"name": "SubRouteUID"
}
},
"SubRouteID": {
"title": "String",
"type": "string",
"description": "地區既用中之子路線代碼(為原資料內碼)",
"nullable": true,
"xml": {
"name": "SubRouteID"
}
},
"SubRouteName": {
"title": "NameType",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType"
}
],
"description": "子路線名稱",
"nullable": true,
"xml": {
"name": "NameType"
}
},
"Direction": {
"title": "Int32",
"type": "integer",
"description": "去返程(該方向指的是此車牌車輛目前所在路線的去返程方向,非指站站牌所在路線的去返程方向,使用時請加值業者多加注意) : [0:'去程',1:'返程',2:'迴圈',10:'循環線',255:'未知']",
"format": "int32"
},
"EstimateTime": {
"type": "integer",
"description": "到站時間預估(秒) [當StopStatus値為2~4或PlateNumb値為-1時,EstimateTime値為null; 當StopStatus値為1時, EstimateTime値多數為null,僅部分路線因有固定發車時間,故EstimateTime有値; 當StopStatus値為0時,EstimateTime有値。]",
"format": "int32",
"nullable": true
},
"ScheduledTime": {
"title": "String",
"type": "string",
"description": "預排班表時間 HH:mm",
"nullable": true,
"xml": {
"name": "ScheduledTime"
}
},
"StopCountDown": {
"type": "integer",
"description": "車輛距離本站站數",
"format": "int32",
"nullable": true
},
"CurrentStop": {
"title": "String",
"type": "string",
"description": "車輛目前所在站牌代碼",
"nullable": true,
"xml": {
"name": "CurrentStop"
}
},
"DestinationStop": {
"title": "String",
"type": "string",
"description": "車輛目的站牌代碼",
"nullable": true,
"xml": {
"name": "DestinationStop"
}
},
"StopSequence": {
"type": "integer",
"description": "路線經過站牌之順序",
"format": "int32",
"nullable": true
},
"StopStatus": {
"title": "Int32",
"type": "integer",
"description": "車輛狀態備註 : [0:'正常',1:'尚未發車',2:'交管不停靠',3:'末班車已過',4:'今日未營運']",
"format": "int32",
"nullable": true
},
"MessageType": {
"title": "Int32",
"type": "integer",
"description": "資料型態種類 : [0:'未知',1:'定期',2:'非定期']",
"format": "int32",
"nullable": true
},
"NextBusTime": {
"type": "string",
"description": "下一班公車到達時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)",
"format": "date-time",
"nullable": true
},
"IsLastBus": {
"type": "boolean",
"description": "是否為末班車",
"nullable": true
},
"Estimates": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.N1.Estimate"
},
"description": "到站時間預估",
"nullable": true,
"xml": {
"name": "Estimate"
}
},
"DataTime": {
"type": "string",
"description": "系統演算該筆預估到站資料的時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)[目前僅公總提供此欄位資訊]",
"format": "date-time",
"nullable": true
},
"TransTime": {
"type": "string",
"description": "車機資料傳輸時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz))[該欄位在N1資料中無意義]",
"format": "date-time",
"nullable": true
},
"SrcRecTime": {
"type": "string",
"description": "來源端平台接收時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz))[該欄位在N1資料中無意義]",
"format": "date-time",
"nullable": true
},
"SrcTransTime": {
"type": "string",
"description": "來源端平台資料傳出時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)[公總使用動態即時推播故有提供此欄位, 而非公總系統因使用整包資料更新, 故沒有提供此欄位]",
"format": "date-time",
"nullable": true
},
"SrcUpdateTime": {
"type": "string",
"description": "來源端平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)[公總使用動態即時推播故沒有提供此欄位, 而非公總系統因提供整包資料更新, 故有提供此欄]",
"format": "date-time",
"nullable": true
},
"UpdateTime": {
"title": "DateTime",
"type": "string",
"description": "本平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)",
"format": "date-time"
}
},
"additionalProperties": false,
"xml": {
"name": "BusN1EstimateTime"
}
},
"PTX.Service.DTO.Bus.Specification.V2.BusN1EstimateTime2": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusN1EstimateTime"
},
"PTX.Service.DTO.Bus.Specification.V2.N1.Estimate": {
"title": "Estimate",
"type": "object",
"properties": {
"PlateNumb": {
"title": "String",
"type": "string",
"description": "車輛車牌號碼",
"nullable": true,
"xml": {
"name": "PlateNumb"
}
},
"EstimateTime": {
"type": "integer",
"description": "車輛之到站時間預估(秒)",
"format": "int32",
"nullable": true
},
"IsLastBus": {
"type": "boolean",
"description": "是否為末班車",
"nullable": true
},
"VehicleStopStatus": {
"title": "Int32",
"type": "integer",
"description": "車輛於該站之進離站狀態 : [0:'離站',1:'進站']",
"format": "int32",
"nullable": true
}
},
"additionalProperties": false,
"xml": {
"name": "Estimate"
}
},
"PTX.Service.DTO.Bus.Specification.V2.BusVersion": {
"title": "BusVersion",
"required": [
"UpdateCheckTime",
"UpdateTime",
"VersionID"
],
"type": "object",
"properties": {
"VersionID": {
"title": "Int32",
"type": "integer",
"description": "資料版本編號",
"format": "int32"
},
"UpdateTime": {
"title": "DateTime",
"type": "string",
"description": "資料更新日期時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)",
"format": "date-time"
},
"UpdateCheckTime": {
"title": "DateTime",
"type": "string",
"description": "此資料版本最後檢查更新之日期時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)",
"format": "date-time"
}
},
"additionalProperties": false,
"description": "公車版本資料型別",
"xml": {
"name": "BusVersion"
}
},
"PTX.Service.DTO.Shared.Specification.V2.Base.Operator": {
"title": "Operator",
"required": [
"AuthorityCode",
"OperatorCode",
"OperatorID",
"OperatorName",
"OperatorNo",
"ProviderID",
"UpdateTime"
],
"type": "object",
"properties": {
"ProviderID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "資料提供平台代碼",
"xml": {
"name": "ProviderID"
}
},
"OperatorID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "營運業者代碼",
"xml": {
"name": "OperatorID"
}
},
"OperatorName": {
"title": "NameType",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType"
}
],
"description": "營運業者名稱",
"xml": {
"name": "NameType"
}
},
"OperatorPhone": {
"title": "String",
"type": "string",
"description": "營運業者連絡電話",
"nullable": true,
"xml": {
"name": "OperatorPhone"
}
},
"OperatorEmail": {
"title": "String",
"type": "string",
"description": "營運業者電子信箱",
"nullable": true,
"xml": {
"name": "OperatorEmail"
}
},
"OperatorUrl": {
"title": "String",
"type": "string",
"description": "營運業者網址鏈結",
"nullable": true,
"xml": {
"name": "OperatorUrl"
}
},
"ReservationUrl": {
"title": "String",
"type": "string",
"description": "訂票網址鏈結",
"nullable": true,
"xml": {
"name": "ReservationUrl"
}
},
"ReservationPhone": {
"title": "String",
"type": "string",
"description": "訂票連絡電話",
"nullable": true,
"xml": {
"name": "ReservationPhone"
}
},
"OperatorCode": {
"title": "String",
"type": "string",
"description": "營運業者簡碼",
"nullable": true,
"xml": {
"name": "OperatorCode"
}
},
"AuthorityCode": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "營運業者業管機關簡碼(對於於公路客運/國道客運而言為THB)",
"xml": {
"name": "AuthorityCode"
}
},
"SubAuthorityCode": {
"title": "String",
"type": "string",
"description": "營運業者所屬業管子機關簡碼(對於公路客運/國道客運路線而言為區監理所如THB-VO10-1..等)",
"nullable": true,
"xml": {
"name": "SubAuthorityCode"
}
},
"OperatorNo": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "營運業者編號[交通部票證資料系統定義]",
"xml": {
"name": "OperatorNo"
}
},
"UpdateTime": {
"title": "DateTime",
"type": "string",
"description": "資料更新日期時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)",
"format": "date-time"
}
},
"additionalProperties": false,
"description": "營運業者資料型別",
"xml": {
"name": "Operator"
}
},
"PTX.Service.DTO.Shared.Specification.V2.Base.Operator3": {
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.Operator"
},
"PTX.Service.DTO.Bus.Specification.V2.BusRoute": {
"title": "BusRoute",
"required": [
"AuthorityID",
"BusRouteType",
"HasSubRoutes",
"Operators",
"ProviderID",
"RouteID",
"RouteName",
"RouteUID",
"UpdateTime",
"VersionID"
],
"type": "object",
"properties": {
"RouteUID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "路線唯一識別代碼,規則為 {業管機關簡碼} + {RouteID},其中 {業管機關簡碼} 可於Authority API中的AuthorityCode欄位查詢",
"xml": {
"name": "RouteUID"
}
},
"RouteID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "地區既用中之路線代碼(為原資料內碼)",
"xml": {
"name": "RouteID"
}
},
"HasSubRoutes": {
"title": "Boolean",
"type": "boolean",
"description": "實際上是否有多條附屬路線。(此欄位值與SubRoutes結構並無強烈的絕對關聯。詳細說明請參閱swagger上方的【資料服務使用注意事項】)"
},
"Operators": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.Embedded.RouteOperator"
},
"description": "營運業者",
"xml": {
"name": "Operator"
}
},
"AuthorityID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "業管機關代碼",
"xml": {
"name": "AuthorityID"
}
},
"ProviderID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "資料提供平台代碼",
"xml": {
"name": "ProviderID"
}
},
"SubRoutes": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusSubRoute"
},
"description": "附屬路線資料(如果原始資料並無提供附屬路線ID,而本平台基於跨來源資料之一致性,會以SubRouteID=RouteID產製一份相對應的附屬路線資料(若有去返程,則會有兩筆))",
"nullable": true,
"xml": {
"name": "SubRoute"
}
},
"BusRouteType": {
"title": "Int32",
"type": "integer",
"description": "公車路線類別 : [11:'市區公車',12:'公路客運',13:'國道客運',14:'接駁車']",
"format": "int32"
},
"RouteName": {
"title": "NameType",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType"
}
],
"description": "路線名稱",
"xml": {
"name": "NameType"
}
},
"DepartureStopNameZh": {
"title": "String",
"type": "string",
"description": "起站中文名稱",
"nullable": true,
"xml": {
"name": "DepartureStopNameZh"
}
},
"DepartureStopNameEn": {
"title": "String",
"type": "string",
"description": "起站英文名稱",
"nullable": true,
"xml": {
"name": "DepartureStopNameEn"
}
},
"DestinationStopNameZh": {
"title": "String",
"type": "string",
"description": "終點站中文名稱",
"nullable": true,
"xml": {
"name": "DestinationStopNameZh"
}
},
"DestinationStopNameEn": {
"title": "String",
"type": "string",
"description": "終點站英文名稱",
"nullable": true,
"xml": {
"name": "DestinationStopNameEn"
}
},
"TicketPriceDescriptionZh": {
"title": "String",
"type": "string",
"description": "票價中文敘述",
"nullable": true,
"xml": {
"name": "TicketPriceDescriptionZh"
}
},
"TicketPriceDescriptionEn": {
"title": "String",
"type": "string",
"description": "票價英文敘述",
"nullable": true,
"xml": {
"name": "TicketPriceDescriptionEn"
}
},
"FareBufferZoneDescriptionZh": {
"title": "String",
"type": "string",
"description": "收費緩衝區中文敘述",
"nullable": true,
"xml": {
"name": "FareBufferZoneDescriptionZh"
}
},
"FareBufferZoneDescriptionEn": {
"title": "String",
"type": "string",
"description": "收費緩衝區英文敘述",
"nullable": true,
"xml": {
"name": "FareBufferZoneDescriptionEn"
}
},
"RouteMapImageUrl": {
"title": "String",
"type": "string",
"description": "路線簡圖網址",
"nullable": true,
"xml": {
"name": "RouteMapImageUrl"
}
},
"City": {
"title": "String",
"type": "string",
"description": "路線權管所屬縣市(相當於市區公車API的City參數)[若為公路/國道客運路線則為空值]",
"nullable": true,
"xml": {
"name": "City"
}
},
"CityCode": {
"title": "String",
"type": "string",
"description": "路線權管所屬縣市之代碼(國際ISO 3166-2 三碼城市代碼)[若為公路/國道客運路線則為空值]",
"nullable": true,
"xml": {
"name": "CityCode"
}
},
"UpdateTime": {
"title": "DateTime",
"type": "string",
"description": "資料更新日期時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)",
"format": "date-time"
},
"VersionID": {
"title": "Int32",
"type": "integer",
"description": "資料版本編號",
"format": "int32"
}
},
"additionalProperties": false,
"description": "路線資料型別",
"xml": {
"name": "BusRoute"
}
},
"PTX.Service.DTO.Bus.Specification.V2.BusRoute4": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRoute"
},
"PTX.Service.DTO.Bus.Specification.V2.Embedded.RouteOperator": {
"title": "RouteOperator",
"required": [
"OperatorID",
"OperatorName",
"OperatorNo"
],
"type": "object",
"properties": {
"OperatorID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "營運業者代碼",
"xml": {
"name": "OperatorID"
}
},
"OperatorName": {
"title": "NameType",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType"
}
],
"description": "營運業者名稱",
"xml": {
"name": "NameType"
}
},
"OperatorCode": {
"title": "String",
"type": "string",
"description": "營運業者簡碼",
"nullable": true,
"xml": {
"name": "OperatorCode"
}
},
"OperatorNo": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "營運業者編號[交通部票證資料系統定義]",
"xml": {
"name": "OperatorNo"
}
}
},
"additionalProperties": false,
"description": "營運業者資訊",
"xml": {
"name": "RouteOperator"
}
},
"PTX.Service.DTO.Bus.Specification.V2.BusSubRoute": {
"title": "BusSubRoute",
"required": [
"Direction",
"OperatorIDs",
"SubRouteID",
"SubRouteName",
"SubRouteUID"
],
"type": "object",
"properties": {
"SubRouteUID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "附屬路線唯一識別代碼,規則為 {業管機關簡碼} + {SubRouteID},其中 {業管機關簡碼} 可於Authority API中的AuthorityCode欄位查詢",
"xml": {
"name": "SubRouteUID"
}
},
"SubRouteID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "地區既用中之附屬路線代碼(為原資料內碼)",
"xml": {
"name": "SubRouteID"
}
},
"OperatorIDs": {
"title": "Array",
"type": "array",
"items": {
"title": "String",
"type": "string",
"xml": { }
},
"description": "營運業者代碼",
"xml": {
"name": "List`1"
}
},
"SubRouteName": {
"title": "NameType",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType"
}
],
"description": "附屬路線名稱",
"xml": {
"name": "NameType"
}
},
"Headsign": {
"title": "String",
"type": "string",
"description": "車頭描述",
"nullable": true,
"xml": {
"name": "Headsign"
}
},
"HeadsignEn": {
"title": "String",
"type": "string",
"description": "車頭英文描述",
"nullable": true,
"xml": {
"name": "HeadsignEn"
}
},
"Direction": {
"title": "Int32",
"type": "integer",
"description": "去返程 : [0:'去程',1:'返程',2:'迴圈',10:'循環線',255:'未知']",
"format": "int32"
},
"FirstBusTime": {
"title": "String",
"type": "string",
"description": "平日第一班發車時間",
"nullable": true,
"xml": {
"name": "FirstBusTime"
}
},
"LastBusTime": {
"title": "String",
"type": "string",
"description": "平日返程第一班發車時間",
"nullable": true,
"xml": {
"name": "LastBusTime"
}
},
"HolidayFirstBusTime": {
"title": "String",
"type": "string",
"description": "假日去程第一班發車時間",
"nullable": true,
"xml": {
"name": "HolidayFirstBusTime"
}
},
"HolidayLastBusTime": {
"title": "String",
"type": "string",
"description": "假日返程第一班發車時間",
"nullable": true,
"xml": {
"name": "HolidayLastBusTime"
}
},
"DepartureStopNameZh": {
"title": "String",
"type": "string",
"description": "起站中文名稱",
"nullable": true,
"xml": {
"name": "DepartureStopNameZh"
}
},
"DepartureStopNameEn": {
"title": "String",
"type": "string",
"description": "起站英文名稱",
"nullable": true,
"xml": {
"name": "DepartureStopNameEn"
}
},
"DestinationStopNameZh": {
"title": "String",
"type": "string",
"description": "終點站中文名稱",
"nullable": true,
"xml": {
"name": "DestinationStopNameZh"
}
},
"DestinationStopNameEn": {
"title": "String",
"type": "string",
"description": "終點站英文名稱",
"nullable": true,
"xml": {
"name": "DestinationStopNameEn"
}
}
},
"additionalProperties": false,
"description": "附屬路線資料型別",
"xml": {
"name": "BusSubRoute"
}
},
"PTX.Service.DTO.Bus.Specification.V2.BusStop": {
"title": "BusStop",
"required": [
"AuthorityID",
"StationGroupID",
"StopID",
"StopName",
"StopPosition",
"StopUID",
"UpdateTime",
"VersionID"
],
"type": "object",
"properties": {
"StopUID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "站牌唯一識別代碼,規則為 {業管機關簡碼} + {StopID},其中 {業管機關簡碼} 可於Authority API中的AuthorityCode欄位查詢",
"xml": {
"name": "StopUID"
}
},
"StopID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "地區既用中之站牌代碼(為原資料內碼)",
"xml": {
"name": "StopID"
}
},
"AuthorityID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "業管機關代碼",
"xml": {
"name": "AuthorityID"
}
},
"StopName": {
"title": "NameType",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType"
}
],
"description": "站牌名稱",
"xml": {
"name": "NameType"
}
},
"StopPosition": {
"title": "PointType",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.PointType"
}
],
"description": "站牌位置",
"xml": {
"name": "PointType"
}
},
"StopAddress": {
"title": "String",
"type": "string",
"description": "站牌地址",
"nullable": true,
"xml": {
"name": "StopAddress"
}
},
"Bearing": {
"title": "String",
"type": "string",
"description": "方位角,E:東行;W:西行;S:南行;N:北行;SE:東南行;NE:東北行;SW:西南行;NW:西北行",
"nullable": true,
"xml": {
"name": "Bearing"
}
},
"StationID": {
"title": "String",
"type": "string",
"description": "站牌所屬的站位ID",
"nullable": true,
"xml": {
"name": "StationID"
}
},
"StationGroupID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "站牌所屬的組站位ID",
"xml": {
"name": "StationGroupID"
}
},
"StopDescription": {
"title": "String",
"type": "string",
"description": "站牌詳細說明描述",
"nullable": true,
"xml": {
"name": "StopDescription"
}
},
"City": {
"title": "String",
"type": "string",
"description": "站牌權管所屬縣市(相當於市區公車API的City參數)[若為公路/國道客運路線則為空值]",
"nullable": true,
"xml": {
"name": "City"
}
},
"CityCode": {
"title": "String",
"type": "string",
"description": "站牌權管所屬縣市之代碼(國際ISO 3166-2 三碼城市代碼)[若為公路/國道客運路線則為空值]",
"nullable": true,
"xml": {
"name": "CityCode"
}
},
"LocationCityCode": {
"title": "String",
"type": "string",
"description": "站牌位置縣市之代碼(國際ISO 3166-2 三碼城市代碼)[若為公路/國道客運路線則為空值]",
"nullable": true,
"xml": {
"name": "LocationCityCode"
}
},
"UpdateTime": {
"title": "DateTime",
"type": "string",
"description": "資料更新日期時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)",
"format": "date-time"
},
"VersionID": {
"title": "Int32",
"type": "integer",
"description": "資料版本編號",
"format": "int32"
}
},
"additionalProperties": false,
"description": "站牌/位資料型別",
"xml": {
"name": "BusStop"
}
},
"PTX.Service.DTO.Bus.Specification.V2.BusStop5": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusStop"
},
"PTX.Service.DTO.Bus.Specification.V2.BusStation": {
"title": "BusStation",
"required": [
"StationGroupID",
"StationID",
"StationName",
"StationPosition",
"StationUID",
"UpdateTime",
"VersionID"
],
"type": "object",
"properties": {
"StationUID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "站位唯一識別代碼,規則為 {業管機關簡碼} + {StationID},其中 {業管機關簡碼} 可於Authority API中的AuthorityCode欄位查詢",
"xml": {
"name": "StationUID"
}
},
"StationID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "站位代碼",
"xml": {
"name": "StationID"
}
},
"StationName": {
"title": "NameType",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType"
}
],
"description": "站位名稱",
"xml": {
"name": "NameType"
}
},
"StationPosition": {
"title": "PointType",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.PointType"
}
],
"description": "站位位置",
"xml": {
"name": "PointType"
}
},
"StationAddress": {
"title": "String",
"type": "string",
"description": "站位地址",
"nullable": true,
"xml": {
"name": "StationAddress"
}
},
"StationGroupID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "站牌所屬的組站位ID",
"xml": {
"name": "StationGroupID"
}
},
"Stops": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.StationStop"
},
"description": "站牌與所行經此站牌之路線列表(資料會對路線展開,因此可能會有重複的站牌資料)",
"nullable": true,
"xml": {
"name": "Stop"
}
},
"LocationCityCode": {
"title": "String",
"type": "string",
"description": "站牌位置縣市之代碼(國際ISO 3166-2 三碼城市代碼)[若為公路/國道客運路線則為空值]",
"nullable": true,
"xml": {
"name": "LocationCityCode"
}
},
"Bearing": {
"title": "String",
"type": "string",
"description": "方位角,E:東行;W:西行;S:南行;N:北行;SE:東南行;NE:東北行;SW:西南行;NW:西北行",
"nullable": true,
"xml": {
"name": "Bearing"
}
},
"UpdateTime": {
"title": "DateTime",
"type": "string",
"description": "資料更新日期時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)",
"format": "date-time"
},
"VersionID": {
"title": "Int32",
"type": "integer",
"description": "資料版本編號",
"format": "int32"
}
},
"additionalProperties": false,
"description": "站牌/位資料型別",
"xml": {
"name": "BusStation"
}
},
"PTX.Service.DTO.Bus.Specification.V2.BusStation6": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusStation"
},
"PTX.Service.DTO.Bus.Specification.V2.StationStop": {
"title": "StationStop",
"required": [
"RouteID",
"RouteName",
"RouteUID",
"StopID",
"StopName",
"StopUID"
],
"type": "object",
"properties": {
"StopUID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "站牌唯一識別代碼,規則為 {業管機關簡碼} + {StopID},其中 {業管機關簡碼} 可於Authority API中的AuthorityCode欄位查詢",
"xml": {
"name": "StopUID"
}
},
"StopID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "地區既用中之站牌代碼(為原資料內碼)",
"xml": {
"name": "StopID"
}
},
"StopName": {
"title": "NameType",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType"
}
],
"description": "站牌名稱",
"xml": {
"name": "NameType"
}
},
"RouteUID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "路線唯一識別代碼,規則為 {業管機關簡碼} + {RouteID},其中 {業管機關簡碼} 可於Authority API中的AuthorityCode欄位查詢",
"xml": {
"name": "RouteUID"
}
},
"RouteID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "地區既用中之路線代碼(為原資料內碼)",
"xml": {
"name": "RouteID"
}
},
"RouteName": {
"title": "NameType",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType"
}
],
"description": "路線名稱",
"xml": {
"name": "NameType"
}
}
},
"additionalProperties": false,
"description": "站牌與路線資料型別",
"xml": {
"name": "StationStop"
}
},
"PTX.Service.DTO.Bus.Specification.V2.BusDisplayStopOfRoute": {
"title": "BusDisplayStopOfRoute",
"required": [
"RouteID",
"RouteName",
"RouteUID",
"Stops",
"UpdateTime",
"VersionID"
],
"type": "object",
"properties": {
"RouteUID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "路線唯一識別代碼,規則為 {業管機關代碼} + {RouteID},其中 {業管機關代碼} 可於Authority API中的AuthorityCode欄位查詢",
"xml": {
"name": "RouteUID"
}
},
"RouteID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "地區既用中之路線代碼(為原資料內碼)",
"xml": {
"name": "RouteID"
}
},
"RouteName": {
"title": "NameType",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType"
}
],
"description": "路線名稱",
"xml": {
"name": "NameType"
}
},
"Direction": {
"title": "Int32",
"type": "integer",
"description": "去返程 : [0:'去程',1:'返程',2:'迴圈',10:'循環線',255:'未知']",
"format": "int32"
},
"Stops": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.Embedded.Stop"
},
"description": "所有經過站牌",
"xml": {
"name": "Stop"
}
},
"UpdateTime": {
"title": "DateTime",
"type": "string",
"description": "資料更新日期時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)",
"format": "date-time"
},
"VersionID": {
"title": "Int32",
"type": "integer",
"description": "資料版本編號",
"format": "int32"
}
},
"additionalProperties": false,
"description": "顯示用路線站序資料",
"xml": {
"name": "BusDisplayStopOfRoute"
}
},
"PTX.Service.DTO.Bus.Specification.V2.BusDisplayStopOfRoute7": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusDisplayStopOfRoute"
},
"PTX.Service.DTO.Bus.Specification.V2.Embedded.Stop": {
"title": "Stop",
"required": [
"StationGroupID",
"StopID",
"StopName",
"StopPosition",
"StopSequence",
"StopUID"
],
"type": "object",
"properties": {
"StopUID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "站牌唯一識別代碼,規則為 {業管機關簡碼} + {StopID},其中 {業管機關簡碼} 可於Authority API中的AuthorityCode欄位查詢",
"xml": {
"name": "StopUID"
}
},
"StopID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "地區既用中之站牌代碼(為原資料內碼)",
"xml": {
"name": "StopID"
}
},
"StopName": {
"title": "NameType",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType"
}
],
"description": "站牌名稱",
"xml": {
"name": "NameType"
}
},
"StopBoarding": {
"title": "Int32",
"type": "integer",
"description": "上下車站別 : [-1:'可下車',0:'可上下車',1:'可上車']",
"format": "int32",
"nullable": true
},
"StopSequence": {
"title": "Int32",
"type": "integer",
"description": "路線經過站牌之順序",
"format": "int32"
},
"StopPosition": {
"title": "PointType",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.PointType"
}
],
"description": "站牌位置",
"xml": {
"name": "PointType"
}
},
"StationID": {
"title": "String",
"type": "string",
"description": "站牌所屬的站位ID",
"nullable": true,
"xml": {
"name": "StationID"
}
},
"StationGroupID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "站牌所屬的組站位ID",
"xml": {
"name": "StationGroupID"
}
},
"LocationCityCode": {
"title": "String",
"type": "string",
"description": "站牌位置縣市之代碼(國際ISO 3166-2 三碼城市代碼)[若為公路/國道客運路線則為空值]",
"nullable": true,
"xml": {
"name": "LocationCityCode"
}
}
},
"additionalProperties": false,
"description": "站牌代碼資料",
"xml": {
"name": "Stop"
}
},
"PTX.Service.DTO.Bus.Specification.V2.BusStopOfRoute": {
"title": "BusStopOfRoute",
"required": [
"RouteID",
"RouteName",
"RouteUID",
"Stops",
"SubRouteID",
"SubRouteName",
"SubRouteUID",
"UpdateTime",
"VersionID"
],
"type": "object",
"properties": {
"RouteUID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "路線唯一識別代碼,規則為 {業管機關簡碼} + {RouteID},其中 {業管機關簡碼} 可於Authority API中的AuthorityCode欄位查詢",
"xml": {
"name": "RouteUID"
}
},
"RouteID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "地區既用中之路線代碼(為原資料內碼)",
"xml": {
"name": "RouteID"
}
},
"RouteName": {
"title": "NameType",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType"
}
],
"description": "路線名稱",
"xml": {
"name": "NameType"
}
},
"Operators": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.Embedded.RouteOperator"
},
"description": "營運業者",
"nullable": true,
"xml": {
"name": "Operator"
}
},
"SubRouteUID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "附屬路線唯一識別代碼,規則為 {業管機關簡碼} + {SubRouteID},其中 {業管機關簡碼} 可於Authority API中的AuthorityCode欄位查詢",
"xml": {
"name": "SubRouteUID"
}
},
"SubRouteID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "地區既用中之附屬路線代碼(為原資料內碼)",
"xml": {
"name": "SubRouteID"
}
},
"SubRouteName": {
"title": "NameType",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType"
}
],
"description": "附屬路線名稱",
"xml": {
"name": "NameType"
}
},
"Direction": {
"title": "Int32",
"type": "integer",
"description": "去返程 : [0:'去程',1:'返程',2:'迴圈',10:'循環線',255:'未知']",
"format": "int32",
"nullable": true
},
"City": {
"title": "String",
"type": "string",
"description": "站牌權管所屬縣市(相當於市區公車API的City參數)[若為公路/國道客運路線則為空值]",
"nullable": true,
"xml": {
"name": "City"
}
},
"CityCode": {
"title": "String",
"type": "string",
"description": "站牌權管所屬縣市之代碼(國際ISO 3166-2 三碼城市代碼)[若為公路/國道客運路線則為空值]",
"nullable": true,
"xml": {
"name": "CityCode"
}
},
"Stops": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.Embedded.Stop"
},
"description": "所有經過站牌",
"xml": {
"name": "Stop"
}
},
"UpdateTime": {
"title": "DateTime",
"type": "string",
"description": "資料更新日期時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)",
"format": "date-time"
},
"VersionID": {
"title": "Int32",
"type": "integer",
"description": "資料版本編號",
"format": "int32"
}
},
"additionalProperties": false,
"description": "路線站序資料",
"xml": {
"name": "BusStopOfRoute"
}
},
"PTX.Service.DTO.Bus.Specification.V2.BusStopOfRoute8": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusStopOfRoute"
},
"PTX.Service.DTO.Bus.Specification.V2.BusSchedule": {
"title": "BusSchedule",
"required": [
"Direction",
"RouteID",
"RouteName",
"RouteUID",
"SubRouteID",
"SubRouteName",
"SubRouteUID",
"UpdateTime",
"VersionID"
],
"type": "object",
"properties": {
"RouteUID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "路線唯一識別代碼,規則為 {業管機關簡碼} + {RouteID},其中 {業管機關簡碼} 可於Authority API中的AuthorityCode欄位查詢",
"xml": {
"name": "RouteUID"
}
},
"RouteID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "地區既用中之路線代碼(為原資料內碼)",
"xml": {
"name": "RouteID"
}
},
"RouteName": {
"title": "NameType",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType"
}
],
"description": "路線名稱",
"xml": {
"name": "NameType"
}
},
"SubRouteUID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "附屬路線唯一識別代碼,規則為 {業管機關簡碼} + {SubRouteID},其中 {業管機關簡碼} 可於Authority API中的AuthorityCode欄位查詢",
"xml": {
"name": "SubRouteUID"
}
},
"SubRouteID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "地區既用中之附屬路線代碼(為原資料內碼)",
"xml": {
"name": "SubRouteID"
}
},
"SubRouteName": {
"title": "NameType",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType"
}
],
"description": "附屬路線名稱",
"xml": {
"name": "NameType"
}
},
"Direction": {
"title": "Int32",
"type": "integer",
"description": "去返程 : [0:'去程',1:'返程',2:'迴圈',10:'循環線',255:'未知']",
"format": "int32"
},
"OperatorID": {
"title": "String",
"type": "string",
"description": "營運業者代碼",
"nullable": true,
"xml": {
"name": "OperatorID"
}
},
"OperatorCode": {
"title": "String",
"type": "string",
"description": "營運業者簡碼",
"nullable": true,
"xml": {
"name": "OperatorCode"
}
},
"OperatorNo": {
"title": "String",
"type": "string",
"description": "營運業者編號[交通部票證資料系統定義]",
"nullable": true,
"xml": {
"name": "OperatorNo"
}
},
"Timetables": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusTimetable"
},
"description": "預定班表",
"nullable": true,
"xml": {
"name": "Timetable"
}
},
"Frequencys": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusFrequency"
},
"description": "發車班距",
"nullable": true,
"xml": {
"name": "Frequency"
}
},
"UpdateTime": {
"title": "DateTime",
"type": "string",
"description": "資料更新日期時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)",
"format": "date-time"
},
"VersionID": {
"title": "Int32",
"type": "integer",
"description": "資料版本編號",
"format": "int32"
}
},
"additionalProperties": false,
"description": "班表資料",
"xml": {
"name": "BusSchedule"
}
},
"PTX.Service.DTO.Bus.Specification.V2.BusSchedule9": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusSchedule"
},
"PTX.Service.DTO.Bus.Specification.V2.BusTimetable": {
"title": "BusTimetable",
"required": [
"StopTimes"
],
"type": "object",
"properties": {
"TripID": {
"title": "String",
"type": "string",
"description": "班次代碼",
"nullable": true,
"xml": {
"name": "TripID"
}
},
"IsLowFloor": {
"type": "boolean",
"description": "該路線班次是否使用低地板公車車輛",
"nullable": true
},
"ServiceDay": {
"title": "ServiceDay",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.Embedded.ServiceDay"
}
],
"description": "週內營運日",
"nullable": true,
"xml": {
"name": "ServiceDay"
}
},
"SpecialDays": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.SpecialDay"
},
"description": "特殊營運日",
"nullable": true,
"xml": {
"name": "SpecialDay"
}
},
"StopTimes": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusStopTime"
},
"description": "公車停靠時間資料",
"xml": {
"name": "StopTime"
}
}
},
"additionalProperties": false,
"description": "班次資料",
"xml": {
"name": "BusTimetable"
}
},
"PTX.Service.DTO.Bus.Specification.V2.SpecialDay": {
"title": "SpecialDay",
"type": "object",
"properties": {
"Dates": {
"title": "Array",
"type": "array",
"items": {
"title": "String",
"type": "string",
"xml": { }
},
"description": "不連續特殊日期",
"nullable": true,
"xml": {
"name": "List`1"
}
},
"DatePeriod": {
"title": "DatePeriod",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.DatePeriod"
}
],
"description": "連續特殊日期",
"nullable": true,
"xml": {
"name": "DatePeriod"
}
},
"ServiceStatus": {
"title": "Int32",
"type": "integer",
"description": "營運服務狀態代碼 : [0:'正常營運',1:'加班營運',2:'取消/停駛營運']",
"format": "int32"
},
"Description": {
"title": "String",
"type": "string",
"description": "特殊營運描述",
"nullable": true,
"xml": {
"name": "Description"
}
}
},
"additionalProperties": false,
"description": "特殊營運日資料",
"xml": {
"name": "SpecialDay"
}
},
"PTX.Service.DTO.Bus.Specification.V2.DatePeriod": {
"title": "DatePeriod",
"type": "object",
"properties": {
"StartDate": {
"title": "String",
"type": "string",
"description": "營運起始日(格式: yyyy-MM-dd)",
"nullable": true,
"xml": {
"name": "StartDate"
}
},
"EndDate": {
"title": "String",
"type": "string",
"description": "營運結束日(格式: yyyy-MM-dd)",
"nullable": true,
"xml": {
"name": "EndDate"
}
}
},
"additionalProperties": false,
"xml": {
"name": "DatePeriod"
}
},
"PTX.Service.DTO.Bus.Specification.V2.BusStopTime": {
"title": "BusStopTime",
"required": [
"ArrivalTime",
"DepartureTime",
"StopID",
"StopName",
"StopSequence",
"StopUID"
],
"type": "object",
"properties": {
"StopSequence": {
"title": "Int32",
"type": "integer",
"description": "路線經過站牌之順序(由1開始)",
"format": "int32"
},
"StopUID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "站牌唯一識別代碼,規則為 {業管機關代碼} + {StopID},其中 {業管機關代碼} 可於Authority API中的AuthorityCode欄位查詢",
"xml": {
"name": "StopUID"
}
},
"StopID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "地區既用中之站牌代碼(為原資料內碼)",
"xml": {
"name": "StopID"
}
},
"StopName": {
"title": "NameType",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType"
}
],
"description": "站牌名稱",
"xml": {
"name": "NameType"
}
},
"ArrivalTime": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "到站時間,格式為:HH:mm",
"xml": {
"name": "ArrivalTime"
}
},
"DepartureTime": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "離站時間,格式為:HH:mm",
"xml": {
"name": "DepartureTime"
}
}
},
"additionalProperties": false,
"description": "公車停靠時間資料",
"xml": {
"name": "BusStopTime"
}
},
"PTX.Service.DTO.Bus.Specification.V2.Embedded.ServiceDay": {
"title": "ServiceDay",
"required": [
"Friday",
"Monday",
"Saturday",
"Sunday",
"Thursday",
"Tuesday",
"Wednesday"
],
"type": "object",
"properties": {
"ServiceTag": {
"title": "String",
"type": "string",
"description": "服務日標籤",
"nullable": true,
"xml": {
"name": "ServiceTag"
}
},
"Sunday": {
"title": "Int32",
"type": "integer",
"description": "星期日是否營運 : [0:'否',1:'是']",
"format": "int32"
},
"Monday": {
"title": "Int32",
"type": "integer",
"description": "星期一是否營運 : [0:'否',1:'是']",
"format": "int32"
},
"Tuesday": {
"title": "Int32",
"type": "integer",
"description": "星期二是否營運 : [0:'否',1:'是']",
"format": "int32"
},
"Wednesday": {
"title": "Int32",
"type": "integer",
"description": "星期三是否營運 : [0:'否',1:'是']",
"format": "int32"
},
"Thursday": {
"title": "Int32",
"type": "integer",
"description": "星期四是否營運 : [0:'否',1:'是']",
"format": "int32"
},
"Friday": {
"title": "Int32",
"type": "integer",
"description": "星期五是否營運 : [0:'否',1:'是']",
"format": "int32"
},
"Saturday": {
"title": "Int32",
"type": "integer",
"description": "星期六是否營運 : [0:'否',1:'是']",
"format": "int32"
},
"NationalHolidays": {
"title": "Int32",
"type": "integer",
"description": "國定假日營運與否 : [0:'否',1:'是']",
"format": "int32",
"nullable": true
}
},
"additionalProperties": false,
"description": "週內營運日資料",
"xml": {
"name": "ServiceDay"
}
},
"PTX.Service.DTO.Bus.Specification.V2.BusFrequency": {
"title": "BusFrequency",
"required": [
"EndTime",
"MaxHeadwayMins",
"MinHeadwayMins",
"StartTime"
],
"type": "object",
"properties": {
"StartTime": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "發車班距起始適用時間,格式為: HH:mm",
"xml": {
"name": "StartTime"
}
},
"EndTime": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "發車班距結束適用時間,格式為: HH:mm",
"xml": {
"name": "EndTime"
}
},
"MinHeadwayMins": {
"title": "Int32",
"type": "integer",
"description": "最小班距時間(分鐘)",
"format": "int32"
},
"MaxHeadwayMins": {
"title": "Int32",
"type": "integer",
"description": "最大班距時間(分鐘)",
"format": "int32"
},
"ServiceDay": {
"title": "ServiceDay",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.Embedded.ServiceDay"
}
],
"description": "週內營運日",
"nullable": true,
"xml": {
"name": "ServiceDay"
}
},
"SpecialDays": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.SpecialDay"
},
"description": "特殊營運日",
"nullable": true,
"xml": {
"name": "SpecialDay"
}
}
},
"additionalProperties": false,
"description": "發車班距資料",
"xml": {
"name": "BusFrequency"
}
},
"PTX.Service.DTO.Bus.Specification.V2.BusVehicleInfo": {
"title": "BusVehicleInfo",
"required": [
"CardReaderLayout",
"HasLiftOrRamp",
"HasWifi",
"IsElectric",
"IsHybrid",
"IsLowFloor",
"OperatorCode",
"OperatorID",
"PlateNumb",
"UpdateTime",
"VehicleClass",
"VehicleType"
],
"type": "object",
"properties": {
"PlateNumb": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "車牌號碼",
"xml": {
"name": "PlateNumb"
}
},
"OperatorID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "營運業者代碼",
"xml": {
"name": "OperatorID"
}
},
"OperatorCode": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "營運業者簡碼",
"xml": {
"name": "OperatorCode"
}
},
"OperatorNo": {
"title": "String",
"type": "string",
"description": "營運業者編號[交通部票證資料系統定義]",
"nullable": true,
"xml": {
"name": "OperatorNo"
}
},
"VehicleClass": {
"title": "Int32",
"type": "integer",
"description": "車輛種類 : [1:'大型巴士',2:'中型巴士',3:'小型巴士',4:'雙層巴士',5:'雙節巴士',6:'營業用小客車',99:'其他']",
"format": "int32"
},
"VehicleType": {
"title": "Int32",
"type": "integer",
"description": "車輛種類 : [1:'一般',2:'復康巴士',3:'專車',4:'其他']",
"format": "int32"
},
"CardReaderLayout": {
"title": "Int32",
"type": "integer",
"description": "讀卡機配置(0:無讀卡機配置;1:前門刷卡;2:前後門刷卡)",
"format": "int32"
},
"IsElectric": {
"title": "Int32",
"type": "integer",
"description": "是否為電動公車 : [0:'否',1:'是']",
"format": "int32"
},
"IsHybrid": {
"title": "Int32",
"type": "integer",
"description": "是否為油電混合公車 : [0:'否',1:'是']",
"format": "int32"
},
"IsLowFloor": {
"title": "Int32",
"type": "integer",
"description": "是否為低地板 : [0:'否',1:'是']",
"format": "int32"
},
"HasLiftOrRamp": {
"title": "Int32",
"type": "integer",
"description": "是否有升降或斜坡板設備 : [0:'否',1:'是']",
"format": "int32"
},
"HasWifi": {
"title": "Int32",
"type": "integer",
"description": "是否有提供Wifi服務(-1: 未設定; 0: 無; 1: 有)",
"format": "int32"
},
"InBoxID": {
"title": "String",
"type": "string",
"description": "車機代號",
"nullable": true,
"xml": {
"name": "InBoxID"
}
},
"PurchaseTime": {
"type": "string",
"description": "購入時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)",
"format": "date-time",
"nullable": true
},
"UpdateTime": {
"title": "DateTime",
"type": "string",
"description": "資料更新日期時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)",
"format": "date-time"
}
},
"additionalProperties": false,
"description": "公車車輛基本資料",
"xml": {
"name": "BusVehicleInfo"
}
},
"PTX.Service.DTO.Bus.Specification.V2.BusVehicleInfo10": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusVehicleInfo"
},
"PTX.Service.DTO.Bus.Specification.V2.BusShape": {
"title": "BusShape",
"required": [
"EncodedPolyline",
"Geometry",
"RouteID",
"RouteName",
"RouteUID",
"SubRouteUID",
"UpdateTime",
"VersionID"
],
"type": "object",
"properties": {
"RouteUID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "路線唯一識別代碼,規則為 {業管機關簡碼} + {RouteID},其中 {業管機關簡碼} 可於Authority API中的AuthorityCode欄位查詢",
"xml": {
"name": "RouteUID"
}
},
"RouteID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "地區既用中之路線代碼(為原資料內碼)",
"xml": {
"name": "RouteID"
}
},
"RouteName": {
"title": "NameType",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType"
}
],
"description": "路線名稱",
"xml": {
"name": "NameType"
}
},
"SubRouteUID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "附屬路線唯一識別代碼,規則為 {業管機關簡碼} + {SubRouteID},其中 {業管機關簡碼} 可於Authority API中的AuthorityCode欄位查詢",
"xml": {
"name": "SubRouteUID"
}
},
"SubRouteID": {
"title": "String",
"type": "string",
"description": "附屬路線唯一識別代碼,規則為 {業管機關簡碼} + {SubRouteID},其中 {業管機關簡碼} 可於Authority API中的AuthorityCode欄位查詢",
"nullable": true,
"xml": {
"name": "SubRouteID"
}
},
"SubRouteName": {
"title": "NameType",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType"
}
],
"description": "附屬路線名稱",
"nullable": true,
"xml": {
"name": "NameType"
}
},
"Direction": {
"title": "Int32",
"type": "integer",
"description": "去返程,若無值則表示來源尚無區分去返程 : [0:'去程',1:'返程',2:'迴圈',10:'循環線',255:'未知']",
"format": "int32",
"nullable": true
},
"Geometry": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "well-known text,為路線軌跡資料",
"xml": {
"name": "Geometry"
}
},
"EncodedPolyline": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "路線軌跡編碼(encoded polyline)",
"xml": {
"name": "EncodedPolyline"
}
},
"UpdateTime": {
"title": "DateTime",
"type": "string",
"description": "資料更新日期時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)",
"format": "date-time"
},
"VersionID": {
"title": "Int32",
"type": "integer",
"description": "資料版本編號(由於該服務資料不再版控,固定帶入版號0)",
"format": "int32"
}
},
"additionalProperties": false,
"description": "公車線型資料",
"xml": {
"name": "BusShape"
}
},
"PTX.Service.DTO.Bus.Specification.V2.BusShape11": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusShape"
},
"PTX.Service.DTO.Bus.Specification.V2.BusRouteFare": {
"title": "BusRouteFare",
"required": [
"FarePricingType",
"IsForAllSubRoutes",
"IsFreeBus",
"OperatorID",
"RouteID",
"UpdateTime"
],
"type": "object",
"properties": {
"RouteID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "機關定義路線代號",
"xml": {
"name": "RouteID"
}
},
"RouteName": {
"title": "String",
"type": "string",
"description": "路線名稱",
"nullable": true,
"xml": {
"name": "RouteName"
}
},
"OperatorID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "營運業者代碼",
"xml": {
"name": "OperatorID"
}
},
"OperatorNo": {
"title": "String",
"type": "string",
"description": "營運業者編號[交通部票證資料系統定義]",
"nullable": true,
"xml": {
"name": "OperatorNo"
}
},
"SubRouteID": {
"title": "String",
"type": "string",
"description": "機關定義附屬路線代碼",
"nullable": true,
"xml": {
"name": "SubRouteID"
}
},
"SubRouteName": {
"title": "String",
"type": "string",
"description": "附屬路線名稱",
"nullable": true,
"xml": {
"name": "SubRouteName"
}
},
"FarePricingType": {
"title": "Int32",
"type": "integer",
"description": "描述該路線計費方式 : [0:'段次計費',1:'起迄站間計費',2:'計費站區間計費']",
"format": "int32"
},
"IsFreeBus": {
"title": "Int32",
"type": "integer",
"description": "是否為免費公車 : [0:'否',1:'是']",
"format": "int32"
},
"IsForAllSubRoutes": {
"title": "Int32",
"type": "integer",
"description": "該收費方式是否應用到所有附屬路線 : [0:'否',1:'是']",
"format": "int32"
},
"SectionFares": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.SectionFare"
},
"description": "段次計費",
"nullable": true,
"xml": {
"name": "SectionFare"
}
},
"StageFares": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusStageFare"
},
"description": "計費站區間計費",
"nullable": true,
"xml": {
"name": "StageFare"
}
},
"ODFares": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusODFare"
},
"description": "起迄站間計費",
"nullable": true,
"xml": {
"name": "ODFare"
}
},
"UpdateTime": {
"title": "DateTime",
"type": "string",
"description": "本平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)",
"format": "date-time"
}
},
"additionalProperties": false,
"description": "路線票價資料",
"xml": {
"name": "BusRouteFare"
}
},
"PTX.Service.DTO.Bus.Specification.V2.BusRouteFare12": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRouteFare"
},
"PTX.Service.DTO.Bus.Specification.V2.SectionFare": {
"title": "SectionFare",
"required": [
"Fares"
],
"type": "object",
"properties": {
"BufferZones": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.SectionFareBufferZone"
},
"description": "緩衝區資訊",
"nullable": true,
"xml": {
"name": "BufferZone"
}
},
"Fares": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusFare"
},
"description": "每段收費資訊",
"xml": {
"name": "Fare"
}
}
},
"additionalProperties": false,
"description": "段次計費",
"xml": {
"name": "SectionFare"
}
},
"PTX.Service.DTO.Bus.Specification.V2.SectionFareBufferZone": {
"title": "BufferZone",
"required": [
"Direction",
"FareBufferZoneDestination",
"FareBufferZoneOrigin",
"SectionSequence"
],
"type": "object",
"properties": {
"ZoneID": {
"title": "String",
"type": "string",
"description": "緩衝區代號",
"nullable": true,
"xml": {
"name": "ZoneID"
}
},
"SectionSequence": {
"title": "Int32",
"type": "integer",
"description": "緩衝區順序",
"format": "int32"
},
"Direction": {
"title": "Int32",
"type": "integer",
"description": "方向性描述 : [0:'去程',1:'返程',2:'迴圈',10:'循環線',255:'未知']",
"format": "int32"
},
"FareBufferZoneOrigin": {
"title": "Stop",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRouteFareStop"
}
],
"description": "緩衝區起點",
"xml": {
"name": "Stop"
}
},
"FareBufferZoneDestination": {
"title": "Stop",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRouteFareStop"
}
],
"description": "緩衝區迄點",
"xml": {
"name": "Stop"
}
},
"BufferZoneDescription": {
"title": "String",
"type": "string",
"description": "收費緩衝區描述",
"nullable": true,
"xml": {
"name": "BufferZoneDescription"
}
}
},
"additionalProperties": false,
"xml": {
"name": "BufferZone"
}
},
"PTX.Service.DTO.Bus.Specification.V2.BusRouteFareStop": {
"title": "Stop",
"required": [
"StopID",
"StopName"
],
"type": "object",
"properties": {
"StopID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "站牌代碼",
"xml": {
"name": "StopID"
}
},
"StopName": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "站牌名稱",
"xml": {
"name": "StopName"
}
},
"Sequence": {
"type": "integer",
"description": "站序",
"format": "int32",
"nullable": true
}
},
"additionalProperties": false,
"xml": {
"name": "Stop"
}
},
"PTX.Service.DTO.Bus.Specification.V2.BusFare": {
"title": "BusFare",
"required": [
"FareClass",
"Price",
"TicketType"
],
"type": "object",
"properties": {
"FareName": {
"title": "String",
"type": "string",
"description": "票價名稱",
"nullable": true,
"xml": {
"name": "FareName"
}
},
"TicketType": {
"title": "Int32",
"type": "integer",
"description": "票種類型 : [1:'一般票',2:'來回票',3:'電子票證',4:'回數票',5:'定期票30天期',6:'定期票60天期',7:'早鳥票',8:'定期票90天期']",
"format": "int32"
},
"FareClass": {
"title": "Int32",
"type": "integer",
"description": "費率等級 : [1:'成人',2:'學生',3:'孩童',4:'敬老',5:'愛心',6:'愛心孩童',7:'愛心優待或愛心陪伴',8:'團體',9:'軍警',10:'由各運業者自行定義的半票']",
"format": "int32"
},
"Price": {
"title": "Int32",
"type": "integer",
"description": "計費價格(新台幣),其中-1表示不提供售票服務",
"format": "int32"
},
"DiscountPeriods": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusDiscountPeriods"
},
"description": "優惠時段",
"nullable": true,
"xml": {
"name": "DiscountPeriod"
}
}
},
"additionalProperties": false,
"description": "票票價種類及費率說明",
"xml": {
"name": "BusFare"
}
},
"PTX.Service.DTO.Bus.Specification.V2.BusDiscountPeriods": {
"title": "BusDiscountPeriods",
"required": [
"EndTime",
"ServiceDay",
"StartTime"
],
"type": "object",
"properties": {
"ServiceDay": {
"title": "ServiceDay",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.Embedded.ServiceDay"
}
],
"description": "營運日型態",
"xml": {
"name": "ServiceDay"
}
},
"StartTime": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "開始時間(HH:mm制)",
"xml": {
"name": "StartTime"
}
},
"EndTime": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "結束時間(HH:mm制)",
"xml": {
"name": "EndTime"
}
}
},
"additionalProperties": false,
"description": "優惠時段",
"xml": {
"name": "BusDiscountPeriods"
}
},
"PTX.Service.DTO.Bus.Specification.V2.BusStageFare": {
"title": "BusStageFare",
"required": [
"DestinationStage",
"Direction",
"Fares",
"OriginStage"
],
"type": "object",
"properties": {
"Direction": {
"title": "Int32",
"type": "integer",
"description": "方向性描述 : [0:'去程',1:'返程',2:'迴圈',10:'循環線',255:'未知']",
"format": "int32"
},
"OriginStage": {
"title": "Stop",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRouteFareStop"
}
],
"description": "起點計費站",
"xml": {
"name": "Stop"
}
},
"DestinationStage": {
"title": "Stop",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRouteFareStop"
}
],
"description": "迄點計費站",
"xml": {
"name": "Stop"
}
},
"Fares": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusFare"
},
"description": "票價內容",
"xml": {
"name": "Fare"
}
}
},
"additionalProperties": false,
"description": "此計費方式以一路線內所有站牌分區收費。(公總稱之為計費站收費, Stage=計費站)",
"xml": {
"name": "BusStageFare"
}
},
"PTX.Service.DTO.Bus.Specification.V2.BusODFare": {
"title": "BusODFare",
"required": [
"DestinationStop",
"Direction",
"Fares",
"OriginStop"
],
"type": "object",
"properties": {
"Direction": {
"title": "Int32",
"type": "integer",
"description": "方向性描述 : [0:'去程',1:'返程',2:'迴圈',10:'循環線',255:'未知']",
"format": "int32"
},
"OriginStop": {
"title": "Stop",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRouteFareStop"
}
],
"description": "計費起點站牌資訊",
"xml": {
"name": "Stop"
}
},
"DestinationStop": {
"title": "Stop",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRouteFareStop"
}
],
"description": "計費迄點站牌資訊",
"xml": {
"name": "Stop"
}
},
"Fares": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusFare"
},
"description": "票價內容",
"xml": {
"name": "Fare"
}
}
},
"additionalProperties": false,
"description": "起迄站間計費",
"xml": {
"name": "BusODFare"
}
},
"PTX.Service.DTO.Bus.Specification.V2.BusNews": {
"title": "BusNews",
"required": [
"Description",
"EndTime",
"Language",
"NewsID",
"PublishTime",
"StartTime",
"Title",
"UpdateTime"
],
"type": "object",
"properties": {
"NewsID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "最新消息原單位發布代碼",
"xml": {
"name": "NewsID"
}
},
"Language": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "語系",
"xml": {
"name": "Language"
}
},
"Department": {
"title": "String",
"type": "string",
"description": "發布單位",
"nullable": true,
"xml": {
"name": "Department"
}
},
"Title": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "消息標題",
"xml": {
"name": "Title"
}
},
"NewsCategory": {
"title": "Int32",
"type": "integer",
"description": "消息類別 : [1:'最新消息',2:'新聞稿',3:'營運資訊',4:'轉乘資訊',5:'活動訊息',6:'系統公告',7:'通阻資訊',99:'其他']",
"format": "int32",
"nullable": true
},
"Description": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "內容描述",
"xml": {
"name": "Description"
}
},
"ContactName": {
"title": "String",
"type": "string",
"description": "聯絡人/單位",
"nullable": true,
"xml": {
"name": "ContactName"
}
},
"ContactPhone": {
"title": "String",
"type": "string",
"description": "聯絡電話",
"nullable": true,
"xml": {
"name": "ContactPhone"
}
},
"NewsURL": {
"title": "String",
"type": "string",
"description": "報導網站連結",
"nullable": true,
"xml": {
"name": "NewsURL"
}
},
"AttachmentURL": {
"title": "String",
"type": "string",
"description": "相關網站連結",
"nullable": true,
"xml": {
"name": "AttachmentURL"
}
},
"PublishTime": {
"title": "DateTime",
"type": "string",
"description": "消息公告日期時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)",
"format": "date-time"
},
"StartTime": {
"type": "string",
"description": "開始時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)",
"format": "date-time"
},
"EndTime": {
"type": "string",
"description": "結束時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)",
"format": "date-time"
},
"SrcUpdateTime": {
"type": "string",
"description": "來源端平台資料更新時間",
"format": "date-time",
"nullable": true
},
"UpdateTime": {
"title": "DateTime",
"type": "string",
"description": "本平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)",
"format": "date-time"
}
},
"additionalProperties": false,
"description": "公車最新消息資料",
"xml": {
"name": "BusNews"
}
},
"PTX.Service.DTO.Bus.Specification.V2.BusNews13": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusNews"
},
"PTX.Service.DTO.Bus.Specification.V2.BusStationGroup": {
"title": "BusStationGroup",
"required": [
"StationGroupID",
"StationGroupName",
"StationGroupPosition",
"StationGroupUID",
"UpdateTime",
"VersionID"
],
"type": "object",
"properties": {
"StationGroupUID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "組站位唯一識別代碼,規則為 {業管機關簡碼} + {StationGroupID},其中 {業管機關簡碼} 可於Authority API中的AuthorityCode欄位查詢",
"xml": {
"name": "StationGroupUID"
}
},
"StationGroupID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "組站位代碼",
"xml": {
"name": "StationGroupID"
}
},
"StationGroupName": {
"title": "NameType",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType"
}
],
"description": "組站位名稱",
"xml": {
"name": "NameType"
}
},
"StationGroupPosition": {
"title": "PointType",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.PointType"
}
],
"description": "組站位位置",
"xml": {
"name": "PointType"
}
},
"UpdateTime": {
"title": "DateTime",
"type": "string",
"description": "資料更新日期時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)",
"format": "date-time"
},
"VersionID": {
"title": "Int32",
"type": "integer",
"description": "資料版本編號",
"format": "int32"
}
},
"additionalProperties": false,
"description": "組站位資料型別",
"xml": {
"name": "BusStationGroup"
}
},
"PTX.Service.DTO.Bus.Specification.V2.BusStationGroup14": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusStationGroup"
},
"PTX.Service.DTO.Bus.Specification.V2.BusFirstLastTripInfo": {
"title": "BusFirstLastTripInfo",
"required": [
"Direction",
"FirstLastTrips",
"OperatorID",
"RouteID",
"RouteName",
"RouteUID",
"SubRouteID",
"SubRouteName",
"SubRouteUID",
"UpdateTime",
"VersionID"
],
"type": "object",
"properties": {
"RouteUID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "路線唯一識別代碼,規則為 {業管機關簡碼} + {RouteID},其中 {業管機關簡碼} 可於Authority API中的AuthorityCode欄位查詢",
"xml": {
"name": "RouteUID"
}
},
"RouteID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "地區既用中之路線代碼(為原資料內碼)",
"xml": {
"name": "RouteID"
}
},
"RouteName": {
"title": "NameType",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType"
}
],
"description": "路線名稱",
"xml": {
"name": "NameType"
}
},
"OperatorID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "營運業者代碼",
"xml": {
"name": "OperatorID"
}
},
"OperatorNo": {
"title": "String",
"type": "string",
"description": "營運業者編號[交通部票證資料系統定義]",
"nullable": true,
"xml": {
"name": "OperatorNo"
}
},
"SubRouteUID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "附屬路線唯一識別代碼,規則為 {業管機關簡碼} + {SubRouteID},其中 {業管機關簡碼} 可於Authority API中的AuthorityCode欄位查詢",
"xml": {
"name": "SubRouteUID"
}
},
"SubRouteID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "地區既用中之附屬路線代碼(為原資料內碼)",
"xml": {
"name": "SubRouteID"
}
},
"SubRouteName": {
"title": "NameType",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType"
}
],
"description": "附屬路線名稱",
"xml": {
"name": "NameType"
}
},
"Direction": {
"title": "Int32",
"type": "integer",
"description": "去返程 : [0:'去程',1:'返程',2:'迴圈',10:'循環線',255:'未知']",
"format": "int32"
},
"FirstLastTrips": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.FirstLastTrip"
},
"description": "首末班車",
"xml": {
"name": "FirstLastTrip"
}
},
"UpdateTime": {
"title": "DateTime",
"type": "string",
"description": "資料更新日期時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)",
"format": "date-time"
},
"VersionID": {
"title": "Int32",
"type": "integer",
"description": "資料版本編號",
"format": "int32"
}
},
"additionalProperties": false,
"description": "路線首末班車資料型別",
"xml": {
"name": "BusFirstLastTripInfo"
}
},
"PTX.Service.DTO.Bus.Specification.V2.BusFirstLastTripInfo15": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusFirstLastTripInfo"
},
"PTX.Service.DTO.Bus.Specification.V2.FirstLastTrip": {
"title": "FirstLastTrip",
"required": [
"FirstTripDepTime",
"LastTripDepTime",
"ServiceDay"
],
"type": "object",
"properties": {
"ServiceDay": {
"title": "ServiceDay",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusFirstLastTripInfoServiceDay"
}
],
"description": "服務日型態",
"xml": {
"name": "ServiceDay"
}
},
"FirstTripDepTime": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "頭班車發車時間(HH:mm)",
"xml": {
"name": "FirstTripDepTime"
}
},
"LastTripDepTime": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "末班車發車時間(HH:mm)",
"xml": {
"name": "LastTripDepTime"
}
}
},
"additionalProperties": false,
"description": "首末班車資料型別",
"xml": {
"name": "FirstLastTrip"
}
},
"PTX.Service.DTO.Bus.Specification.V2.BusFirstLastTripInfoServiceDay": {
"title": "ServiceDay",
"required": [
"Friday",
"Monday",
"Saturday",
"Sunday",
"Thursday",
"Tuesday",
"Wednesday"
],
"type": "object",
"properties": {
"ServiceTag": {
"title": "String",
"type": "string",
"description": "服務日標籤",
"nullable": true,
"xml": {
"name": "ServiceTag"
}
},
"Sunday": {
"title": "Int32",
"type": "integer",
"description": "星期日是否營運 : [0:'否',1:'是']",
"format": "int32"
},
"Monday": {
"title": "Int32",
"type": "integer",
"description": "星期一是否營運 : [0:'否',1:'是']",
"format": "int32"
},
"Tuesday": {
"title": "Int32",
"type": "integer",
"description": "星期二是否營運 : [0:'否',1:'是']",
"format": "int32"
},
"Wednesday": {
"title": "Int32",
"type": "integer",
"description": "星期三是否營運 : [0:'否',1:'是']",
"format": "int32"
},
"Thursday": {
"title": "Int32",
"type": "integer",
"description": "星期四是否營運 : [0:'否',1:'是']",
"format": "int32"
},
"Friday": {
"title": "Int32",
"type": "integer",
"description": "星期五是否營運 : [0:'否',1:'是']",
"format": "int32"
},
"Saturday": {
"title": "Int32",
"type": "integer",
"description": "星期六是否營運 : [0:'否',1:'是']",
"format": "int32"
},
"NationalHolidays": {
"title": "Int32",
"type": "integer",
"description": "國定假日營運與否 : [0:'否',1:'是']",
"format": "int32",
"nullable": true
},
"DayBeforeNationalHoliday": {
"title": "Int32",
"type": "integer",
"description": "國定假日前一日營運與否 : [0:'否',1:'是']",
"format": "int32",
"nullable": true
},
"DayAfterNationalHoliday": {
"title": "Int32",
"type": "integer",
"description": "國定假日後一日營運與否 : [0:'否',1:'是']",
"format": "int32",
"nullable": true
},
"TyphoonDay": {
"title": "Int32",
"type": "integer",
"description": "颱風停止上班上課期間營運與否 : [0:'否',1:'是']",
"format": "int32",
"nullable": true
}
},
"additionalProperties": false,
"xml": {
"name": "ServiceDay"
}
},
"PTX.Service.DTO.Bus.Specification.V2.BusAlert": {
"title": "BusAlert",
"required": [
"AlertID",
"Department",
"Description",
"EndTime",
"Scope",
"StartTime",
"Title"
],
"type": "object",
"properties": {
"AlertID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "通阻事件原單位發布代碼",
"xml": {
"name": "AlertID"
}
},
"Title": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "通阻標題",
"xml": {
"name": "Title"
}
},
"Description": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "事件描述",
"xml": {
"name": "Description"
}
},
"Department": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "發布單位",
"xml": {
"name": "Department"
}
},
"Status": {
"title": "Int32",
"type": "integer",
"description": "營運狀況 : [0:'全部營運停止',1:'全部營運正常',2:'有異常狀況']",
"format": "int32",
"nullable": true
},
"Cause": {
"title": "Int32",
"type": "integer",
"description": "原因 : [1:'事故(ACCIDENT)',2:'維護檢修(MAINTENANCE)',3:'技術問題(TECHNICAL_PROBLEM)',4:'施工(CONSTRUCTION)',5:'醫療緊急狀況(MEDICAL_EMERGENCY)',6:'氣候(WEATHER)',7:'示威遊行(DEMONSTRATION)',8:'政治活動/維安(POLICE_ACTIVITY)',9:'假日/節慶(HOLIDAY)',10:'罷工(STRIKE)',11:'活動(Activity)(如:國慶活動/煙火活動/跨年活動/路跑活動/新北耶誕城活動等)',254:'其他(OTHER_CAUSE)',255:'未知原因(UNKNOWN_CAUSE)']",
"format": "int32",
"nullable": true
},
"Effect": {
"title": "Int32",
"type": "integer",
"description": "影響 : [1:'車輛改道/站牌不停靠(DETOUR)',2:'服務(班次)增加(ADDITIONAL_SERVICE)',3:'服務(班次)減少(REDUCED_SERVICE)',4:'服務(班次)取消(NO_SERVICE)',5:'服務(班次)改變(MODIFIED_SERVICE)',6:'站點異動(STOP_MOVED)',7:'重大延遲(SIGNIFICANT_DELAYS)',254:'其他影響(OTHER_EFFECT)',255:'未知影響(UNKNOWN_EFFECT)']",
"format": "int32",
"nullable": true
},
"Scope": {
"title": "Scope",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.Scope"
}
],
"description": "通阻影響範圍",
"xml": {
"name": "Scope"
}
},
"AlertURL": {
"title": "String",
"type": "string",
"description": "詳細描述網站連結",
"nullable": true,
"xml": {
"name": "AlertURL"
}
},
"PublishTime": {
"type": "string",
"description": "消息公告日期時間",
"format": "date-time",
"nullable": true
},
"StartTime": {
"type": "string",
"description": "開始日期時間",
"format": "date-time"
},
"EndTime": {
"type": "string",
"description": "結束日期時間",
"format": "date-time"
},
"SrcUpdateTime": {
"title": "DateTime",
"type": "string",
"description": "[來源端平臺]此筆資料最後更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)",
"format": "date-time"
},
"UpdateTime": {
"title": "DateTime",
"type": "string",
"description": "本平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)",
"format": "date-time"
}
},
"additionalProperties": false,
"xml": {
"name": "BusAlert"
}
},
"PTX.Service.DTO.Bus.Specification.V2.BusAlert16": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusAlert"
},
"PTX.Service.DTO.Bus.Specification.V2.Scope": {
"title": "Scope",
"type": "object",
"properties": {
"Operators": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.ScopeOperator"
},
"description": "營運業者資料",
"nullable": true,
"xml": {
"name": "Operator"
}
},
"Stops": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.ScopeStop"
},
"description": "站牌資料",
"nullable": true,
"xml": {
"name": "Stop"
}
},
"Stations": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.ScopeStation"
},
"description": "站位資料",
"nullable": true,
"xml": {
"name": "Station"
}
},
"Routes": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.ScopeRoute"
},
"description": "路線資料",
"nullable": true,
"xml": {
"name": "Route"
}
},
"SubRoutes": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.ScopeSubRoute"
},
"description": "附屬路線資料",
"nullable": true,
"xml": {
"name": "SubRoute"
}
},
"Trips": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.ScopeTrip"
},
"description": "班次資料",
"nullable": true,
"xml": {
"name": "Trip"
}
}
},
"additionalProperties": false,
"description": "通阻影響範圍",
"xml": {
"name": "Scope"
}
},
"PTX.Service.DTO.Bus.Specification.V2.ScopeOperator": {
"title": "Operator",
"type": "object",
"properties": {
"OperatorID": {
"title": "String",
"type": "string",
"description": "營運業者代碼 ,",
"nullable": true,
"xml": {
"name": "OperatorID"
}
},
"OperatorName": {
"title": "NameType",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType"
}
],
"description": "營運業者名稱",
"nullable": true,
"xml": {
"name": "NameType"
}
}
},
"additionalProperties": false,
"description": "營運業者資料",
"xml": {
"name": "Operator"
}
},
"PTX.Service.DTO.Bus.Specification.V2.ScopeStop": {
"title": "Stop",
"type": "object",
"properties": {
"StopID": {
"title": "String",
"type": "string",
"description": "地區既用中之站牌代碼(為原資料內碼)",
"nullable": true,
"xml": {
"name": "StopID"
}
},
"StopName": {
"title": "NameType",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType"
}
],
"description": "站牌名稱",
"nullable": true,
"xml": {
"name": "NameType"
}
},
"StationID": {
"title": "String",
"type": "string",
"description": "站位代碼",
"nullable": true,
"xml": {
"name": "StationID"
}
}
},
"additionalProperties": false,
"description": "站牌資料",
"xml": {
"name": "Stop"
}
},
"PTX.Service.DTO.Bus.Specification.V2.ScopeStation": {
"title": "Station",
"type": "object",
"properties": {
"StationID": {
"title": "String",
"type": "string",
"description": "站位代碼",
"nullable": true,
"xml": {
"name": "StationID"
}
},
"StationName": {
"title": "NameType",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType"
}
],
"description": "站位名稱",
"nullable": true,
"xml": {
"name": "NameType"
}
}
},
"additionalProperties": false,
"description": "站位資料",
"xml": {
"name": "Station"
}
},
"PTX.Service.DTO.Bus.Specification.V2.ScopeRoute": {
"title": "Route",
"type": "object",
"properties": {
"RouteID": {
"title": "String",
"type": "string",
"description": "地區既用中之班次代碼(為原資料內碼)",
"nullable": true,
"xml": {
"name": "RouteID"
}
},
"RouteName": {
"title": "NameType",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType"
}
],
"description": "路線名稱",
"nullable": true,
"xml": {
"name": "NameType"
}
},
"Direction": {
"title": "Int32",
"type": "integer",
"description": "影響方向 : [0:'去程',1:'返程',2:'迴圈',10:'循環線',255:'未知']",
"format": "int32",
"nullable": true
}
},
"additionalProperties": false,
"description": "路線資料",
"xml": {
"name": "Route"
}
},
"PTX.Service.DTO.Bus.Specification.V2.ScopeSubRoute": {
"title": "SubRoute",
"type": "object",
"properties": {
"SubRouteID": {
"title": "String",
"type": "string",
"description": "地區既用中之附屬班次代碼(為原資料內碼)",
"nullable": true,
"xml": {
"name": "SubRouteID"
}
},
"SubRouteName": {
"title": "NameType",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType"
}
],
"description": "附屬路線名稱",
"nullable": true,
"xml": {
"name": "NameType"
}
},
"Direction": {
"title": "Int32",
"type": "integer",
"description": "影響方向 : [0:'去程',1:'返程',2:'迴圈',10:'循環線',255:'未知']",
"format": "int32",
"nullable": true
}
},
"additionalProperties": false,
"description": "附屬路線資料",
"xml": {
"name": "SubRoute"
}
},
"PTX.Service.DTO.Bus.Specification.V2.ScopeTrip": {
"title": "Trip",
"type": "object",
"properties": {
"TripID": {
"title": "String",
"type": "string",
"description": "地區既用中之班次代碼(為原資料內碼)",
"nullable": true,
"xml": {
"name": "TripID"
}
},
"RouteID": {
"title": "String",
"type": "string",
"description": "地區既用中之班次代碼(為原資料內碼)",
"nullable": true,
"xml": {
"name": "RouteID"
}
},
"SubRouteID": {
"title": "String",
"type": "string",
"description": "地區既用中之附屬班次代碼(為原資料內碼)",
"nullable": true,
"xml": {
"name": "SubRouteID"
}
},
"Direction": {
"title": "Int32",
"type": "integer",
"description": "影響方向 : [0:'去程',1:'返程',2:'迴圈',10:'循環線',255:'未知']",
"format": "int32",
"nullable": true
},
"TripDepTime": {
"title": "String",
"type": "string",
"description": "首站發車時間(HH:mm)",
"nullable": true,
"xml": {
"name": "TripDepTime"
}
}
},
"additionalProperties": false,
"description": "班次代碼資料",
"xml": {
"name": "Trip"
}
},
"PTX.Service.DTO.Bus.Specification.V2.BusRouteNetwork": {
"title": "BusRouteNetwork",
"required": [
"RouteID",
"RouteName",
"RouteUID",
"Segments",
"UpdateTime",
"VersionID"
],
"type": "object",
"properties": {
"RouteUID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "路線唯一識別代碼,規則為 {業管機關簡碼} + {RouteID},其中 {業管機關簡碼} 可於Authority API中的AuthorityCode欄位查詢",
"xml": {
"name": "RouteUID"
}
},
"RouteID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "地區既用中之路線代碼(為原資料內碼)",
"xml": {
"name": "RouteID"
}
},
"RouteName": {
"title": "NameType",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType"
}
],
"description": "路線名稱",
"xml": {
"name": "NameType"
}
},
"Segments": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRouteNetworkSegment"
},
"description": "站間線段序號",
"xml": {
"name": "Segment"
}
},
"UpdateTime": {
"title": "DateTime",
"type": "string",
"description": "資料更新日期時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)",
"format": "date-time"
},
"VersionID": {
"title": "Int32",
"type": "integer",
"description": "資料版本編號",
"format": "int32"
}
},
"additionalProperties": false,
"xml": {
"name": "BusRouteNetwork"
}
},
"PTX.Service.DTO.Bus.Specification.V2.BusRouteNetwork17": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRouteNetwork"
},
"PTX.Service.DTO.Bus.Specification.V2.BusRouteNetworkSegment": {
"title": "Segment",
"required": [
"Distance",
"FromStationID",
"Sequence",
"ToStationID"
],
"type": "object",
"properties": {
"Sequence": {
"title": "Single",
"type": "number",
"description": "站間線段序號",
"format": "float"
},
"FromStationID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "表BusStation唯一碼(起點站牌)",
"xml": {
"name": "FromStationID"
}
},
"ToStationID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "表BusStation唯一碼(迄點站牌)",
"xml": {
"name": "ToStationID"
}
},
"Distance": {
"title": "Single",
"type": "number",
"description": "站間線段距離",
"format": "float"
}
},
"additionalProperties": false,
"xml": {
"name": "Segment"
}
},
"PTX.Service.DTO.Bus.Specification.V2.BusS2STravelTime": {
"title": "BusS2STravelTime",
"required": [
"Direction",
"RouteID",
"RouteUID",
"SubRouteID",
"SubRouteUID",
"TravelTimes",
"UpdateTime"
],
"type": "object",
"properties": {
"RouteUID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "路線唯一識別代碼,規則為 {業管機關簡碼} + {RouteID},其中 {業管機關簡碼} 可於Authority API中的AuthorityCode欄位查詢",
"xml": {
"name": "RouteUID"
}
},
"RouteID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "地區既用中之路線代碼(為原資料內碼)",
"xml": {
"name": "RouteID"
}
},
"SubRouteUID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "附屬路線唯一識別代碼,規則為 {業管機關簡碼} + {SubRouteID},其中 {業管機關簡碼} 可於Authority API中的AuthorityCode欄位查詢",
"xml": {
"name": "SubRouteUID"
}
},
"SubRouteID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "地區既用中之附屬路線代碼(為原資料內碼)",
"xml": {
"name": "SubRouteID"
}
},
"Direction": {
"title": "Int32",
"type": "integer",
"description": "去返程 : [0:'去程',1:'返程',2:'迴圈',10:'循環線',255:'未知']",
"format": "int32"
},
"TravelTimes": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.ServiceTime"
},
"description": "旅行時間資訊",
"xml": {
"name": "TravelTime"
}
},
"UpdateTime": {
"title": "DateTime",
"type": "string",
"description": "資料更新日期時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)",
"format": "date-time"
}
},
"additionalProperties": false,
"description": "站間旅行時間資料型別",
"xml": {
"name": "BusS2STravelTime"
}
},
"PTX.Service.DTO.Bus.Specification.V2.BusS2STravelTime18": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusS2STravelTime"
},
"PTX.Service.DTO.Bus.Specification.V2.ServiceTime": {
"title": "ServiceTime",
"required": [
"EndHour",
"S2STimes",
"StartHour",
"Weekday"
],
"type": "object",
"properties": {
"Weekday": {
"title": "Int32",
"type": "integer",
"description": "星期 : [0:星期日, 1:星期一, 2:星期二, 3:星期三, 4:星期四, 5:星期五, 6:星期六, 99:不分星期]",
"format": "int32"
},
"StartHour": {
"title": "Int32",
"type": "integer",
"description": "起始時區(小時)",
"format": "int32"
},
"EndHour": {
"title": "Int32",
"type": "integer",
"description": "結束時區(小時)",
"format": "int32"
},
"S2STimes": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.TravelTime"
},
"description": "站間行駛時間資訊",
"xml": {
"name": "S2STime"
}
}
},
"additionalProperties": false,
"description": "行駛時間資料型別",
"xml": {
"name": "ServiceTime"
}
},
"PTX.Service.DTO.Bus.Specification.V2.TravelTime": {
"title": "TravelTime",
"required": [
"FromStationID",
"FromStopID",
"RunTime",
"ToStationID",
"ToStopID"
],
"type": "object",
"properties": {
"FromStopID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "起始站牌代碼",
"xml": {
"name": "FromStopID"
}
},
"ToStopID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "終點站牌代碼",
"xml": {
"name": "ToStopID"
}
},
"FromStationID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "起始站位代碼",
"xml": {
"name": "FromStationID"
}
},
"ToStationID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "終點站位代碼",
"xml": {
"name": "ToStationID"
}
},
"RunTime": {
"title": "Int32",
"type": "integer",
"description": "站間預估行駛時間 [當RunTime值為-1時,代表該區間無提供旅行時間資料。]",
"format": "int32"
}
},
"additionalProperties": false,
"xml": {
"name": "TravelTime"
}
},
"PTX.Service.DTO.Bus.Specification.V2.BusRouteTPASS": {
"title": "BusRouteTPASS",
"required": [
"Operators",
"RouteID",
"RouteName",
"SubRouteID",
"SubRouteName"
],
"type": "object",
"properties": {
"RouteID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "機關定義路線代號",
"xml": {
"name": "RouteID"
}
},
"RouteName": {
"title": "NameType",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType"
}
],
"description": "路線名稱",
"xml": {
"name": "NameType"
}
},
"SubRouteID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "機關定義附屬路線代號",
"xml": {
"name": "SubRouteID"
}
},
"SubRouteName": {
"title": "NameType",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType"
}
],
"description": "附屬路線名稱",
"xml": {
"name": "NameType"
}
},
"Operators": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRouteTPASSOperator"
},
"description": "營運業者",
"xml": {
"name": "Operator"
}
}
},
"additionalProperties": false,
"description": "路線適用通勤月票方案資料",
"xml": {
"name": "BusRouteTPASS"
}
},
"PTX.Service.DTO.Bus.Specification.V2.BusRouteTPASS19": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusRouteTPASS"
},
"PTX.Service.DTO.Bus.Specification.V2.BusRouteTPASSOperator": {
"title": "Operator",
"required": [
"OperatorID",
"OperatorName",
"OperatorNo"
],
"type": "object",
"properties": {
"OperatorID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "營運業者代碼",
"xml": {
"name": "OperatorID"
}
},
"OperatorNo": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "營運業者編號",
"xml": {
"name": "OperatorNo"
}
},
"OperatorName": {
"title": "NameType",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType"
}
],
"description": "營運業者名稱",
"xml": {
"name": "NameType"
}
}
},
"additionalProperties": false,
"description": "營運業者資料",
"xml": {
"name": "Operator"
}
},
"PTX.Service.DTO.Bus.Specification.V2.BusDailyTimeTable": {
"title": "BusDailyTimeTable",
"required": [
"BusDate",
"Direction",
"OperatorID",
"RouteID",
"RouteName",
"RouteUID",
"SubRouteID",
"UpdateTime"
],
"type": "object",
"properties": {
"BusDate": {
"title": "DateTime",
"type": "string",
"description": "適用日期",
"format": "date-time"
},
"RouteUID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "路線唯一識別代碼,規則為 {業管機關簡碼} + {RouteID},其中 {業管機關簡碼} 可於Authority API中的AuthorityCode欄位查詢",
"xml": {
"name": "RouteUID"
}
},
"RouteID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "地區既用中之路線代碼(為原資料內碼)",
"xml": {
"name": "RouteID"
}
},
"RouteName": {
"title": "NameType",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType"
}
],
"description": "路線名稱",
"xml": {
"name": "NameType"
}
},
"OperatorID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "營運業者代碼",
"xml": {
"name": "OperatorID"
}
},
"OperatorNo": {
"title": "String",
"type": "string",
"description": "營運業者編號[交通部票證資料系統定義]",
"nullable": true,
"xml": {
"name": "OperatorNo"
}
},
"OperatorCode": {
"title": "String",
"type": "string",
"description": "營運業者簡碼",
"nullable": true,
"xml": {
"name": "OperatorCode"
}
},
"SubRouteUID": {
"title": "String",
"type": "string",
"description": "附屬路線唯一識別代碼,規則為 {業管機關簡碼} + {SubRouteID},其中 {業管機關簡碼} 可於Authority API中的AuthorityCode欄位查詢",
"nullable": true,
"xml": {
"name": "SubRouteUID"
}
},
"SubRouteID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "地區既用中之附屬路線代碼(為原資料內碼)",
"xml": {
"name": "SubRouteID"
}
},
"SubRouteName": {
"title": "NameType",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType"
}
],
"description": "附屬路線名稱",
"nullable": true,
"xml": {
"name": "NameType"
}
},
"Direction": {
"title": "Int32",
"type": "integer",
"description": "去返程 : [0:'去程',1:'返程',2:'迴圈',10:'循環線',255:'未知']",
"format": "int32"
},
"Timetables": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusDailyTimeTableTimeTable"
},
"description": "預定班表",
"nullable": true,
"xml": {
"name": "TimeTable"
}
},
"UpdateTime": {
"title": "DateTime",
"type": "string",
"description": "資料更新日期時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)",
"format": "date-time"
}
},
"additionalProperties": false,
"xml": {
"name": "BusDailyTimeTable"
}
},
"PTX.Service.DTO.Bus.Specification.V2.BusDailyTimeTable20": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusDailyTimeTable"
},
"PTX.Service.DTO.Bus.Specification.V2.BusDailyTimeTableTimeTable": {
"title": "TimeTable",
"required": [
"StopTimes"
],
"type": "object",
"properties": {
"TripID": {
"title": "String",
"type": "string",
"description": "班次代碼",
"nullable": true,
"xml": {
"name": "TripID"
}
},
"StopTimes": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusDailyTimeTableStopTime"
},
"description": "公車停靠時間資料",
"xml": {
"name": "StopTime"
}
}
},
"additionalProperties": false,
"xml": {
"name": "TimeTable"
}
},
"PTX.Service.DTO.Bus.Specification.V2.BusDailyTimeTableStopTime": {
"title": "StopTime",
"required": [
"ArrivalTime",
"DepartureTime",
"StopID",
"StopSequence",
"StopUID",
"TimeType"
],
"type": "object",
"properties": {
"StopSequence": {
"title": "Int32",
"type": "integer",
"description": "路線經過站牌之順序(由1開始)",
"format": "int32"
},
"StopUID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "站牌唯一識別代碼,規則為 {業管機關代碼} + {StopID},其中 {業管機關代碼} 可於Authority API中的AuthorityCode欄位查詢",
"xml": {
"name": "StopUID"
}
},
"StopID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "地區既用中之站牌代碼(為原資料內碼)",
"xml": {
"name": "StopID"
}
},
"StopName": {
"title": "NameType",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType"
}
],
"description": "站牌名稱",
"nullable": true,
"xml": {
"name": "NameType"
}
},
"ArrivalTime": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "到站時間,格式為:HH:mm",
"xml": {
"name": "ArrivalTime"
}
},
"DepartureTime": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "離站時間,格式為:HH:mm",
"xml": {
"name": "DepartureTime"
}
},
"TimeType": {
"title": "Int32",
"type": "integer",
"description": "時刻表時間類型 : [0:'估算時間',1:'表訂時間']",
"format": "int32"
}
},
"additionalProperties": false,
"xml": {
"name": "StopTime"
}
},
"PTX.Service.DTO.Bus.Specification.V2.BusDailyStopTimeTable": {
"title": "BusDailyStopTimeTable",
"required": [
"BusDate",
"DestinationStopID",
"OperatorID",
"RouteID",
"RouteName",
"RouteUID",
"Stops",
"SubRouteID",
"SubRouteUID",
"UpdateTime"
],
"type": "object",
"properties": {
"BusDate": {
"title": "DateTime",
"type": "string",
"description": "適用日期",
"format": "date-time"
},
"RouteUID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "路線唯一識別代碼,規則為 {業管機關簡碼} + {RouteID},其中 {業管機關簡碼} 可於Authority API中的AuthorityCode欄位查詢",
"xml": {
"name": "RouteUID"
}
},
"RouteID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "地區既用中之路線代碼(為原資料內碼)",
"xml": {
"name": "RouteID"
}
},
"RouteName": {
"title": "NameType",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType"
}
],
"description": "路線名稱",
"xml": {
"name": "NameType"
}
},
"OperatorID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "營運業者代碼",
"xml": {
"name": "OperatorID"
}
},
"OperatorCode": {
"title": "String",
"type": "string",
"description": "營運業者簡碼",
"nullable": true,
"xml": {
"name": "OperatorCode"
}
},
"SubRouteUID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "附屬路線唯一識別代碼,規則為 {業管機關簡碼} + {SubRouteID},其中 {業管機關簡碼} 可於Authority API中的AuthorityCode欄位查詢",
"xml": {
"name": "SubRouteUID"
}
},
"SubRouteID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "地區既用中之附屬路線代碼(為原資料內碼)",
"xml": {
"name": "SubRouteID"
}
},
"SubRouteName": {
"title": "NameType",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType"
}
],
"description": "附屬路線名稱",
"nullable": true,
"xml": {
"name": "NameType"
}
},
"DestinationStopID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "迄點站站牌代碼,機關定義站牌代號(為原資料內碼)",
"xml": {
"name": "DestinationStopID"
}
},
"DestinationStopName": {
"title": "NameType",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType"
}
],
"description": "迄點站站牌名稱",
"nullable": true,
"xml": {
"name": "NameType"
}
},
"Stops": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusDailyStopTimeTableStop"
},
"description": "公車站牌停靠資料",
"xml": {
"name": "Stop"
}
},
"UpdateTime": {
"title": "DateTime",
"type": "string",
"description": "資料更新日期時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)",
"format": "date-time"
}
},
"additionalProperties": false,
"xml": {
"name": "BusDailyStopTimeTable"
}
},
"PTX.Service.DTO.Bus.Specification.V2.BusDailyStopTimeTable21": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusDailyStopTimeTable"
},
"PTX.Service.DTO.Bus.Specification.V2.BusDailyStopTimeTableStop": {
"title": "Stop",
"required": [
"StopID",
"StopUID"
],
"type": "object",
"properties": {
"StopUID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "站牌唯一識別代碼,規則為 {業管機關代碼} + {StopID},其中 {業管機關代碼} 可於Authority API中的AuthorityCode欄位查詢",
"xml": {
"name": "StopUID"
}
},
"StopID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "地區既用中之站牌代碼(為原資料內碼)",
"xml": {
"name": "StopID"
}
},
"StopName": {
"title": "NameType",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType"
}
],
"description": "站牌名稱",
"nullable": true,
"xml": {
"name": "NameType"
}
},
"TimeTables": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Bus.Specification.V2.BusDailyStopTimeTableTimeTable"
},
"description": "預定班表",
"nullable": true,
"xml": {
"name": "TimeTable"
}
}
},
"additionalProperties": false,
"xml": {
"name": "Stop"
}
},
"PTX.Service.DTO.Bus.Specification.V2.BusDailyStopTimeTableTimeTable": {
"title": "TimeTable",
"required": [
"ArrivalTime",
"DepartureTime",
"Sequence",
"TimeType"
],
"type": "object",
"properties": {
"Sequence": {
"title": "Int32",
"type": "integer",
"description": "發車順序(由1開始)",
"format": "int32"
},
"TripID": {
"title": "String",
"type": "string",
"description": "班次代碼",
"nullable": true,
"xml": {
"name": "TripID"
}
},
"IsLowFloor": {
"type": "boolean",
"description": "該路線班次是否使用低地板公車車輛 , 0 = 否 , 1 = 是",
"nullable": true
},
"ArrivalTime": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "到站時間,格式為:HH:mm",
"xml": {
"name": "ArrivalTime"
}
},
"DepartureTime": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "離站時間,格式為:HH:mm",
"xml": {
"name": "DepartureTime"
}
},
"TimeType": {
"title": "Int32",
"type": "integer",
"description": "時刻表時間類型 : [0:'估算時間',1:'表訂時間']",
"format": "int32"
}
},
"additionalProperties": false,
"xml": {
"name": "TimeTable"
}
}
},
"securitySchemes": {
"TDX": {
"type": "oauth2",
"description": "TDX會員可至【會員專區-資料服務-服務金鑰】功能頁面,從預設金鑰(或建立新的金鑰)取得Client Id和Client Secret資訊,分別輸入至下方client_id和client_secret欄位、按下Authorize按鈕,即可開始於Swagger介面呼叫TDX API。",
"flows": {
"clientCredentials": {
"tokenUrl": "https://tdx.transportdata.tw/auth/realms/TDXConnect/protocol/openid-connect/token",
"scopes": { }
}
}
}
}
},
"security": [
{
"TDX": [ ]
}
],
"tags": [
{
"name": "CityBus",
"description": "市區公車"
},
{
"name": "InterCityBus",
"description": "公路客運"
},
{
"name": "Bus(CityBus+InterCityBus)",
"description": "公車(市區公車+公路客運)"
}
]
}