## CS-01：客運艘次籍旅客人次
/tipc/travelship/cs01/overview
``` json
Request:
{
"startDate": "2023-01-01",
"endDate": "2023-05-01",
# 各分公司
"companyCode": [
"HQO",
"KELHB",
"TXGHB",
"KHHHB",
"HUNHB"
],
# 分公司對應的港口
"portCode": [
"KEL",
"TXG",
"TPE",
"SUO",
"KHH",
"APG",
"HUN",
"PUT",
"MZG"
],
# 船種：BS(兩岸渡輪)、IS(國內客船)、CS(國際郵輪)
"shipTypeCode": [
"BS",
"IS",
"CS"
],
# MP(母港)、HP(掛靠港)
"portOfCallCode": [
"MP",
"HP"
],
# VESSEL_Time(艘次)、Traveler_Time(人次)
"unit": [
"VESSEL_Time",
"Traveler_Time"
]
}
Response:
{
"list": [
{
# 艘次
"vesselTimes": 8.98,
# 去年同期艘次
"lastVesselTimes": 5.26,
# 同期增減艘次
"subtractVesselTimes": 3.72,
# 艘次成長率
"vesselTimesRate": 70.72,
# 人次
"travelerTimes": 2547.71,
# 去年同期人次
"lastTravelerTimes": 856.58,
# 同期增減人次
"subtractTravelerTimes": 1691.13,
# 人次成長率
"travelerTimesRate": 197.43
}
],
"currentPage": 0,
"totalItems": 0,
"totalPages": 0
}
```
## CS-01：牌卡memo
/tipc/travelship/cs01/memo
``` json
Request:
{
"startDate": "2023-01-01",
"endDate": "2023-05-01",
# 各分公司
"companyCode": [
"HQO",
"KELHB",
"TXGHB",
"KHHHB",
"HUNHB"
],
# 分公司對應的港口
"portCode": [
"KEL",
"TXG",
"TPE",
"SUO",
"KHH",
"APG",
"HUN",
"PUT",
"MZG"
],
# 船種：BS(兩岸渡輪)、IS(國內客船)、CS(國際郵輪)
"shipTypeCode": [
"BS",
"IS",
"CS"
],
# MP(母港)、HP(掛靠港)
"portOfCallCode": [
"MP",
"HP"
],
# VESSEL_Time(艘次)、Traveler_Time(人次)
"unit": [
"VESSEL_Time",
"Traveler_Time"
]
}
Response:
{
"list": [
{
"vesselTimes": null,
"lastVesselTimes": null,
"subtractVesselTimes": null,
"vesselTimesRate": null,
"travelerTimes": null,
"lastTravelerTimes": null,
"subtractTravelerTimes": null,
"travelerTimesRate": null,
"memo": "2023年1~12月國際郵輪掛靠港客運量為 264 艘次、195825 人次，較去(2022)年同期之12艘次、644人次，同期增加為252艘次、195181人次，成長率分別成長 2100.00% 及 30307.61%。"
}
],
"currentPage": 0,
"totalItems": 0,
"totalPages": 0
}
```
## CS-02：近五年總客運量趨勢：BS(兩岸)、IS(國內)、CS(郵輪)
/tipc/travelship/cs02/shipType/year
``` json
Request:
{
"startDate": "2023-01-01",
"endDate": "2023-05-01",
# 各分公司
"companyCode": [
"HQO",
"KELHB",
"TXGHB",
"KHHHB",
"HUNHB"
],
# 分公司對應的港口
"portCode": [
"KEL",
"TXG",
"TPE",
"SUO",
"KHH",
"APG",
"HUN",
"PUT",
"MZG"
],
# MP(母港)、HP(掛靠港)
"portOfCallCode": [
"MP","HP"
],
# BS(兩岸)、IS(國內)、CS(郵輪)
"shipTypeCode": [
"BS","IS","CS"
],
# VESSEL_Time(艘次)、Traveler_Time(人次)
"unit": "VESSEL_Time"
}
Response:
{
# BS(兩岸)、IS(國內)、CS(郵輪)
"list": [
{
"year": "2019",
"value": [
{
#
"name": "BS",
# 根據 request.unit 為 艘次 or 人次
"mtdPl": 551.22
},
{
"name": "IS",
"mtdPl": 644.26
},
{
"name": "CS",
"mtdPl": 3231.71
},
{
"name": "Total",
"mtdPl": 4427.19
}
]
},
{
"year": "2020",
"value": [
{
"name": "CS",
"mtdPl": 877.77
},
{
"name": "BS",
"mtdPl": 27.83
},
{
"name": "IS",
"mtdPl": 3821.86
},
{
"name": "Total",
"mtdPl": 4727.46
}
]
},
{
"year": "2021",
"value": [
{
"name": "BS",
"mtdPl": 0
},
{
"name": "IS",
"mtdPl": 1556.51
},
{
"name": "CS",
"mtdPl": 402.06
},
{
"name": "Total",
"mtdPl": 1958.57
}
]
},
{
"year": "2022",
"value": [
{
"name": "IS",
"mtdPl": 3773.81
},
{
"name": "BS",
"mtdPl": 0
},
{
"name": "CS",
"mtdPl": 2.11
},
{
"name": "Total",
"mtdPl": 3775.91
}
]
},
{
"year": "2023",
"value": [
{
"name": "IS",
"mtdPl": 2068.94
},
{
"name": "CS",
"mtdPl": 407.05
},
{
"name": "BS",
"mtdPl": 0
},
{
"name": "Total",
"mtdPl": 2475.99
}
]
}
],
"currentPage": 0,
"totalItems": 0,
"totalPages": 0
}
```
## CS-02：近五年總客運量趨勢：MP(母港)、HP(掛靠港)
/tipc/travelship/cs02/portOfCall/year
``` json
Request:
{
"startDate": "2023-01-01",
"endDate": "2023-05-01",
# 各分公司
"companyCode": [
"HQO",
"KELHB",
"TXGHB",
"KHHHB",
"HUNHB"
],
# 分公司對應的港口
"portCode": [
"KEL",
"TXG",
"TPE",
"SUO",
"KHH",
"APG",
"HUN",
"PUT",
"MZG"
],
# MP(母港)、HP(掛靠港)
"portOfCallCode": [
"MP","HP"
],
# BS(兩岸)、IS(國內)、CS(郵輪)
"shipTypeCode": [
"BS","IS","CS"
],
# VESSEL_Time(艘次)、Traveler_Time(人次)
"unit": "VESSEL_Time"
}
Response:
{
# MP(母港)、HP(掛靠港)
"list": [
{
"year": "2019",
"value": [
{
"name": "MP",
"mtdPl": 7.87
},
{
"name": "HP",
"mtdPl": 0.55
},
{
"name": "Total",
"mtdPl": 8.42
}
]
},
{
"year": "2020",
"value": [
{
"name": "MP",
"mtdPl": 17.77
},
{
"name": "HP",
"mtdPl": 0.38
},
{
"name": "Total",
"mtdPl": 18.16
}
]
},
{
"year": "2021",
"value": [
{
"name": "MP",
"mtdPl": 9.82
},
{
"name": "HP",
"mtdPl": 0.17
},
{
"name": "Total",
"mtdPl": 9.99
}
]
},
{
"year": "2022",
"value": [
{
"name": "HP",
"mtdPl": 0.02
},
{
"name": "MP",
"mtdPl": 16.98
},
{
"name": "Total",
"mtdPl": 17
}
]
},
{
"year": "2023",
"value": [
{
"name": "MP",
"mtdPl": 7.97
},
{
"name": "HP",
"mtdPl": 0.24
},
{
"name": "Total",
"mtdPl": 8.21
}
]
}
],
"currentPage": 0,
"totalItems": 0,
"totalPages": 0
}
```
## CS-03：近五年各港客運量趨勢
/tipc/travelship/cs03/year
``` json
Request:
{
"startDate": "2023-03-01",
"endDate": "2023-05-01",
"companyCode": [
"HQO",
"KELHB",
"TXGHB",
"KHHHB",
"HUNHB"
],
"portCode": [
"KEL",
"TXG",
"TPE",
"SUO",
"KHH",
"APG",
"HUN",
"PUT",
"MZG"
],
"portOfCallCode": [
"MP","HP"
],
"shipTypeCode": [
"BS","IS","CS"
],
"unit": "VESSEL_Time"
}
Response:
{
"list": [
{
"year": "2019",
"value": [
{
"name": "安平港",
"mtdPl": 0
},
{
"name": "澎湖港",
"mtdPl": 0
},
{
"name": "花蓮港",
"mtdPl": 0.07
},
{
"name": "蘇澳港",
"mtdPl": 0.11
},
{
"name": "臺中港",
"mtdPl": 0.45
},
{
"name": "臺北港",
"mtdPl": 0.47
},
{
"name": "高雄港",
"mtdPl": 0.48
},
{
"name": "基隆港",
"mtdPl": 1.42
},
{
"name": "Total",
"mtdPl": 2.99
}
]
},
{
"year": "2020",
"value": [
{
"name": "安平港",
"mtdPl": 0.02
},
{
"name": "蘇澳港",
"mtdPl": 0.02
},
{
"name": "臺北港",
"mtdPl": 0.04
},
{
"name": "花蓮港",
"mtdPl": 0.08
},
{
"name": "臺中港",
"mtdPl": 0.19
},
{
"name": "高雄港",
"mtdPl": 0.37
},
{
"name": "基隆港",
"mtdPl": 0.9
},
{
"name": "布袋港",
"mtdPl": 1.43
},
{
"name": "澎湖港",
"mtdPl": 1.93
},
{
"name": "Total",
"mtdPl": 4.99
}
]
},
{
"year": "2021",
"value": [
{
"name": "花蓮港",
"mtdPl": 0.04
},
{
"name": "安平港",
"mtdPl": 0.05
},
{
"name": "臺中港",
"mtdPl": 0.17
},
{
"name": "高雄港",
"mtdPl": 0.33
},
{
"name": "布袋港",
"mtdPl": 0.61
},
{
"name": "基隆港",
"mtdPl": 0.79
},
{
"name": "澎湖港",
"mtdPl": 0.87
},
{
"name": "Total",
"mtdPl": 2.85
}
]
},
{
"year": "2022",
"value": [
{
"name": "花蓮港",
"mtdPl": 0.01
},
{
"name": "安平港",
"mtdPl": 0.03
},
{
"name": "臺北港",
"mtdPl": 0.17
},
{
"name": "臺中港",
"mtdPl": 0.17
},
{
"name": "高雄港",
"mtdPl": 0.38
},
{
"name": "基隆港",
"mtdPl": 0.74
},
{
"name": "布袋港",
"mtdPl": 1.39
},
{
"name": "澎湖港",
"mtdPl": 1.73
},
{
"name": "Total",
"mtdPl": 4.61
}
]
},
{
"year": "2023",
"value": [
{
"name": "花蓮港",
"mtdPl": 0.01
},
{
"name": "安平港",
"mtdPl": 0.02
},
{
"name": "臺北港",
"mtdPl": 0.04
},
{
"name": "臺中港",
"mtdPl": 0.04
},
{
"name": "高雄港",
"mtdPl": 0.15
},
{
"name": "基隆港",
"mtdPl": 0.26
},
{
"name": "布袋港",
"mtdPl": 0.72
},
{
"name": "澎湖港",
"mtdPl": 0.92
},
{
"name": "Total",
"mtdPl": 2.17
}
]
}
],
"currentPage": 0,
"totalItems": 0,
"totalPages": 0
}
```
## CS-04：近五年各月客運量趨勢
/tipc/travelship/cs04/year
``` json
Request:
{
"startDate": "2023-03-01",
"endDate": "2023-05-01",
"companyCode": [
"HQO",
"KELHB",
"TXGHB",
"KHHHB",
"HUNHB"
],
"portCode": [
"KEL",
"TXG",
"TPE",
"SUO",
"KHH",
"APG",
"HUN",
"PUT",
"MZG"
],
"portOfCallCode": [
"MP","HP"
],
"shipTypeCode": [
"BS","IS","CS"
],
"unit": "VESSEL_Time"
}
Response:
{
"list": [
{
"year": "2019",
"value": [
{
"month": "1",
"mtdPl": 45.93
},
{
"month": "2",
"mtdPl": 89.42
},
{
"month": "3",
"mtdPl": 126.13
},
{
"month": "4",
"mtdPl": 189.77
},
{
"month": "5",
"mtdPl": 215.9
},
{
"month": "6",
"mtdPl": 180.98
},
{
"month": "7",
"mtdPl": 190.88
},
{
"month": "8",
"mtdPl": 129.55
},
{
"month": "9",
"mtdPl": 90.17
},
{
"month": "10",
"mtdPl": 97.25
},
{
"month": "11",
"mtdPl": 63.38
},
{
"month": "12",
"mtdPl": 88.69
},
{
"month": "Total",
"mtdPl": 1508.03
}
]
},
{
"year": "2020",
"value": [
{
"month": "1",
"mtdPl": 73.73
},
{
"month": "2",
"mtdPl": 22.47
},
{
"month": "3",
"mtdPl": 7
},
{
"month": "4",
"mtdPl": 6.55
},
{
"month": "5",
"mtdPl": 8.89
},
{
"month": "6",
"mtdPl": 126.98
},
{
"month": "7",
"mtdPl": 320.28
},
{
"month": "8",
"mtdPl": 366
},
{
"month": "9",
"mtdPl": 183.14
},
{
"month": "10",
"mtdPl": 117.79
},
{
"month": "11",
"mtdPl": 44.77
},
{
"month": "12",
"mtdPl": 30.01
},
{
"month": "Total",
"mtdPl": 1307.61
}
]
},
{
"year": "2021",
"value": [
{
"month": "1",
"mtdPl": 27.9
},
{
"month": "2",
"mtdPl": 33.89
},
{
"month": "3",
"mtdPl": 51.46
},
{
"month": "4",
"mtdPl": 196.38
},
{
"month": "5",
"mtdPl": 129.29
},
{
"month": "6",
"mtdPl": 1.46
},
{
"month": "7",
"mtdPl": 5.1
},
{
"month": "8",
"mtdPl": 24.15
},
{
"month": "9",
"mtdPl": 52.99
},
{
"month": "10",
"mtdPl": 20.89
},
{
"month": "11",
"mtdPl": 7.92
},
{
"month": "12",
"mtdPl": 4.32
},
{
"month": "Total",
"mtdPl": 555.74
}
]
},
{
"year": "2022",
"value": [
{
"month": "1",
"mtdPl": 8.4
},
{
"month": "2",
"mtdPl": 7.9
},
{
"month": "3",
"mtdPl": 17.5
},
{
"month": "4",
"mtdPl": 92.98
},
{
"month": "5",
"mtdPl": 100.18
},
{
"month": "6",
"mtdPl": 150.97
},
{
"month": "7",
"mtdPl": 201.6
},
{
"month": "8",
"mtdPl": 205.07
},
{
"month": "9",
"mtdPl": 131.98
},
{
"month": "10",
"mtdPl": 38.63
},
{
"month": "11",
"mtdPl": 14.19
},
{
"month": "12",
"mtdPl": 7.67
},
{
"month": "Total",
"mtdPl": 977.05
}
]
},
{
"year": "2023",
"value": [
{
"month": "1",
"mtdPl": 12.83
},
{
"month": "2",
"mtdPl": 8.14
},
{
"month": "3",
"mtdPl": 42.12
},
{
"month": "4",
"mtdPl": 255.7
},
{
"month": "5",
"mtdPl": 354.61
},
{
"month": "6",
"mtdPl": 370.58
},
{
"month": "7",
"mtdPl": 335.71
},
{
"month": "8",
"mtdPl": 26.61
},
{
"month": "Total",
"mtdPl": 1406.29
}
]
}
],
"currentPage": 0,
"totalItems": 0,
"totalPages": 0
}
```
## CS-05：各港口國際郵輪分析
/tipc/travelship/cs05/port
``` json
Request:
{
"startDate": "2022-03-01",
"endDate": "2022-06-01",
"companyCode": [
"HQO",
"KELHB",
"TXGHB",
"KHHHB",
"HUNHB"
],
# 不能有台北港、布袋港
"portCode": [
"KEL",
"TXG",
"SUO",
"KHH",
"APG",
"HUN",
"MZG"
],
"portOfCallCode": [
"MP","HP"
],
"unit": "VESSEL_Time"
}
Response:
{
"list": [
{
# 港口名稱
"name": "基隆港",
# 港口代碼
"code": "KEL",
# 人次/艘次
"times": 0.27,
# 去年相同區間人次/艘次
"lastTimes": 0.3,
# 同期增減
"subtractTimes": -0.03,
# 成長率
"timesRate": -10
},
{
"name": "臺中港",
"code": "TXG",
"times": 0.05,
"lastTimes": 0.05,
"subtractTimes": 0,
"timesRate": 0
},
{
"name": "高雄港",
"code": "KHH",
"times": 0.15,
"lastTimes": 0.11,
"subtractTimes": 0.04,
"timesRate": 36.36
},
{
"name": "安平港",
"code": "APG",
"times": 0.01,
"lastTimes": 0.03,
"subtractTimes": -0.02,
"timesRate": -66.67
},
{
"name": "澎湖港",
"code": "MZG",
"times": 0.73,
"lastTimes": 0.52,
"subtractTimes": 0.21,
"timesRate": 40.38
}
],
"currentPage": 0,
"totalItems": 0,
"totalPages": 0
}
```
## CS-05：特定港口國際郵輪分析
/tipc/travelship/cs05/ship
``` json
Request:
{
"startDate": "2023-02-01",
"endDate": "2023-06-01",
# 特定港口代碼
"portCode": "TXG",
# VESSEL_Time(艘次)、Traveler_Time(人次)
"unit": "Traveler_Time"
}
Response:
{
"list": [
{
# 港口中文名稱
"name": "中遠之星",
# 人次/艘次
"times": 0
},
{
"name": "海峽號",
"times": 0
},
{
"name": "金門快輪",
"times": 2.12
}
],
"currentPage": 0,
"totalItems": 0,
"totalPages": 0
}
```
## CS-06：來台外國籍郵輪旅客分佈/前10大國家列表
/tipc/travelship/cs06/overview
``` json
Request:
{
"startDate": "2023-01-01",
"endDate": "2023-06-01",
"companyCode": [
"HQO",
"KELHB",
"TXGHB",
"KHHHB",
"HUNHB"
],
"portCode": [
"KEL",
"TXG",
"SUO",
"KHH",
"APG",
"HUN",
"MZG"
]
}
Response:
{
"list": [
{
# 國家名稱
"nationName": "香港",
# 國家代碼
"nationCode": "HK",
# 緯度
"latitude": 114.109497,
# 經度
"longitude": 22.396428,
# 人次(萬)
"times": 5.09,
# 人次佔總數百分比
"timesRate": 35.17,
"totalTimes": 0
},
{
"nationName": "日本",
"nationCode": "JP",
"latitude": 138.252924,
"longitude": 36.204824,
"times": 2.52,
"timesRate": 17.41,
"totalTimes": 0
},
{
"nationName": "美國",
"nationCode": "US",
"latitude": -95.712891,
"longitude": 37.09024,
"times": 1.98,
"timesRate": 13.67,
"totalTimes": 0
},
{
"nationName": "德國",
"nationCode": "DE",
"latitude": 10.451526,
"longitude": 51.165691,
"times": 1.08,
"timesRate": 7.46,
"totalTimes": 0
},
{
"nationName": "英國",
"nationCode": "GB",
"latitude": -3.435973,
"longitude": 55.378051,
"times": 0.85,
"timesRate": 5.88,
"totalTimes": 0
},
{
"nationName": "韓國",
"nationCode": "KR",
"latitude": 127.766922,
"longitude": 35.907757,
"times": 0.59,
"timesRate": 4.08,
"totalTimes": 0
},
{
"nationName": "加拿大",
"nationCode": "CA",
"latitude": -106.346771,
"longitude": 56.130366,
"times": 0.58,
"timesRate": 4.02,
"totalTimes": 0
},
{
"nationName": "澳洲",
"nationCode": "AU",
"latitude": 133.775136,
"longitude": -25.274398,
"times": 0.55,
"timesRate": 3.81,
"totalTimes": 0
},
{
"nationName": "法國",
"nationCode": "FR",
"latitude": 2.213749,
"longitude": 46.227638,
"times": 0.14,
"timesRate": 1,
"totalTimes": 0
},
{
"nationName": "新加坡",
"nationCode": "SG",
"latitude": 103.819836,
"longitude": 1.352083,
"times": 0.09,
"timesRate": 0.62,
"totalTimes": 0
},
{
# 總人數
"nationName": "Total",
"nationCode": null,
"latitude": null,
"longitude": null,
"times": null,
"timesRate": null,
"totalTimes": 144.87
}
],
"currentPage": 0,
"totalItems": 0,
"totalPages": 0
}
```
## 取得各港口類型
Http Get ==> /tipc/travelship/getPortShipTypes
``` json
Response:
[
{
"portCode": "HUN",
"shipTypes": [
"IS",
"CS"
]
},
{
"portCode": "TXG",
"shipTypes": [
"BS",
"IS",
"CS"
]
},
{
"portCode": "KEL",
"shipTypes": [
"BS",
"IS",
"CS"
]
},
{
"portCode": "TPE",
"shipTypes": [
"BS",
"IS"
]
},
{
"portCode": "APG",
"shipTypes": [
"BS",
"IS",
"CS"
]
},
{
"portCode": "KHH",
"shipTypes": [
"BS",
"IS",
"CS"
]
},
{
"portCode": "MZG",
"shipTypes": [
"IS",
"CS"
]
},
{
"portCode": "SUO",
"shipTypes": [
"IS",
"CS"
]
},
{
"portCode": "PUT",
"shipTypes": [
"IS"
]
}
]
```
Sign in with Wallet
Connect another wallet