---
# System prepended metadata

title: TWPORT-90-2 船舶統計-船噸分析

---

- **url**: `'/tipc/ship-stat/'`

- **VSL04 API**: `'vsl04'
- request Payload
``` javaSctipt
{  
  startDate: string
  endDate: string
  company: string[] // 公司代號
  port: string[] // 港口代號

}
    
```

- responese

```javascript
{ 
    currentPage: number
    list: [{
      shipmentType: string // 貨櫃船/雜散貨船/郵輪/油化輪/其他船種/離岸風電工作船
      time: string
      values:[{
      year: string
      value: number
    }]
    totalItem: number
    totalPage: number
}
```

``` JSON
const apiData =
{
    currentPage: 0
    totalItem: 0
    totalPage: 0
    list: [
       {
        values: [
          {
            year: '2014',
            value: 10
          },
          {
            year: '2015',
            value: 15
          },
          {
            year: '2016',
            value: 5

          },
          {
            year: '2017',
            value: 18
          },
          {
            year: '2018',
            value: 20
          },
          {
            year: '2019',
            value: 22
          },
          {
            year: '2020',
            value: 17
          },
          {
            year: '2021',
            value: 20
          },
          {
            year: '2022',
            value: 38
          },
          {
            year: '2023',
            value: 40
          }
        ],
        shipmentType: '貨櫃船',
        time: '2023-01~2023-05'
      },
      {
        values: [
          {
            year: '2014',
            value: 20
          },
          {
            year: '2015',
            value: 30
          },
          {
            year: '2016',
            value: 4

          },
          {
            year: '2017',
            value: 18
          },
          {
            year: '2018',
            value: 20
          },
          {
            year: '2019',
            value: 22
          },
          {
            year: '2020',
            value: 17
          },
          {
            year: '2021',
            value: 20
          },
          {
            year: '2022',
            value: 38
          },
          {
            year: '2023',
            value: 40
          }
        ],
        shipmentType: '雜散貨船',
        time: '2023-01~2023-05'
      },
      {
        values: [
          {
            year: '2014',
            value: 10
          },
          {
            year: '2015',
            value: 15
          },
          {
            year: '2016',
            value: 5

          },
          {
            year: '2017',
            value: 18
          },
          {
            year: '2018',
            value: 20
          },
          {
            year: '2019',
            value: 22
          },
          {
            year: '2020',
            value: 17
          },
          {
            year: '2021',
            value: 20
          },
          {
            year: '2022',
            value: 38
          },
          {
            year: '2023',
            value: 40
          }
        ],
        shipmentType: '郵輪',
        time: '2023-01~2023-05'
      },
      {
        values: [
          {
            year: '2014',
            value: 10
          },
          {
            year: '2015',
            value: 15
          },
          {
            year: '2016',
            value: 5

          },
          {
            year: '2017',
            value: 18
          },
          {
            year: '2018',
            value: 20
          },
          {
            year: '2019',
            value: 22
          },
          {
            year: '2020',
            value: 17
          },
          {
            year: '2021',
            value: 20
          },
          {
            year: '2022',
            value: 38
          },
          {
            year: '2023',
            value: 40
          }
        ],
        shipmentType: '油化輪',
        time: '2023-01~2023-05'
      },
      {
        values: [
          {
            year: '2014',
            value: 10
          },
          {
            year: '2015',
            value: 15
          },
          {
            year: '2016',
            value: 5

          },
          {
            year: '2017',
            value: 18
          },
          {
            year: '2018',
            value: 20
          },
          {
            year: '2019',
            value: 22
          },
          {
            year: '2020',
            value: 17
          },
          {
            year: '2021',
            value: 20
          },
          {
            year: '2022',
            value: 38
          },
          {
            year: '2023',
            value: 40
          }
        ],
        shipmentType: '其他船種',
        time: '2023-01~2023-05'
      },
      {
        values: [
          {
            year: '2014',
            value: 10
          },
          {
            year: '2015',
            value: 15
          },
          {
            year: '2016',
            value: 5

          },
          {
            year: '2017',
            value: 18
          },
          {
            year: '2018',
            value: 20
          },
          {
            year: '2019',
            value: 22
          },
          {
            year: '2020',
            value: 17
          },
          {
            year: '2021',
            value: 20
          },
          {
            year: '2022',
            value: 38
          },
          {
            year: '2023',
            value: 40
          }
        ],
        shipmentType: '離岸風電工作船',
        time: '2023-01~2023-05'
      }
        ]
    }
```

- **url**: `'/tipc/ship-stat/'`

- **vsl05 API**: `'vsl05'

- request Payload
``` javaSctipt
{    
  startDate: string
  endDate: string
  company: string[] // 公司代號
  port: string[] // 港口代號
}

```

- responese

```javascript
{ 
    currentPage: number
    list: [{
        name: string // 平均噸位/艘次
        time: string
        values:[
          type: string // 未滿40K/40~80K/80~120K/120~180K/總平均  // 只有 name 為平均噸位有 type '總平均' 而 name 為艘次沒有
          values: [{
              year: string,
              value: number
            }]  
        ]
    }]
    totalItem: number
    totalPage: number
}
```

``` JSON
const apiData =
{
    currentPage: 0
    totalItem: 0
    totalPage: 0
    list: [
             {
        values: [
          {
            values: [
              {
                year: '2014',
                value: 10
              },
              {
                year: '2015',
                value: 30
              },
              {
                year: '2016',
                value: 10

              },
              {
                year: '2017',
                value: 15
              },
              {
                year: '2018',
                value: 25
              },
              {
                year: '2019',
                value: 30
              },
              {
                year: '2020',
                value: 15
              },
              {
                year: '2021',
                value: 20
              },
              {
                year: '2022',
                value: 25
              },
              {
                year: '2023',
                value: 10
              }
            ],
            type: '未滿40K'
          },
          {
            values: [
              {
                year: '2014',
                value: 60
              },
              {
                year: '2015',
                value: 70
              },
              {
                year: '2016',
                value: 50

              },
              {
                year: '2017',
                value: 70
              },
              {
                year: '2018',
                value: 80
              },
              {
                year: '2019',
                value: 60
              },
              {
                year: '2020',
                value: 50
              },
              {
                year: '2021',
                value: 70
              },
              {
                year: '2022',
                value: 80
              },
              {
                year: '2023',
                value: 60
              }
            ],
            type: '40~80K'
          },
          {
            values: [
              {
                year: '2014',
                value: 100
              },
              {
                year: '2015',
                value: 110
              },
              {
                year: '2016',
                value: 90

              },
              {
                year: '2017',
                value: 120
              },
              {
                year: '2018',
                value: 130
              },
              {
                year: '2019',
                value: 110
              },
              {
                year: '2020',
                value: 100
              },
              {
                year: '2021',
                value: 120
              },
              {
                year: '2022',
                value: 130
              },
              {
                year: '2023',
                value: 110
              }
            ],
            type: '80~120K'
          },
          {
            values: [
              {
                year: '2014',
                value: 155
              },
              {
                year: '2015',
                value: 180
              },
              {
                year: '2016',
                value: 160

              },
              {
                year: '2017',
                value: 185
              },
              {
                year: '2018',
                value: 160
              },
              {
                year: '2019',
                value: 185
              },
              {
                year: '2020',
                value: 190
              },
              {
                year: '2021',
                value: 120
              },
              {
                year: '2022',
                value: 130
              },
              {
                year: '2023',
                value: 140
              }
            ],
            type: '120~180K'
          },
          {
            values: [
              {
                year: '2014',
                value: 210
              },
              {
                year: '2015',
                value: 240
              },
              {
                year: '2016',
                value: 220

              },
              {
                year: '2017',
                value: 210
              },
              {
                year: '2018',
                value: 200
              },
              {
                year: '2019',
                value: 290
              },
              {
                year: '2020',
                value: 220
              },
              {
                year: '2021',
                value: 230
              },
              {
                year: '2022',
                value: 200
              },
              {
                year: '2023',
                value: 210
              }
            ],
            type: '180K以上'
          },
          {
            values: [
              {
                year: '2014',
                value: 120
              },
              {
                year: '2015',
                value: 130
              },
              {
                year: '2016',
                value: 125

              },
              {
                year: '2017',
                value: 130
              },
              {
                year: '2018',
                value: 100
              },
              {
                year: '2019',
                value: 125
              },
              {
                year: '2020',
                value: 130
              },
              {
                year: '2021',
                value: 140
              },
              {
                year: '2022',
                value: 100
              },
              {
                year: '2023',
                value: 130
              }
            ],
            type: '總平均'
          }
        ],
        name: '平均噸位',
          time: '2023-01~2023-05'
      },
      {
        values: [
          {
            values: [
              {
                year: '2014',
                value: 200
              },
              {
                year: '2015',
                value: 200
              },
              {
                year: '2016',
                value: 300

              },
              {
                year: '2017',
                value: 200
              },
              {
                year: '2018',
                value: 250
              },
              {
                year: '2019',
                value: 350
              },
              {
                year: '2020',
                value: 150
              },
              {
                year: '2021',
                value: 200
              },
              {
                year: '2022',
                value: 300
              },
              {
                year: '2023',
                value: 100
              }
            ],
            type: '未滿40K'
          },
          {
            values: [
              {
                year: '2014',
                value: 390
              },
              {
                year: '2015',
                value: 500
              },
              {
                year: '2016',
                value: 390

              },
              {
                year: '2017',
                value: 490
              },
              {
                year: '2018',
                value: 490
              },
              {
                year: '2019',
                value: 450
              },
              {
                year: '2020',
                value: 480
              },
              {
                year: '2021',
                value: 490
              },
              {
                year: '2022',
                value: 500
              },
              {
                year: '2023',
                value: 510
              }
            ],
            type: '40~80K'
          },
          {
            values: [
              {
                year: '2014',
                value: 490
              },
              {
                year: '2015',
                value: 600
              },
              {
                year: '2016',
                value: 500

              },
              {
                year: '2017',
                value: 510
              },
              {
                year: '2018',
                value: 540
              },
              {
                year: '2019',
                value: 500
              },
              {
                year: '2020',
                value: 490
              },
              {
                year: '2021',
                value: 550
              },
              {
                year: '2022',
                value: 600
              },
              {
                year: '2023',
                value: 700
              }
            ],
            type: '80~120K'
          },
          {
            values: [
              {
                year: '2014',
                value: 750
              },
              {
                year: '2015',
                value: 1000
              },
              {
                year: '2016',
                value: 950

              },
              {
                year: '2017',
                value: 1000
              },
              {
                year: '2018',
                value: 950
              },
              {
                year: '2019',
                value: 800
              },
              {
                year: '2020',
                value: 900
              },
              {
                year: '2021',
                value: 950
              },
              {
                year: '2022',
                value: 1500
              },
              {
                year: '2023',
                value: 1800
              }
            ],
            type: '120~180K'
          },
          {
            values: [
              {
                year: '2014',
                value: 980
              },
              {
                year: '2015',
                value: 1300
              },
              {
                year: '2016',
                value: 1100

              },
              {
                year: '2017',
                value: 1400
              },
              {
                year: '2018',
                value: 1200
              },
              {
                year: '2019',
                value: 1490
              },
              {
                year: '2020',
                value: 1300
              },
              {
                year: '2021',
                value: 1500
              },
              {
                year: '2022',
                value: 1800
              },
              {
                year: '2023',
                value: 2100
              }
            ],
            type: '180K以上'
          }
        ],
        name: '艘次',
          time: '2023-01~2023-05'
      }
          
        ]
    }

```

