{
"openapi": "3.0.4",
"info": {
"title": "觀光資訊",
"description": "本平臺提供涵蓋全國尺度之交通旅運資料服務API，歡迎各產政學單位介接使用。\n
利用本平臺開放資料進行各項應用服務開發時，請考量不同特性使用者(如：性別/身心障礙/老幼等)的需求，並歡迎回饋寶貴意見。\n
計費方式：\n
計次：1,500次/1點\n
計量：150MB/1點\n---\n##### API使用說明與注意事項：\n1. 如您尚未註冊平臺會員帳號，或未以帳號登入，您將僅能以「訪客模式」使用平臺服務，包含：限以瀏覽器存取，限使用`【基礎服務】`，且限制每個呼叫來源端IP每日存取至多20次。。\n2. 如您已註冊平臺會員帳號，請務必確保在存取服務(包含瀏覽器、程式呼叫API)時帶入您的API金鑰，方能以「會員模式」使用完整平臺服務，包含平臺各類資料服務，如`【基礎服務】`、`【進階服務】`、`【加值服務】`、`【歷史服務】`、`【圖資服務】`、`【第三方服務】`等。\n3. 建議您立即[註冊平臺會員帳號](/register)，依您用量需求訂閱服務方案，並於[【會員中心->資料服務->API金鑰】](/user/dataservice/key)取得API金鑰(即Client Id和Client Secret資訊)。\n4. 會員訂閱服務方案之級別不同，將決定其API金鑰之存取頻率有不同限制，各個方案的存取頻率限制說明請參考[訂閱收費](/pricing)。\n5. 以瀏覽器帶入API金鑰之操作方式：請點選Swagger UI上的Authorize按鈕，依指示填入Client Id和Client Secret資訊並進行驗證，驗證完成後可開始於Swagger UI使用API。\n6. 以程式呼叫API帶入API金鑰之操作方式：請參考[範例程式](https://github.com/tdxmotc/SampleCode)。\n7. 不論您是以瀏覽器或是以程式呼叫API，所有服務存取行為均將被記錄並定期檢視，以確保系統資源使用的合理分配與避免遭受濫用。\n\nAPI OAS文本 :[請點我](https://tdx.transportdata.tw/webapi/File/Swagger/V3/cd0226cf-6292-4c35-8a0d-b595f0b15352)",
"termsOfService": "https://tdx.transportdata.tw/term",
"contact": {
"name": "TDX客服信箱",
"email": "tdx@motc.gov.tw"
},
"version": "v2"
},
"servers": [
{
"url": "https://tdx.transportdata.tw/api/basic"
}
],
"paths": {
"/v2/Tourism/ScenicSpot": {
"get": {
"tags": [
"Tourism"
],
"summary": "取得所有觀光景點資料",
"description": "取得所有觀光景點資料",
"operationId": "TourismApi_ScenicSpot_2240",
"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.Tourism.Specification.V2.ScenicSpotTourismInfo"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.Specification.V2.ScenicSpotTourismInfo"
},
"xml": {
"name": "ArrayOfScenicSpotTourismInfo",
"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/Tourism/ScenicSpot/{City}": {
"get": {
"tags": [
"Tourism"
],
"summary": "取得指定[縣市]觀光景點資料",
"description": "取得指定[縣市]觀光景點資料",
"operationId": "TourismApi_ScenicSpot_2240_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": "$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.Tourism.Specification.V2.ScenicSpotTourismInfo"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.Specification.V2.ScenicSpotTourismInfo"
},
"xml": {
"name": "ArrayOfScenicSpotTourismInfo",
"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/Tourism/Restaurant": {
"get": {
"tags": [
"Tourism"
],
"summary": "取得所有觀光餐飲資料",
"description": "取得所有觀光餐飲資料",
"operationId": "TourismApi_Restaurant_2242",
"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.Tourism.Specification.V2.RestaurantTourismInfo"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.Specification.V2.RestaurantTourismInfo"
},
"xml": {
"name": "ArrayOfRestaurantTourismInfo",
"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/Tourism/Restaurant/{City}": {
"get": {
"tags": [
"Tourism"
],
"summary": "取得指定[縣市]觀光餐飲資料",
"description": "取得指定[縣市]觀光餐飲資料",
"operationId": "TourismApi_Restaurant_2242_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": "$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.Tourism.Specification.V2.RestaurantTourismInfo"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.Specification.V2.RestaurantTourismInfo"
},
"xml": {
"name": "ArrayOfRestaurantTourismInfo",
"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/Tourism/Hotel": {
"get": {
"tags": [
"Tourism"
],
"summary": "取得所有觀光旅宿資料",
"description": "取得所有觀光旅宿資料",
"operationId": "TourismApi_Hotel_2244",
"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.Tourism.Specification.V2.HotelTourismInfo"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.Specification.V2.HotelTourismInfo"
},
"xml": {
"name": "ArrayOfHotelTourismInfo",
"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/Tourism/Hotel/{City}": {
"get": {
"tags": [
"Tourism"
],
"summary": "取得指定[縣市]觀光旅宿資料",
"description": "取得指定[縣市]觀光旅宿資料",
"operationId": "TourismApi_Hotel_2244_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": "$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.Tourism.Specification.V2.HotelTourismInfo"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.Specification.V2.HotelTourismInfo"
},
"xml": {
"name": "ArrayOfHotelTourismInfo",
"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/Tourism/Activity": {
"get": {
"tags": [
"Tourism"
],
"summary": "取得所有觀光活動資料",
"description": "取得所有觀光活動資料",
"operationId": "TourismApi_Activity_2246",
"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.Tourism.Specification.V2.ActivityTourismInfo"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.Specification.V2.ActivityTourismInfo"
},
"xml": {
"name": "ArrayOfActivityTourismInfo",
"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/Tourism/Activity/{City}": {
"get": {
"tags": [
"Tourism"
],
"summary": "取得指定[縣市]觀光活動資料",
"description": "取得指定[縣市]觀光活動資料",
"operationId": "TourismApi_Activity_2246_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": "$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.Tourism.Specification.V2.ActivityTourismInfo"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.Specification.V2.ActivityTourismInfo"
},
"xml": {
"name": "ArrayOfActivityTourismInfo",
"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/Tourism/Bus/RealTimeByFrequency/TaiwanTrip": {
"get": {
"tags": [
"Tourism"
],
"summary": "取得台灣好行公車的動態定時資料(A1)",
"description": "取得台灣好行公車的動態定時資料(A1)",
"operationId": "TaiwanTripBusApi_RealTimeByFrequency_2260",
"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.Tourism.Specification.V2.BusA1Data"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.Specification.V2.BusA1Data"
},
"xml": {
"name": "ArrayOfBusA1Data",
"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/Tourism/Bus/RealTimeByFrequency/TaiwanTrip/{TaiwanTripName}": {
"get": {
"tags": [
"Tourism"
],
"summary": "取得指定[路線名稱]的台灣好行公車的動態定時資料(A1)",
"description": "取得指定[路線名稱]的台灣好行公車的動態定時資料(A1)",
"operationId": "TaiwanTripBusApi_RealTimeByFrequency_2260_1",
"parameters": [
{
"name": "TaiwanTripName",
"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.Tourism.Specification.V2.BusA1Data"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.Specification.V2.BusA1Data"
},
"xml": {
"name": "ArrayOfBusA1Data",
"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/Tourism/Bus/RealTimeNearStop/TaiwanTrip": {
"get": {
"tags": [
"Tourism"
],
"summary": "取得台灣好行公車的動態定點資料(A2)",
"description": "取得台灣好行公車的動態定點資料(A2)",
"operationId": "TaiwanTripBusApi_RealTimeNearStop_2261",
"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.Tourism.Specification.V2.BusA2Data"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.Specification.V2.BusA2Data"
},
"xml": {
"name": "ArrayOfBusA2Data",
"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/Tourism/Bus/RealTimeNearStop/TaiwanTrip/{TaiwanTripName}": {
"get": {
"tags": [
"Tourism"
],
"summary": "取得指定[路線名稱]的台灣好行公車的動態定點資料(A2)",
"description": "取得指定[路線名稱]的台灣好行公車的動態定點資料(A2)",
"operationId": "TaiwanTripBusApi_RealTimeNearStop_2261_1",
"parameters": [
{
"name": "TaiwanTripName",
"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.Tourism.Specification.V2.BusA2Data"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.Specification.V2.BusA2Data"
},
"xml": {
"name": "ArrayOfBusA2Data",
"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/Tourism/Bus/EstimatedTimeOfArrival/TaiwanTrip": {
"get": {
"tags": [
"Tourism"
],
"summary": "取得台灣好行公車的預估到站資料(N1)",
"description": "取得台灣好行公車的預估到站資料(N1)",
"operationId": "TaiwanTripBusApi_EstimatedTimeOfArrival_2262",
"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.Tourism.Specification.V2.BusN1EstimateTime"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.Specification.V2.BusN1EstimateTime"
},
"xml": {
"name": "ArrayOfBusN1EstimateTime",
"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/Tourism/Bus/EstimatedTimeOfArrival/TaiwanTrip/{TaiwanTripName}": {
"get": {
"tags": [
"Tourism"
],
"summary": "取得指定[路線名稱]的台灣好行公車的預估到站資料(N1)",
"description": "取得指定[路線名稱]的台灣好行公車的預估到站資料(N1)",
"operationId": "TaiwanTripBusApi_EstimatedTimeOfArrival_2262_1",
"parameters": [
{
"name": "TaiwanTripName",
"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.Tourism.Specification.V2.BusN1EstimateTime"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.Specification.V2.BusN1EstimateTime"
},
"xml": {
"name": "ArrayOfBusN1EstimateTime",
"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/Tourism/Bus/Route/TaiwanTrip": {
"get": {
"tags": [
"Tourism"
],
"summary": "取得台灣好行公車路線資料",
"description": "取得台灣好行公車路線資料",
"operationId": "TaiwanTripBusApi_Route_2263",
"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.Tourism.Specification.V2.BusRoute"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.Specification.V2.BusRoute"
},
"xml": {
"name": "ArrayOfBusRoute",
"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/Tourism/Bus/Route/TaiwanTrip/{TaiwanTripName}": {
"get": {
"tags": [
"Tourism"
],
"summary": "取得指定[路線名稱]的台灣好行公車路線資料",
"description": "取得指定[路線名稱]的台灣好行公車路線資料",
"operationId": "TaiwanTripBusApi_Route_2263_1",
"parameters": [
{
"name": "TaiwanTripName",
"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.Tourism.Specification.V2.BusRoute"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.Specification.V2.BusRoute"
},
"xml": {
"name": "ArrayOfBusRoute",
"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/Tourism/Bus/StopOfRoute/TaiwanTrip": {
"get": {
"tags": [
"Tourism"
],
"summary": "取得台灣好行公車路線與站牌資料",
"description": "取得台灣好行公車路線與站牌資料",
"operationId": "TaiwanTripBusApi_StopOfRoute_2264",
"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.Tourism.Specification.V2.BusStopOfRoute"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.Specification.V2.BusStopOfRoute"
},
"xml": {
"name": "ArrayOfBusStopOfRoute",
"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/Tourism/Bus/StopOfRoute/TaiwanTrip/{TaiwanTripName}": {
"get": {
"tags": [
"Tourism"
],
"summary": "取得指定[路線名稱]的台灣好行公車路線與站牌資料",
"description": "取得指定[路線名稱]的台灣好行公車路線與站牌資料",
"operationId": "TaiwanTripBusApi_StopOfRoute_2264_1",
"parameters": [
{
"name": "TaiwanTripName",
"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.Tourism.Specification.V2.BusStopOfRoute"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.Specification.V2.BusStopOfRoute"
},
"xml": {
"name": "ArrayOfBusStopOfRoute",
"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/Tourism/Bus/Schedule/TaiwanTrip": {
"get": {
"tags": [
"Tourism"
],
"summary": "取得台灣好行公車路線班表資料",
"description": "取得台灣好行公車路線班表資料",
"operationId": "TaiwanTripBusApi_Schedule_2265",
"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.Tourism.Specification.V2.BusSchedule"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.Specification.V2.BusSchedule"
},
"xml": {
"name": "ArrayOfBusSchedule",
"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/Tourism/Bus/Schedule/TaiwanTrip/{TaiwanTripName}": {
"get": {
"tags": [
"Tourism"
],
"summary": "取得指定[路線名稱]的台灣好行公車路線班表資料",
"description": "取得指定[路線名稱]的台灣好行公車路線班表資料",
"operationId": "TaiwanTripBusApi_Schedule_2265_1",
"parameters": [
{
"name": "TaiwanTripName",
"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.Tourism.Specification.V2.BusSchedule"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.Specification.V2.BusSchedule"
},
"xml": {
"name": "ArrayOfBusSchedule",
"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/Tourism/Bus/Shape/TaiwanTrip": {
"get": {
"tags": [
"Tourism"
],
"summary": "取得台灣好行公車線型資料",
"description": "取得台灣好行公車線型資料",
"operationId": "TaiwanTripBusApi_Shape_2266",
"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.Tourism.Specification.V2.BusShape"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.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/Tourism/Bus/Shape/TaiwanTrip/{TaiwanTripName}": {
"get": {
"tags": [
"Tourism"
],
"summary": "取得指定[路線名稱]的台灣好行公車線型資料",
"description": "取得指定[路線名稱]的台灣好行公車線型資料",
"operationId": "TaiwanTripBusApi_Shape_2266_1",
"parameters": [
{
"name": "TaiwanTripName",
"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.Tourism.Specification.V2.BusShape"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.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/Tourism/Bus/S2TravelTime/TaiwanTrip": {
"get": {
"tags": [
"Tourism"
],
"summary": "取得台灣好行公車路線站間旅行時間基本資料",
"description": "取得台灣好行公車路線站間旅行時間基本資料",
"operationId": "TaiwanTripBusApi_S2TravelTime_2267",
"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.Tourism.Specification.V2.BusTaiwanTripS2STravelTime"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.Specification.V2.BusTaiwanTripS2STravelTime"
},
"xml": {
"name": "ArrayOfBusTaiwanTripS2STravelTime",
"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/Tourism/Bus/News/TaiwanTrip": {
"get": {
"tags": [
"Tourism"
],
"summary": "取得台灣好行公車之最新消息",
"description": "取得台灣好行公車之最新消息",
"operationId": "TaiwanTripBusApi_News_2268",
"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.Tourism.Specification.V2.BusTaiwanTripNews"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.Specification.V2.BusTaiwanTripNews"
},
"xml": {
"name": "ArrayOfBusTaiwanTripNews",
"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/Tourism/Bus/RouteFare/TaiwanTrip": {
"get": {
"tags": [
"Tourism"
],
"summary": "取得台灣好行公車路線票價資料",
"description": "取得台灣好行公車路線票價資料",
"operationId": "TaiwanTripBusApi_RouteFare_2269",
"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.Tourism.Specification.V2.BusRouteFare"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.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/Tourism/Bus/RouteFare/TaiwanTrip/{TaiwanTripName}": {
"get": {
"tags": [
"Tourism"
],
"summary": "取得指定[路線名稱]的台灣好行公車路線票價資料",
"description": "取得指定[路線名稱]的台灣好行公車路線票價資料",
"operationId": "TaiwanTripBusApi_RouteFare_2269_1",
"parameters": [
{
"name": "TaiwanTripName",
"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.Tourism.Specification.V2.BusRouteFare"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.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/Tourism/Bus/DailyTimeTable/TaiwanTrip": {
"get": {
"tags": [
"Tourism"
],
"summary": "取得台灣好行公車每日營運時刻表資料",
"description": "取得台灣好行公車每日營運時刻表資料",
"operationId": "TaiwanTripBusApi_DailyTimeTable_2270",
"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.Tourism.Specification.V2.BusDailyTimeTable"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.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/Tourism/Bus/DailyTimeTable/TaiwanTrip/{TaiwanTripName}": {
"get": {
"tags": [
"Tourism"
],
"summary": "取得指定[路線名稱]的台灣好行每日營運時刻表資料",
"description": "取得指定[路線名稱]的台灣好行每日營運時刻表資料",
"operationId": "TaiwanTripBusApi_DailyTimeTable_2270_1",
"parameters": [
{
"name": "TaiwanTripName",
"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.Tourism.Specification.V2.BusDailyTimeTable"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.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/Tourism/Bus/FirstLastTripInfo/TaiwanTrip": {
"get": {
"tags": [
"Tourism"
],
"summary": "取得台灣好行公車首末班車資料",
"description": "取得台灣好行公車首末班車資料",
"operationId": "TaiwanTripBusApi_FirstLastTripInfo_2271",
"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.Tourism.Specification.V2.BusFirstLastTripInfo"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.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/Tourism/Bus/FirstLastTripInfo/TaiwanTrip/{TaiwanTripName}": {
"get": {
"tags": [
"Tourism"
],
"summary": "取得指定[路線名稱]的台灣好行公車首末班車資料",
"description": "取得指定[路線名稱]的台灣好行公車首末班車資料",
"operationId": "TaiwanTripBusApi_FirstLastTripInfo_2271_1",
"parameters": [
{
"name": "TaiwanTripName",
"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.Tourism.Specification.V2.BusFirstLastTripInfo"
}
}
},
"application/xml": {
"schema": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.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"
}
}
}
}
}
}
}
},
"components": {
"schemas": {
"PTX.Service.DTO.Tourism.Specification.V2.ScenicSpotTourismInfo": {
"title": "ScenicSpotTourismInfo",
"required": [
"ParkingPosition",
"Picture",
"Position",
"ScenicSpotID",
"ScenicSpotName",
"SrcUpdateTime"
],
"type": "object",
"properties": {
"ScenicSpotID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "景點代碼",
"xml": {
"name": "ScenicSpotID"
}
},
"ScenicSpotName": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "景點名稱",
"xml": {
"name": "ScenicSpotName"
}
},
"DescriptionDetail": {
"title": "String",
"type": "string",
"description": "景點特色詳細說明",
"nullable": true,
"xml": {
"name": "DescriptionDetail"
}
},
"Description": {
"title": "String",
"type": "string",
"description": "景點特色精簡說明",
"nullable": true,
"xml": {
"name": "Description"
}
},
"Phone": {
"title": "String",
"type": "string",
"description": "景點服務電話",
"nullable": true,
"xml": {
"name": "Phone"
}
},
"Address": {
"title": "String",
"type": "string",
"description": "景點地址",
"nullable": true,
"xml": {
"name": "Address"
}
},
"ZipCode": {
"title": "String",
"type": "string",
"description": "郵遞區號",
"nullable": true,
"xml": {
"name": "ZipCode"
}
},
"TravelInfo": {
"title": "String",
"type": "string",
"description": "交通資訊",
"nullable": true,
"xml": {
"name": "TravelInfo"
}
},
"OpenTime": {
"title": "String",
"type": "string",
"description": "開放時間",
"nullable": true,
"xml": {
"name": "OpenTime"
}
},
"Picture": {
"title": "TourismPicture",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.Specification.V2.TourismPicture"
}
],
"description": "景點照片",
"xml": {
"name": "TourismPicture"
}
},
"MapUrl": {
"title": "String",
"type": "string",
"description": "景點地圖/簡圖介紹網址",
"nullable": true,
"xml": {
"name": "MapUrl"
}
},
"Position": {
"title": "PointType",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.PointType"
}
],
"description": "景點位置",
"xml": {
"name": "PointType"
}
},
"Class1": {
"title": "String",
"type": "string",
"description": "景點分類1",
"nullable": true,
"xml": {
"name": "Class1"
}
},
"Class2": {
"title": "String",
"type": "string",
"description": "景點分類2",
"nullable": true,
"xml": {
"name": "Class2"
}
},
"Class3": {
"title": "String",
"type": "string",
"description": "景點分類3",
"nullable": true,
"xml": {
"name": "Class3"
}
},
"Level": {
"title": "String",
"type": "string",
"description": "古蹟分級",
"nullable": true,
"xml": {
"name": "Level"
}
},
"WebsiteUrl": {
"title": "String",
"type": "string",
"description": "景點官方網站網址",
"nullable": true,
"xml": {
"name": "WebsiteUrl"
}
},
"ParkingInfo": {
"title": "String",
"type": "string",
"description": "停車資訊",
"nullable": true,
"xml": {
"name": "ParkingInfo"
}
},
"ParkingPosition": {
"title": "PointType",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.PointType"
}
],
"description": "景點主要停車場位置",
"xml": {
"name": "PointType"
}
},
"TicketInfo": {
"title": "String",
"type": "string",
"description": "票價資訊",
"nullable": true,
"xml": {
"name": "TicketInfo"
}
},
"Remarks": {
"title": "String",
"type": "string",
"description": "警告及注意事項",
"nullable": true,
"xml": {
"name": "Remarks"
}
},
"Keyword": {
"title": "String",
"type": "string",
"description": "常用搜尋關鍵字",
"nullable": true,
"xml": {
"name": "Keyword"
}
},
"City": {
"title": "String",
"type": "string",
"description": "所屬縣市",
"nullable": true,
"xml": {
"name": "City"
}
},
"SrcUpdateTime": {
"title": "DateTime",
"type": "string",
"description": "觀光局檔案更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)",
"format": "date-time"
},
"UpdateTime": {
"type": "string",
"description": "本平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)",
"format": "date-time",
"nullable": true
}
},
"additionalProperties": false,
"description": "取得觀光景點資料",
"xml": {
"name": "ScenicSpotTourismInfo"
}
},
"PTX.Service.DTO.Tourism.Specification.V2.ScenicSpotTourismInfo0": {
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.Specification.V2.ScenicSpotTourismInfo"
},
"PTX.Service.DTO.Tourism.Specification.V2.TourismPicture": {
"title": "TourismPicture",
"type": "object",
"properties": {
"PictureUrl1": {
"title": "String",
"type": "string",
"description": "照片連結網址1",
"nullable": true,
"xml": {
"name": "PictureUrl1"
}
},
"PictureDescription1": {
"title": "String",
"type": "string",
"description": "照片說明1",
"nullable": true,
"xml": {
"name": "PictureDescription1"
}
},
"PictureUrl2": {
"title": "String",
"type": "string",
"description": "照片連結網址2",
"nullable": true,
"xml": {
"name": "PictureUrl2"
}
},
"PictureDescription2": {
"title": "String",
"type": "string",
"description": "照片說明2",
"nullable": true,
"xml": {
"name": "PictureDescription2"
}
},
"PictureUrl3": {
"title": "String",
"type": "string",
"description": "照片連結網址3",
"nullable": true,
"xml": {
"name": "PictureUrl3"
}
},
"PictureDescription3": {
"title": "String",
"type": "string",
"description": "照片說明3",
"nullable": true,
"xml": {
"name": "PictureDescription3"
}
}
},
"additionalProperties": false,
"description": "觀光照片資料型別",
"xml": {
"name": "TourismPicture"
}
},
"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.Tourism.Specification.V2.RestaurantTourismInfo": {
"title": "RestaurantTourismInfo",
"required": [
"Picture",
"Position",
"RestaurantID",
"RestaurantName",
"SrcUpdateTime"
],
"type": "object",
"properties": {
"RestaurantID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "餐飲店家代碼",
"xml": {
"name": "RestaurantID"
}
},
"RestaurantName": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "餐飲店家名稱",
"xml": {
"name": "RestaurantName"
}
},
"Description": {
"title": "String",
"type": "string",
"description": "店家簡述",
"nullable": true,
"xml": {
"name": "Description"
}
},
"Address": {
"title": "String",
"type": "string",
"description": "店家地址",
"nullable": true,
"xml": {
"name": "Address"
}
},
"ZipCode": {
"title": "String",
"type": "string",
"description": "郵遞區號",
"nullable": true,
"xml": {
"name": "ZipCode"
}
},
"Phone": {
"title": "String",
"type": "string",
"description": "預約電話",
"nullable": true,
"xml": {
"name": "Phone"
}
},
"OpenTime": {
"title": "String",
"type": "string",
"description": "營業時間",
"nullable": true,
"xml": {
"name": "OpenTime"
}
},
"WebsiteUrl": {
"title": "String",
"type": "string",
"description": "店家網站網址",
"nullable": true,
"xml": {
"name": "WebsiteUrl"
}
},
"Picture": {
"title": "TourismPicture",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.Specification.V2.TourismPicture"
}
],
"description": "店家照片",
"xml": {
"name": "TourismPicture"
}
},
"Position": {
"title": "PointType",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.PointType"
}
],
"description": "店家位置",
"xml": {
"name": "PointType"
}
},
"Class": {
"title": "String",
"type": "string",
"description": "店家分類",
"nullable": true,
"xml": {
"name": "Class"
}
},
"MapUrl": {
"title": "String",
"type": "string",
"description": "店家地圖/簡圖介紹網址",
"nullable": true,
"xml": {
"name": "MapUrl"
}
},
"ParkingInfo": {
"title": "String",
"type": "string",
"description": "停車資訊",
"nullable": true,
"xml": {
"name": "ParkingInfo"
}
},
"City": {
"title": "String",
"type": "string",
"description": "所屬縣市",
"nullable": true,
"xml": {
"name": "City"
}
},
"SrcUpdateTime": {
"title": "DateTime",
"type": "string",
"description": "觀光局檔案更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)",
"format": "date-time"
},
"UpdateTime": {
"type": "string",
"description": "本平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)",
"format": "date-time",
"nullable": true
}
},
"additionalProperties": false,
"description": "取得觀光餐飲資料",
"xml": {
"name": "RestaurantTourismInfo"
}
},
"PTX.Service.DTO.Tourism.Specification.V2.RestaurantTourismInfo1": {
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.Specification.V2.RestaurantTourismInfo"
},
"PTX.Service.DTO.Tourism.Specification.V2.HotelTourismInfo": {
"title": "HotelTourismInfo",
"required": [
"HotelID",
"HotelName",
"Picture",
"Position",
"SrcUpdateTime"
],
"type": "object",
"properties": {
"HotelID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "旅館民宿代碼",
"xml": {
"name": "HotelID"
}
},
"HotelName": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "旅館民宿名稱",
"xml": {
"name": "HotelName"
}
},
"Description": {
"title": "String",
"type": "string",
"description": "旅館民宿簡述",
"nullable": true,
"xml": {
"name": "Description"
}
},
"Grade": {
"title": "String",
"type": "string",
"description": "觀光旅館星級",
"nullable": true,
"xml": {
"name": "Grade"
}
},
"Address": {
"title": "String",
"type": "string",
"description": "旅館民宿地址",
"nullable": true,
"xml": {
"name": "Address"
}
},
"ZipCode": {
"title": "String",
"type": "string",
"description": "郵遞區號",
"nullable": true,
"xml": {
"name": "ZipCode"
}
},
"Phone": {
"title": "String",
"type": "string",
"description": "旅館民宿電話",
"nullable": true,
"xml": {
"name": "Phone"
}
},
"Fax": {
"title": "String",
"type": "string",
"description": "旅館民宿傳真",
"nullable": true,
"xml": {
"name": "Fax"
}
},
"WebsiteUrl": {
"title": "String",
"type": "string",
"description": "旅館民宿網站網址",
"nullable": true,
"xml": {
"name": "WebsiteUrl"
}
},
"Picture": {
"title": "TourismPicture",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.Specification.V2.TourismPicture"
}
],
"description": "旅館民宿照片",
"xml": {
"name": "TourismPicture"
}
},
"Position": {
"title": "PointType",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.PointType"
}
],
"description": "旅館民宿位置",
"xml": {
"name": "PointType"
}
},
"Class": {
"title": "String",
"type": "string",
"description": "旅館民宿分類",
"nullable": true,
"xml": {
"name": "Class"
}
},
"MapUrl": {
"title": "String",
"type": "string",
"description": "旅館民宿地點簡圖連結網址",
"nullable": true,
"xml": {
"name": "MapUrl"
}
},
"Spec": {
"title": "String",
"type": "string",
"description": "房型、價目及數量說明",
"nullable": true,
"xml": {
"name": "Spec"
}
},
"ServiceInfo": {
"title": "String",
"type": "string",
"description": "服務內容介紹",
"nullable": true,
"xml": {
"name": "ServiceInfo"
}
},
"ParkingInfo": {
"title": "String",
"type": "string",
"description": "停車資訊",
"nullable": true,
"xml": {
"name": "ParkingInfo"
}
},
"City": {
"title": "String",
"type": "string",
"description": "所屬縣市",
"nullable": true,
"xml": {
"name": "City"
}
},
"SrcUpdateTime": {
"title": "DateTime",
"type": "string",
"description": "觀光局檔案更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)",
"format": "date-time"
},
"UpdateTime": {
"type": "string",
"description": "本平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)",
"format": "date-time",
"nullable": true
}
},
"additionalProperties": false,
"description": "取得觀光旅宿資料",
"xml": {
"name": "HotelTourismInfo"
}
},
"PTX.Service.DTO.Tourism.Specification.V2.HotelTourismInfo2": {
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.Specification.V2.HotelTourismInfo"
},
"PTX.Service.DTO.Tourism.Specification.V2.ActivityTourismInfo": {
"title": "ActivityTourismInfo",
"required": [
"ActivityID",
"Picture",
"Position",
"SrcUpdateTime"
],
"type": "object",
"properties": {
"ActivityID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "活動訊息代碼",
"xml": {
"name": "ActivityID"
}
},
"ActivityName": {
"title": "String",
"type": "string",
"description": "活動名稱",
"nullable": true,
"xml": {
"name": "ActivityName"
}
},
"Description": {
"title": "String",
"type": "string",
"description": "活動簡述",
"nullable": true,
"xml": {
"name": "Description"
}
},
"Particpation": {
"title": "String",
"type": "string",
"description": "活動參與對象",
"nullable": true,
"xml": {
"name": "Particpation"
}
},
"Location": {
"title": "String",
"type": "string",
"description": "主要活動地點名稱",
"nullable": true,
"xml": {
"name": "Location"
}
},
"Address": {
"title": "String",
"type": "string",
"description": "主要活動地點地址",
"nullable": true,
"xml": {
"name": "Address"
}
},
"Phone": {
"title": "String",
"type": "string",
"description": "活動聯絡電話",
"nullable": true,
"xml": {
"name": "Phone"
}
},
"Organizer": {
"title": "String",
"type": "string",
"description": "活動主辦單位",
"nullable": true,
"xml": {
"name": "Organizer"
}
},
"StartTime": {
"type": "string",
"description": "活動開始時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)",
"format": "date-time",
"nullable": true
},
"EndTime": {
"type": "string",
"description": "活動結束時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)",
"format": "date-time",
"nullable": true
},
"Cycle": {
"title": "String",
"type": "string",
"description": "週期性活動執行時間",
"nullable": true,
"xml": {
"name": "Cycle"
}
},
"NonCycle": {
"title": "String",
"type": "string",
"description": "非週期性活動執行時間",
"nullable": true,
"xml": {
"name": "NonCycle"
}
},
"WebsiteUrl": {
"title": "String",
"type": "string",
"description": "活動網址",
"nullable": true,
"xml": {
"name": "WebsiteUrl"
}
},
"Picture": {
"title": "TourismPicture",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.Specification.V2.TourismPicture"
}
],
"description": "活動照片",
"xml": {
"name": "TourismPicture"
}
},
"Position": {
"title": "PointType",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.PointType"
}
],
"description": "活動位置",
"xml": {
"name": "PointType"
}
},
"Class1": {
"title": "String",
"type": "string",
"description": "活動分類1",
"nullable": true,
"xml": {
"name": "Class1"
}
},
"Class2": {
"title": "String",
"type": "string",
"description": "活動分類2",
"nullable": true,
"xml": {
"name": "Class2"
}
},
"MapUrl": {
"title": "String",
"type": "string",
"description": "活動地圖/簡圖連結網址",
"nullable": true,
"xml": {
"name": "MapUrl"
}
},
"TravelInfo": {
"title": "String",
"type": "string",
"description": "交通資訊",
"nullable": true,
"xml": {
"name": "TravelInfo"
}
},
"ParkingInfo": {
"title": "String",
"type": "string",
"description": "停車資訊",
"nullable": true,
"xml": {
"name": "ParkingInfo"
}
},
"Charge": {
"title": "String",
"type": "string",
"description": "費用標示",
"nullable": true,
"xml": {
"name": "Charge"
}
},
"Remarks": {
"title": "String",
"type": "string",
"description": "備註(其他活動相關事項)",
"nullable": true,
"xml": {
"name": "Remarks"
}
},
"City": {
"title": "String",
"type": "string",
"description": "所屬縣市",
"nullable": true,
"xml": {
"name": "City"
}
},
"SrcUpdateTime": {
"title": "DateTime",
"type": "string",
"description": "觀光局檔案更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)",
"format": "date-time"
},
"UpdateTime": {
"type": "string",
"description": "本平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)",
"format": "date-time",
"nullable": true
}
},
"additionalProperties": false,
"description": "取得觀光活動資料",
"xml": {
"name": "ActivityTourismInfo"
}
},
"PTX.Service.DTO.Tourism.Specification.V2.ActivityTourismInfo3": {
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.Specification.V2.ActivityTourismInfo"
},
"PTX.Service.DTO.Tourism.Specification.V2.BusA1Data": {
"title": "BusA1Data",
"required": [
"Azimuth",
"BusStatus",
"DutyStatus",
"GPSTime",
"PlateNumb",
"Speed",
"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"
}
},
"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"
}
},
"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"
}
},
"TaiwanTripName": {
"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:'迴圈',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"
},
"Azimuth": {
"type": "number",
"description": "方位角",
"format": "double"
},
"DutyStatus": {
"title": "Int32",
"type": "integer",
"description": "勤務狀態 : [0:'正常',1:'開始',2:'結束']",
"format": "int32"
},
"BusStatus": {
"title": "Int32",
"type": "integer",
"description": "行車狀況 : [0:'正常',1:'車禍',2:'故障',3:'塞車',4:'緊急求援',5:'加油',90:'不明',91:'去回不明',98:'偏移路線',99:'非營運狀態',100:'客滿',101:'包車出租',255:'未知']",
"format": "int32"
},
"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
},
"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.Tourism.Specification.V2.BusA1Data4": {
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.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.Tourism.Specification.V2.BusA2Data": {
"title": "BusA2Data",
"required": [
"Direction",
"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"
}
},
"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"
}
},
"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"
}
},
"TaiwanTripName": {
"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:'迴圈',255:'未知']",
"format": "int32"
},
"StopUID": {
"title": "String",
"type": "string",
"description": "站牌唯一識別代碼，規則為 {平台代碼} + {StopID}，其中 {平台代碼} 可於Provider API中的ProviderCode欄位查詢",
"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"
}
},
"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)",
"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
},
"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.Tourism.Specification.V2.BusA2Data5": {
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.Specification.V2.BusA2Data"
},
"PTX.Service.DTO.Tourism.Specification.V2.BusN1EstimateTime": {
"title": "BusN1EstimateTime",
"required": [
"Direction",
"UpdateTime"
],
"type": "object",
"properties": {
"PlateNumb": {
"title": "String",
"type": "string",
"description": "車牌號碼",
"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"
}
},
"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"
}
},
"TaiwanTripName": {
"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:'迴圈',255:'未知']",
"format": "int32"
},
"EstimateTime": {
"type": "integer",
"description": "到站時間預估(秒)",
"format": "int32",
"nullable": true
},
"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"
}
},
"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
},
"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
},
"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.Tourism.Specification.V2.BusN1EstimateTime6": {
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.Specification.V2.BusN1EstimateTime"
},
"PTX.Service.DTO.Tourism.Specification.V2.BusRoute": {
"title": "BusRoute",
"required": [
"AuthorityID",
"BusRouteType",
"HasSubRoutes",
"OperatorIDs",
"Operators",
"ProviderID",
"RouteID",
"RouteUID",
"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"
}
},
"HasSubRoutes": {
"title": "Boolean",
"type": "boolean",
"description": "實際上是否有多條附屬路線。(此欄位值與SubRoutes結構並無強烈的絕對關聯。詳細說明請參閱swagger上方的【資料服務使用注意事項】)"
},
"OperatorIDs": {
"title": "Array",
"type": "array",
"items": {
"title": "String",
"type": "string",
"xml": { }
},
"description": "營運業者代碼",
"xml": {
"name": "List`1"
}
},
"Operators": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.Specification.V2.RouteOperator"
},
"description": "營運業者",
"xml": {
"name": "List`1"
}
},
"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.Tourism.Specification.V2.BusSubRoute"
},
"description": "附屬路線資料(如果原始資料並無提供附屬路線ID，而本平台基於跨來源資料之一致性，會以SubRouteID=RouteID產製一份相對應的附屬路線資料(若有去返程，則會有兩筆))",
"nullable": true,
"xml": {
"name": "List`1"
}
},
"BusRouteType": {
"title": "Int32",
"type": "integer",
"description": "公車路線類別 : [11:'市區公車',12:'公路客運',13:'國道客運',14:'接駁車']",
"format": "int32"
},
"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"
}
},
"RouteUrl": {
"title": "String",
"type": "string",
"description": "路線資訊說明網址",
"nullable": true,
"xml": {
"name": "RouteUrl"
}
},
"LiveBusUrl": {
"title": "String",
"type": "string",
"description": "路線公車動態資訊網址",
"nullable": true,
"xml": {
"name": "LiveBusUrl"
}
},
"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"
}
},
"additionalProperties": false,
"description": "路線資料型別",
"xml": {
"name": "BusRoute"
}
},
"PTX.Service.DTO.Tourism.Specification.V2.BusRoute7": {
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.Specification.V2.BusRoute"
},
"PTX.Service.DTO.Tourism.Specification.V2.RouteOperator": {
"title": "RouteOperator",
"required": [
"OperatorCode",
"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",
"minLength": 1,
"type": "string",
"description": "營運業者簡碼",
"xml": {
"name": "OperatorCode"
}
},
"OperatorNo": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "營運業者編號[交通部票證資料系統定義]",
"xml": {
"name": "OperatorNo"
}
}
},
"additionalProperties": false,
"description": "營運業者資訊",
"xml": {
"name": "RouteOperator"
}
},
"PTX.Service.DTO.Tourism.Specification.V2.BusSubRoute": {
"title": "BusSubRoute",
"required": [
"Direction",
"OperatorIDs",
"SubRouteID",
"SubRouteUID",
"TaiwanTripName"
],
"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"
}
},
"TaiwanTripName": {
"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:'迴圈',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"
}
}
},
"additionalProperties": false,
"description": "附屬路線資料型別",
"xml": {
"name": "BusSubRoute"
}
},
"PTX.Service.DTO.Tourism.Specification.V2.BusStopOfRoute": {
"title": "BusStopOfRoute",
"required": [
"Direction",
"KeyPattern",
"RouteID",
"RouteUID",
"Stops",
"SubRouteID",
"SubRouteName",
"SubRouteUID",
"TaiwanTripName",
"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"
}
},
"KeyPattern": {
"title": "Boolean",
"type": "boolean",
"description": "是否為主路線"
},
"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"
}
},
"TaiwanTripName": {
"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:'迴圈',255:'未知']",
"format": "int32"
},
"Stops": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.Specification.V2.Stop"
},
"description": "所有經過站牌",
"xml": {
"name": "List`1"
}
},
"UpdateTime": {
"title": "DateTime",
"type": "string",
"description": "資料更新日期時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)",
"format": "date-time"
}
},
"additionalProperties": false,
"description": "路線與站牌對應資料",
"xml": {
"name": "BusStopOfRoute"
}
},
"PTX.Service.DTO.Tourism.Specification.V2.BusStopOfRoute8": {
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.Specification.V2.BusStopOfRoute"
},
"PTX.Service.DTO.Tourism.Specification.V2.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.Tourism.Specification.V2.BusSchedule": {
"title": "BusSchedule",
"required": [
"Direction",
"RouteID",
"RouteUID",
"SubRouteID",
"SubRouteName",
"SubRouteUID",
"TaiwanTripName",
"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"
}
},
"SubRouteName": {
"title": "NameType",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType"
}
],
"description": "子路線名稱",
"xml": {
"name": "NameType"
}
},
"TaiwanTripName": {
"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:'迴圈',255:'未知']",
"format": "int32"
},
"Timetables": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.Specification.V2.BusTimetable"
},
"description": "預定班表",
"nullable": true,
"xml": {
"name": "List`1"
}
},
"Frequencys": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.Specification.V2.BusFrequency"
},
"description": "發車班距",
"nullable": true,
"xml": {
"name": "List`1"
}
},
"UpdateTime": {
"title": "DateTime",
"type": "string",
"description": "資料更新日期時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)",
"format": "date-time"
}
},
"additionalProperties": false,
"xml": {
"name": "BusSchedule"
}
},
"PTX.Service.DTO.Tourism.Specification.V2.BusSchedule9": {
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.Specification.V2.BusSchedule"
},
"PTX.Service.DTO.Tourism.Specification.V2.BusTimetable": {
"title": "BusTimetable",
"required": [
"StopTimes"
],
"type": "object",
"properties": {
"TripID": {
"title": "String",
"type": "string",
"description": "班次代碼，為無意義之編碼",
"nullable": true,
"xml": {
"name": "TripID"
}
},
"ServiceDay": {
"title": "ServiceDay",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.Specification.V2.ServiceDay"
}
],
"description": "週內營運日",
"nullable": true,
"xml": {
"name": "ServiceDay"
}
},
"SpecialDays": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.Specification.V2.SpecialDay"
},
"description": "特殊營運日",
"nullable": true,
"xml": {
"name": "List`1"
}
},
"StopTimes": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.Specification.V2.BusStopTime"
},
"description": "公車停靠時間資料",
"xml": {
"name": "List`1"
}
}
},
"additionalProperties": false,
"description": "班次資料",
"xml": {
"name": "BusTimetable"
}
},
"PTX.Service.DTO.Tourism.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.Tourism.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.Tourism.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.Tourism.Specification.V2.BusStopTime": {
"title": "BusStopTime",
"required": [
"ArrivalTime",
"DepartureTime",
"StopID",
"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": "站牌名稱",
"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"
}
}
},
"additionalProperties": false,
"description": "公車停靠時間資料",
"xml": {
"name": "BusStopTime"
}
},
"PTX.Service.DTO.Tourism.Specification.V2.ServiceDay": {
"title": "ServiceDay",
"required": [
"Friday",
"Monday",
"Saturday",
"Sunday",
"Thursday",
"Tuesday",
"Wednesday"
],
"type": "object",
"properties": {
"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.Tourism.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.Tourism.Specification.V2.ServiceDay"
}
],
"description": "週內營運日",
"nullable": true,
"xml": {
"name": "ServiceDay"
}
},
"SpecialDays": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.Specification.V2.SpecialDay"
},
"description": "特殊營運日",
"nullable": true,
"xml": {
"name": "List`1"
}
}
},
"additionalProperties": false,
"description": "發車班距資料",
"xml": {
"name": "BusFrequency"
}
},
"PTX.Service.DTO.Tourism.Specification.V2.BusShape": {
"title": "BusShape",
"required": [
"EncodedPolyline",
"Geometry",
"RouteID",
"RouteUID",
"SubRouteUID",
"TaiwanTripName",
"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"
}
},
"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"
}
},
"TaiwanTripName": {
"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:'迴圈',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.Tourism.Specification.V2.BusShape10": {
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.Specification.V2.BusShape"
},
"PTX.Service.DTO.Tourism.Specification.V2.BusTaiwanTripS2STravelTime": {
"title": "BusTaiwanTripS2STravelTime",
"required": [
"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"
}
},
"TravelTimes": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.Specification.V2.BusTaiwanTripS2STravelTimeTravelTime"
},
"description": "站間運行時間資訊",
"xml": {
"name": "List`1"
}
},
"UpdateTime": {
"title": "DateTime",
"type": "string",
"description": "資料更新日期時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)",
"format": "date-time"
}
},
"additionalProperties": false,
"xml": {
"name": "BusTaiwanTripS2STravelTime"
}
},
"PTX.Service.DTO.Tourism.Specification.V2.BusTaiwanTripS2STravelTime11": {
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.Specification.V2.BusTaiwanTripS2STravelTime"
},
"PTX.Service.DTO.Tourism.Specification.V2.BusTaiwanTripS2STravelTimeTravelTime": {
"title": "TravelTime",
"required": [
"Distance",
"FromStopID",
"RunTime",
"Sequence",
"StopTime",
"ToStopID"
],
"type": "object",
"properties": {
"Sequence": {
"title": "Int32",
"type": "integer",
"description": "站間序號",
"format": "int32"
},
"FromStopID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "起站站牌代碼",
"xml": {
"name": "FromStopID"
}
},
"ToStopID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "迄站站牌代碼",
"xml": {
"name": "ToStopID"
}
},
"Distance": {
"title": "Single",
"type": "number",
"description": "站間距離",
"format": "float"
},
"RunTime": {
"title": "Int32",
"type": "integer",
"description": "站間預估行駛時間",
"format": "int32"
},
"StopTime": {
"title": "Int32",
"type": "integer",
"description": "起站停靠時間",
"format": "int32"
}
},
"additionalProperties": false,
"xml": {
"name": "TravelTime"
}
},
"PTX.Service.DTO.Tourism.Specification.V2.BusTaiwanTripNews": {
"title": "BusTaiwanTripNews",
"required": [
"Description",
"Language",
"NewsID",
"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"
}
},
"NewsCategory": {
"title": "String",
"type": "string",
"description": "消息類別",
"nullable": true,
"xml": {
"name": "NewsCategory"
}
},
"Title": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "消息標題",
"xml": {
"name": "Title"
}
},
"Description": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "內容描述",
"xml": {
"name": "Description"
}
},
"PublishTime": {
"type": "string",
"description": "消息公告日期時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)",
"format": "date-time",
"nullable": true
},
"StartTime": {
"type": "string",
"description": "開始時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)",
"format": "date-time",
"nullable": true
},
"EndTime": {
"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": "BusTaiwanTripNews"
}
},
"PTX.Service.DTO.Tourism.Specification.V2.BusTaiwanTripNews12": {
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.Specification.V2.BusTaiwanTripNews"
},
"PTX.Service.DTO.Tourism.Specification.V2.BusRouteFare": {
"title": "BusRouteFare",
"required": [
"FarePricingType",
"IsForAllSubRoutes",
"IsFreeBus",
"OperatorID",
"RouteID",
"TaiwanTripName",
"UpdateTime"
],
"type": "object",
"properties": {
"RouteID": {
"title": "String",
"minLength": 1,
"type": "string",
"description": "機關定義路線代號",
"xml": {
"name": "RouteID"
}
},
"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"
}
},
"TaiwanTripName": {
"title": "NameType",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Shared.Specification.V2.Base.NameType"
}
],
"description": "台灣好行路線名稱",
"xml": {
"name": "NameType"
}
},
"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.Tourism.Specification.V2.SectionFare"
},
"description": "段次計費",
"nullable": true,
"xml": {
"name": "List`1"
}
},
"StageFares": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.Specification.V2.BusStageFare"
},
"description": "計費站區間計費",
"nullable": true,
"xml": {
"name": "List`1"
}
},
"ODFares": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.Specification.V2.BusODFare"
},
"description": "起迄站間計費",
"nullable": true,
"xml": {
"name": "List`1"
}
},
"UpdateTime": {
"title": "DateTime",
"type": "string",
"description": "本平台資料更新時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)",
"format": "date-time"
}
},
"additionalProperties": false,
"description": "路線票價資料",
"xml": {
"name": "BusRouteFare"
}
},
"PTX.Service.DTO.Tourism.Specification.V2.BusRouteFare13": {
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.Specification.V2.BusRouteFare"
},
"PTX.Service.DTO.Tourism.Specification.V2.SectionFare": {
"title": "SectionFare",
"required": [
"Fares"
],
"type": "object",
"properties": {
"BufferZones": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.Specification.V2.SectionFareBufferZone"
},
"description": "緩衝區資訊",
"nullable": true,
"xml": {
"name": "List`1"
}
},
"Fares": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.Specification.V2.BusRouteFareFare"
},
"description": "每段收費資訊",
"xml": {
"name": "List`1"
}
}
},
"additionalProperties": false,
"description": "段次計費",
"xml": {
"name": "SectionFare"
}
},
"PTX.Service.DTO.Tourism.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:'迴圈',255:'未知']",
"format": "int32"
},
"FareBufferZoneOrigin": {
"title": "Stop",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.Specification.V2.BusRouteFareStop"
}
],
"description": "緩衝區起點",
"xml": {
"name": "Stop"
}
},
"FareBufferZoneDestination": {
"title": "Stop",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.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.Tourism.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.Tourism.Specification.V2.BusRouteFareFare": {
"title": "Fare",
"required": [
"FareClass",
"Price",
"TicketType"
],
"type": "object",
"properties": {
"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"
}
},
"additionalProperties": false,
"xml": {
"name": "Fare"
}
},
"PTX.Service.DTO.Tourism.Specification.V2.BusStageFare": {
"title": "BusStageFare",
"required": [
"DestinationStage",
"Direction",
"Fares",
"OriginStage"
],
"type": "object",
"properties": {
"Direction": {
"title": "Int32",
"type": "integer",
"description": "方向性描述 : [0:'去程',1:'返程',2:'迴圈',255:'未知']",
"format": "int32"
},
"OriginStage": {
"title": "Stop",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.Specification.V2.BusRouteFareStop"
}
],
"description": "起點計費站",
"xml": {
"name": "Stop"
}
},
"DestinationStage": {
"title": "Stop",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.Specification.V2.BusRouteFareStop"
}
],
"description": "迄點計費站",
"xml": {
"name": "Stop"
}
},
"Fares": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.Specification.V2.BusFare"
},
"description": "票價內容",
"xml": {
"name": "List`1"
}
}
},
"additionalProperties": false,
"description": "此計費方式以一路線內所有站牌分區收費。(公總稱之為計費站收費, Stage=計費站)",
"xml": {
"name": "BusStageFare"
}
},
"PTX.Service.DTO.Tourism.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.Tourism.Specification.V2.BusDiscountPeriods"
},
"description": "優惠時段",
"nullable": true,
"xml": {
"name": "List`1"
}
}
},
"additionalProperties": false,
"description": "票票價種類及費率說明",
"xml": {
"name": "BusFare"
}
},
"PTX.Service.DTO.Tourism.Specification.V2.BusDiscountPeriods": {
"title": "BusDiscountPeriods",
"required": [
"EndTime",
"ServiceDay",
"StartTime"
],
"type": "object",
"properties": {
"ServiceDay": {
"title": "ServiceDay",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.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.Tourism.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.Tourism.Specification.V2.BusODFare": {
"title": "BusODFare",
"required": [
"DestinationStop",
"Direction",
"Fares",
"OriginStop"
],
"type": "object",
"properties": {
"Direction": {
"title": "Int32",
"type": "integer",
"description": "方向性描述 : [0:'去程',1:'返程',2:'迴圈',255:'未知']",
"format": "int32"
},
"OriginStop": {
"title": "Stop",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.Specification.V2.BusRouteFareStop"
}
],
"description": "計費起點站牌資訊",
"xml": {
"name": "Stop"
}
},
"DestinationStop": {
"title": "Stop",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.Specification.V2.BusRouteFareStop"
}
],
"description": "計費迄點站牌資訊",
"xml": {
"name": "Stop"
}
},
"Fares": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.Specification.V2.BusRouteFareFare"
},
"description": "票價內容",
"xml": {
"name": "List`1"
}
}
},
"additionalProperties": false,
"description": "起迄站間計費",
"xml": {
"name": "BusODFare"
}
},
"PTX.Service.DTO.Tourism.Specification.V2.BusDailyTimeTable": {
"title": "BusDailyTimeTable",
"required": [
"BusDate",
"Direction",
"OperatorID",
"RouteID",
"RouteUID",
"SubRouteID",
"TaiwanTripName",
"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"
}
},
"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"
}
},
"TaiwanTripName": {
"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:'迴圈',255:'未知']",
"format": "int32"
},
"Timetables": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.Specification.V2.BusDailyTimeTableTimeTable"
},
"description": "預定班表",
"nullable": true,
"xml": {
"name": "List`1"
}
},
"UpdateTime": {
"title": "DateTime",
"type": "string",
"description": "資料更新日期時間(ISO8601格式:yyyy-MM-ddTHH:mm:sszzz)",
"format": "date-time"
}
},
"additionalProperties": false,
"xml": {
"name": "BusDailyTimeTable"
}
},
"PTX.Service.DTO.Tourism.Specification.V2.BusDailyTimeTable14": {
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.Specification.V2.BusDailyTimeTable"
},
"PTX.Service.DTO.Tourism.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.Tourism.Specification.V2.BusDailyTimeTableStopTime"
},
"description": "公車停靠時間資料",
"xml": {
"name": "List`1"
}
}
},
"additionalProperties": false,
"xml": {
"name": "TimeTable"
}
},
"PTX.Service.DTO.Tourism.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.Tourism.Specification.V2.BusFirstLastTripInfo": {
"title": "BusFirstLastTripInfo",
"required": [
"Direction",
"FirstLastTrips",
"OperatorID",
"RouteID",
"RouteUID",
"SubRouteID",
"SubRouteName",
"SubRouteUID",
"TaiwanTripName",
"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"
}
},
"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"
}
},
"TaiwanTripName": {
"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:'迴圈',255:'未知']",
"format": "int32"
},
"FirstLastTrips": {
"title": "Array",
"type": "array",
"items": {
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.Specification.V2.FirstLastTrip"
},
"description": "首末班車",
"xml": {
"name": "List`1"
}
},
"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.Tourism.Specification.V2.BusFirstLastTripInfo15": {
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.Specification.V2.BusFirstLastTripInfo"
},
"PTX.Service.DTO.Tourism.Specification.V2.FirstLastTrip": {
"title": "FirstLastTrip",
"required": [
"FirstTripDepTime",
"LastTripDepTime",
"ServiceDay"
],
"type": "object",
"properties": {
"ServiceDay": {
"title": "ServiceDay",
"allOf": [
{
"$ref": "#/components/schemas/PTX.Service.DTO.Tourism.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.Tourism.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"
}
}
},
"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": "Tourism",
"description": "觀光"
}
]
}