> For the complete documentation index, see [llms.txt](https://motc-ptx-api-documentation.gitbook.io/motc-ptx-api-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://motc-ptx-api-documentation.gitbook.io/motc-ptx-api-documentation/api-te-se/odata.md).

# 支援OData查詢語法

## OData語法

|       OData語法       |        說明        |                                                           範例                                                          |
| :-----------------: | :--------------: | :-------------------------------------------------------------------------------------------------------------------: |
|        format       | 資料格式json、xml、csv |                                           <p>回傳xml格式<br>$format=xml<br></p>                                           |
|        select       |     回傳資料的某些欄位    |                                          <p>回傳欄位1<br>$select= Field1<br></p>                                          |
|         top         |       取最前筆數      |                                              <p>取前10筆 <br>$top=10<br></p>                                             |
|         skip        |       跳過筆數       |                                            <p>跳過前100筆 <br>$skip=100<br></p>                                           |
|        filter       |   回傳符合特定表達式的資料   |                              <p>車牌號碼等於636-U7的資料<br>$filter=PlateNumb eq '636-U7'<br></p>                              |
|         date        |        日期        |                   <p>UpdateTime的日期格式為2015-09-17的資料<br>$filter=date(UpdateTime) eq 2015-09-17<br></p>                  |
|         time        |        時間        |                  <p>UpdateTime的時間格式為17:57:00+08:00的資料<br>$filter=time(UpdateTime) eq 11:59:48<br></p>                 |
|       contains      |        包含        |                              <p>車牌號碼包含FA的資料<br>$filter=contains(PlateNumb, 'FA')<br></p>                              |
|         all         |     所有項目都要符合     |            <p>針對停靠時間資料底下車站代碼，全部的車站代碼為1000的資料就回傳 <br> $filter=StopTimes/all(d:d/StationID eq '1000')<br></p>           |
|         any         |      其中一項符合      |            <p>針對停靠時間資料底下車站代碼，任一筆的車站代碼為1000的資料就回傳 <br>$filter=StopTimes/any(d:d/StationID eq '1000')<br></p>           |
| orderby {Field asc} |     針對某欄位作升冪     |                                      <p>針對欄位1作升冪<br>$orderby= Field1 asc<br></p>                                      |
| orderby{Field desc} |     針對某欄位作降冪     |                                      <p>針對欄位1作降冪<br>$orderby= Field1 desc<br></p>                                     |
|    spatialFilter    |     尋找附近點位資料     | <p>尋找: 緯度25.05463, 經度121.46584 ，範圍150 公尺內的資料<br>$spatialFilter=nearby(StopPosition, 25.05463, 121.46584, 150)<br></p> |

## 更多OData服務開發教學請詳見以下連結

[http://ptx.transportdata.tw/ptx/Download/公共運輸整合資訊平台資料服務開發實作.pdf](https://docs.google.com/viewer?url=https://github.com/ptxmotc/PTX_Web/blob/master/Swagger服務說明上傳參考檔案/公共運輸整合資訊平台資料服務開發實作.pdf?raw=true)