# OData查詢選項 $filter

## ◎ 邏輯運算子語法

![](/files/pG3MVVD1pgewJ85XD4WP)

**邏輯運算子範例**

1. 取得臺北公車動態定時，車牌號碼等於636-U7的資料[<mark style="color:blue;">https://tdx.transportdata.tw/api/basic/v2/Bus/RealTimeByFrequency/City/Taipei?$ filter=PlateNumb eq '636-U7'</mark>](https://tdx.transportdata.tw/api/basic/v2/Bus/RealTimeByFrequency/City/Taipei?$%20filter=PlateNumb%20eq%20%27636-U7%27)
2. 取得臺北公車動態定時，行車狀況不等於正常的資料[<mark style="color:blue;">https://tdx.transportdata.tw/api/basic/v2/Bus/RealTimeByFrequency/City/Taipei?$ filter=BusStatus ne '正常'</mark>](https://tdx.transportdata.tw/api/basic/v2/Bus/RealTimeByFrequency/City/Taipei?$%20filter=BusStatus%20ne%20%27%E6%AD%A3%E5%B8%B8%27)
3. 取得臺北公車動態定時，行駛速度超過100的資料[<mark style="color:blue;">https://tdx.transportdata.tw/api/basic/v2/Bus/RealTimeByFrequency/City/Taipei?$ filter=Speed gt 100</mark>](https://tdx.transportdata.tw/api/basic/v2/Bus/RealTimeByFrequency/City/Taipei?$%20filter=Speed%20gt%20100)
4. 取得臺北公車動態定時，行駛速度大於等於100的資料<mark style="color:blue;"><https://tdx.transportdata.tw/api/basic/v2/Bus/RealTimeByFrequency/City/Taipei?$filter=Speed> ge 100</mark>
5. 取得臺北公車動態定時，行駛速度不及100的資料 [<mark style="color:blue;">https://tdx.transportdata.tw/api/basic/v2/Bus/RealTimeByFrequency/City/Taipei?$filter=Speed lt 100</mark>](https://tdx.transportdata.tw/api/basic/v2/Bus/RealTimeByFrequency/City/Taipei?$filter=Speed%20lt%20100)
6. 取得臺北公車動態定時，行駛速度小於等於100的資料 [<mark style="color:blue;">https://tdx.transportdata.tw/api/basic/v2/Bus/RealTimeByFrequency/City/Taipei?$filter=Speed le 100</mark>](https://tdx.transportdata.tw/api/basic/v2/Bus/RealTimeByFrequency/City/Taipei?$filter=Speed%20le%20100)
7. 取得臺北公車動態定時，行駛速度不及100，且行車狀況不等於正常的資料 [<mark style="color:blue;">https://tdx.transportdata.tw/api/basic/v2/Bus/RealTimeByFrequency/City/Taipei?$filter=Speed lt 100 and BusStatus ne '正常'</mark>](https://tdx.transportdata.tw/api/basic/v2/Bus/RealTimeByFrequency/City/Taipei?$filter=Speed%20lt%20100%20and%20BusStatus%20ne%20%27%E6%AD%A3%E5%B8%B8%27)
8. 取得臺北公車動態定時，行駛速度不及100，或行車狀況不等於正常的資料 [<mark style="color:blue;">https://tdx.transportdata.tw/api/basic/v2/Bus/RealTimeByFrequency/City/Taipei?$filter=Speed lt 100 or BusStatus ne '正常'</mark>](https://tdx.transportdata.tw/api/basic/v2/Bus/RealTimeByFrequency/City/Taipei?$filter=Speed%20lt%20100%20or%20BusStatus%20ne%20%27%E6%AD%A3%E5%B8%B8%27)
9. 取得臺北公車動態定時，車牌號碼的結尾不為U7的資料 [<mark style="color:blue;">https://tdx.transportdata.tw/api/basic/v2/Bus/RealTimeByFrequency/City/Taipei?$filter=not endswith(PlateNumb,'U7')</mark>](https://tdx.transportdata.tw/api/basic/v2/Bus/RealTimeByFrequency/City/Taipei?$filter=not%20endswith\(PlateNumb,%27U7%27\))

## ◎ **算術運算子語法**

![](/files/UCcssUuMU6xUPDBIWsU1)

**算術運算子範例**

1. 取得臺北公車動態定時，行駛速度加2等於102的資料<mark style="color:blue;"><https://tdx.transportdata.tw/api/basic/v2/Bus/RealTimeByFrequency/City/Taipei?$filter=Speed> add 2 eq 102</mark>
2. 取得臺北公車動態定時，行駛速度減2等於102的資料<mark style="color:blue;"><https://tdx.transportdata.tw/api/basic/v2/Bus/RealTimeByFrequency/City/Taipei?$filter=Speed> sub 2 eq 102</mark>
3. 取得臺北公車動態定時，行駛速度乘2等於102的資料[<mark style="color:blue;">https://tdx.transportdata.tw/api/basic/v2/Bus/RealTimeByFrequency/City/Taipei?$filter=Speed mul 2 eq 102</mark>](https://tdx.transportdata.tw/api/basic/v2/Bus/RealTimeByFrequency/City/Taipei?$filter=Speed%20mul%202%20eq%20102)
4. 取得臺北公車動態定時，行駛速度除2等於102的資料<mark style="color:blue;"><https://tdx.transportdata.tw/api/basic/v2/Bus/RealTimeByFrequency/City/Taipei?$filter=Speed> div 2 eq 102</mark>
5. 取得臺北公車動態定時，行駛速度除2的餘數等於2的資料<mark style="color:blue;"><https://tdx.transportdata.tw/api/basic/v2/Bus/RealTimeByFrequency/City/Taipei?$filter=Speed> mod 2 eq 2</mark>

## ◎ 規範函數**語法**

![](/files/RIqp6Gp524W50pBa7A0M)

**規範函數範例**

1. 取得臺北公車動態定時，車牌號碼第0個位置開始算的2個字元為41的資料[https://tdx.transportdata.tw/api/basic<mark style="color:blue;">/v2/Bus/RealTimeByFrequency/City/Taipei?$filter=substring(PlateNumb,0,2) eq '41'</mark>](https://tdx.transportdata.tw/api/basic/v2/Bus/RealTimeByFrequency/City/Taipei?$filter=substring\(PlateNumb,0,2\)%20eq%20%2741%27)
2. 取得臺北公車動態定時，車牌號碼的結尾為U7的資料[https://tdx.transportdata.tw/api/basic<mark style="color:blue;">/v2/Bus/RealTimeByFrequency/City/Taipei?$filter=endswith(PlateNumb,'U7')</mark>](https://tdx.transportdata.tw/api/basic/v2/Bus/RealTimeByFrequency/City/Taipei?$filter=endswith\(PlateNumb,%27U7%27\))
3. 取得臺北公車動態定時，車牌號碼的開頭為U7的資料<mark style="color:blue;"><https://tdx.transportdata.tw/api/basic/v2/Bus/RealTimeByFrequency/City/Taipei?$filter=startswith(PlateNumb,'U7>')</mark>
4. 取得臺北公車動態定時，車牌號碼的長度為7的資料[https://tdx.transportdata.tw/api/basic/v2/Bus/RealTimeByFrequency/City/Taipei?$filter=length(PlateNumb) eq 7](https://tdx.transportdata.tw/api/basic/v2/Bus/RealTimeByFrequency/City/Taipei?$filter=length\(PlateNumb\)%20eq%207)
5. 取得臺北公車動態定時，車牌號碼開頭(第0個位置)為F的資料[https://tdx.transportdata.tw/api/basic<mark style="color:blue;">/v2/Bus/RealTimeByFrequency/City/Taipei?$filter=indexof(PlateNumb,'F') eq 0</mark>](https://tdx.transportdata.tw/api/basic/v2/Bus/RealTimeByFrequency/City/Taipei?$filter=indexof\(PlateNumb,%27F%27\)%20eq%200)
6. 取得臺北公車動態定時，車牌號碼為小寫的字母fa-185的資料<mark style="color:blue;"><https://tdx.transportdata.tw/api/basic/v2/Bus/RealTimeByFrequency/City/Taipei?$filter=tolower(PlateNumb)> eq 'fa-185'</mark>
7. 取得臺北公車動態定時，車牌號碼為大寫的字母FA-185的資料<mark style="color:blue;"><https://tdx.transportdata.tw/api/basic/v2/Bus/RealTimeByFrequency/City/Taipei?$filter=toupper(PlateNumb)> eq 'FA-185'</mark>
8. 取得臺北公車動態定時，車牌號碼為去空白後的FA-185的資料<mark style="color:blue;"><https://tdx.transportdata.tw/api/basic/v2/Bus/RealTimeByFrequency/City/Taipei?$filter=trim(PlateNumb)> eq 'FA-185'</mark>
9. 取得臺北公車動態定時，車牌號碼為包含的FA的資料[https://tdx.transportdata.tw/api/basic<mark style="color:blue;">/v2/Bus/RealTimeByFrequency/City/Taipei?$filter=contains(PlateNumb, 'FA')</mark>](https://tdx.transportdata.tw/api/basic/v2/Bus/RealTimeByFrequency/City/Taipei?$filter=contains\(PlateNumb,%20%27FA%27\))
10. 取得臺北公車動態定時，資料紀錄時間的年份為2015年的資料<mark style="color:blue;"><https://tdx.transportdata.tw/api/basic/v2/Bus/RealTimeByFrequency/City/Taipei?$filter=year(UpdateTime)> eq 2015</mark>
11. 取得臺北公車動態定時，資料紀錄時間的月份為9月的資料<mark style="color:blue;"><https://tdx.transportdata.tw/api/basic/v2/Bus/RealTimeByFrequency/City/Taipei?$filter=month(UpdateTime)> eq 9</mark>
12. 取得臺北公車動態定時，資料紀錄時間的日期為18號的資料<mark style="color:blue;"><https://tdx.transportdata.tw/api/basic/v2/Bus/RealTimeByFrequency/City/Taipei?$filter=day(UpdateTime)> eq 18</mark>
13. 取得臺北公車動態定時，資料紀錄時間的小時為17點的資料<mark style="color:blue;"><https://tdx.transportdata.tw/api/basic/v2/Bus/RealTimeByFrequency/City/Taipei?$filter=hour(UpdateTime)> eq 17</mark>
14. 取得臺北公車動態定時，資料紀錄時間的分鐘為第17分的資料<mark style="color:blue;"><https://tdx.transportdata.tw/api/basic/v2/Bus/RealTimeByFrequency/City/Taipei?$filter=minute(UpdateTime)> eq 17</mark>
15. 取得臺北公車動態定時，資料紀錄時間的秒數為第1秒的資料<mark style="color:blue;"><https://tdx.transportdata.tw/api/basic/v2/Bus/RealTimeByFrequency/City/Taipei?$filter=second(UpdateTime)> eq 1</mark>
16. 取得臺北公車動態定時，資料紀錄時間的毫秒為0.1秒的資料<mark style="color:blue;"><https://tdx.transportdata.tw/api/basic/v2/Bus/RealTimeByFrequency/City/Taipei?$filter=fractionalseconds(UpdateTime)> eq 0.1</mark>
17. 取得臺北公車動態定時，資料紀錄時間的日期格式為\
    2022-07-06T10:10:10+08:00的資料[<mark style="color:blue;">https://tdx.transportdata.tw/api/basic/v2/Bus/RealTimeByFrequency/City/Taipei?$filter=date(UpdateTime) eq 2022-07-06</mark>](https://tdx.transportdata.tw/api/basic/v2/Bus/RealTimeByFrequency/City/Taipei?$filter=date\(UpdateTime\)%20eq%202022-07-06)
18. 取得臺北公車動態定時，資料紀錄時間的時間格式為\
    2022-07-06T10:10:10+08:00的資料<mark style="color:blue;"><https://tdx.transportdata.tw/api/basic/v2/Bus/RealTimeByFrequency/City/Taipei?$filter=time(UpdateTime)> eq 10:10:10</mark>
19. 取得臺北公車動態定時，行駛速度四捨五入為12的資料[https://tdx.transportdata.tw/api/basic<mark style="color:blue;">/v2/Bus/RealTimeByFrequency/City/Taipei?$filter=round(Speed) eq 12</mark>](https://tdx.transportdata.tw/api/basic/v2/Bus/RealTimeByFrequency/City/Taipei?$filter=round\(Speed\)%20eq%2012)
20. 取得臺北公車動態定時，行駛速度去小數直接往小的整數進位為12的資料[https://tdx.transportdata.tw/api/basic<mark style="color:blue;">/v2/Bus/RealTimeByFrequency/City/Taipei?$filter=floor(Speed) eq 12</mark>](https://tdx.transportdata.tw/api/basic/v2/Bus/RealTimeByFrequency/City/Taipei?$filter=floor\(Speed\)%20eq%2012)
21. 取得臺北公車動態定時，行駛速度去小數直接往大的整數進位為12的資料[https://tdx.transportdata.tw/api/basic<mark style="color:blue;">/v2/Bus/RealTimeByFrequency/City/Taipei?$filter=ceiling(Speed) eq 12</mark>](https://tdx.transportdata.tw/api/basic/v2/Bus/RealTimeByFrequency/City/Taipei?$filter=ceiling\(Speed\)%20eq%2012)
22. 取得臺北公車動態定時，行駛速度轉型成字串為12的資料[https://tdx.transportdata.tw/api/basic<mark style="color:blue;">/v2/Bus/RealTimeByFrequency/City/Taipei?$filter=cast(Speed,Edm.String) eq '12'</mark>](https://tdx.transportdata.tw/api/basic/v2/Bus/RealTimeByFrequency/City/Taipei?$filter=cast\(Speed,Edm.String\)%20eq%20%2712%27)
23. 取得臺北公車動態定時，車牌號碼前面串接台北兩個字為台北636-U7的資料<mark style="color:blue;"><https://tdx.transportdata.tw/api/basic/v2/Bus/RealTimeByFrequency/City/Taipei?$filter=concat('台北',PlateNumb)> eq '台北636-U7'</mark>

## ◎ Lambda Operators語法

![](/files/qG3BoaqAhBmklcXTXDAY)

**Lambda Operators範例**

1. 取得高鐵車次時，針對停靠時間資料底下的車站代碼，其中一筆的車站代碼 為1000的資料就回傳<mark style="color:blue;"><https://tdx.transportdata.tw/api/basic/v2/Rail/THSR/DailyTimetable?$filter=StopTimes/any(d:d/StationID> eq '1000')</mark>
2. 取得高鐵車次時，針對停靠時間資料底下的車站代碼，全部的車站代碼為1000的資料就回傳<mark style="color:blue;"><https://tdx.transportdata.tw/api/basic/v2/Rail/THSR/DailyTimetable?$filter=StopTimes/all(d:d/StationID> eq '1000')</mark>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://motc-ptx.gitbook.io/tdx-xin-shou-zhi-yin/api-te-se-shuo-ming/zhi-yuan-odata-cha-xun-yu-fa/odata-cha-xun/odata-cha-xun-xuan-xiang-filter.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.