URI命名原則

交通部即時路況資訊平臺Open API開放資料可透過URL方式取得資料，以下將針對Traffic API URI進行說明。

【Web API 表現方式】

Web API （application programming interface）表現方式分為網站根目錄（App Root）、資源路徑（Resource Path）和查詢選項（Query Options）

• 網站根目錄：應用服務的基本網址，主要組成為（Domain）網域名稱和（App）應用程式名稱，並且透過 HTTP 協定連結而形成服務的基本網址。

  Domain: http://traffic.transportdata.tw/MOTC

  App : MOTC或Traffic

• 資源路徑：指定資源項目路徑名稱。

目錄結構	意義
Version	提供服務的版本號。目前提供 v2（第二版），若沒有輸入，則預設最新版本
Service	依據載具本身提供的服務，例如:路況(Traffic)。
Application	根據每個服務而提不同的應用內容，例如:路段（Section）、壅塞水準（CongestionLevel）、基礎路段組合(SectionLink)、路段線型圖資(SectionShape)、車輛偵測器(VD)、閉路電視攝影監控(CCTV)、資訊可變標誌(CMS)、自動車輛辨識(AVI)、自動車輛辨識配對(AVIPair)、電子標籤(ETag)、電子標籤配對(ETAGPair)等。

【Traffic API URI設計】

• Traffic Static API URI規則：

  • 取得指定[縣市]發布路段基本資料/Road/Traffic/Section/City/{City}

  • 取得指定[縣市]路況壅塞水準定義資料/Road/Traffic/CongestionLevel/City/{City}

  • 取得指定[縣市]發布路段與基礎路段組合對應資料/Road/Traffic/SectionLink/City/{City}

  • 取得指定[縣市]發布路段線型圖資資料/Road/Traffic/SectionShape/City/{City}

  • 取得[公路總局]發布路段基本資料/Road/Traffic/Section/Highway

  • 取得[公路總局]路況壅塞水準定義資料/Road/Traffic/CongestionLevel/Highway

  • 取得[公路總局]發布路段與基礎路段組合對應資料/Road/Traffic/SectionLink/Highway

  • 取得[公路總局]發布路段線型圖資資料/Road/Traffic/SectionShape/Highway

  • 取得[高速公路局]發布路段基本資料/Road/Traffic/Section/Freeway

  • 取得[高速公路局]路況壅塞水準定義資料/Road/Traffic/CongestionLevel/Freeway

  • 取得[高速公路局]發布路段與基礎路段組合對應資料/Road/Traffic/SectionLink/Freeway

  • 取得[高速公路局]發布路段線型圖資資料/Road/Traffic/SectionShape/Freeway

  • 取得指定[縣市]車輛偵測器基本資料/Road/Traffic/VD/City/{City}

  • 取得指定[縣市]閉路電視攝影監控基本資料/Road/Traffic/CCTV/City/{City}

  • 取得指定[縣市]資訊可變標誌基本資料/Road/Traffic/CMS/City/{City}

  • 取得指定[縣市]自動車輛辨識基本資料/Road/Traffic/AVI/City/{City}

  • 取得指定[縣市]自動車輛辨識配對基本資料/Road/Traffic/AVIPair/City/{City}

  • 取得指定[縣市]電子標籤基本資料/Road/Traffic/ETag/City/{City}

  • 取得指定[縣市]電子標籤配對基本資料/Road/Traffic/ETagPair/City/{City}

  • 取得[公路總局]車輛偵測器基本資料/Road/Traffic/VD/Highway

  • 取得[公路總局]閉路電視攝影監控基本資料/Road/Traffic/CCTV/Highway

  • 取得[公路總局]資訊可變標誌基本資料/Road/Traffic/CMS/Highway

  • 取得[公路總局]自動車輛辨識基本資料/Road/Traffic/AVI/Highway

  • 取得[公路總局]自動車輛辨識配對基本資料/Road/Traffic/AVIPair/Highway

  • 取得[公路總局]電子標籤基本資料/Road/Traffic/ETag/Highway

  • 取得[公路總局]電子標籤配對基本資料/Road/Traffic/ETagPair/Highway

  • 取得[高速公路局]車輛偵測器基本資料/Road/Traffic/VD/Freeway

  • 取得[高速公路局]閉路電視攝影監控基本資料/Road/Traffic/CCTV/Freeway

  • 取得[高速公路局]資訊可變標誌基本資料/Road/Traffic/CMS/Freeway

  • 取得[高速公路局]自動車輛辨識基本資料/Road/Traffic/AVI/Freeway

  • 取得[高速公路局]自動車輛辨識配對基本資料/Road/Traffic/AVIPair/Freeway

  • 取得[高速公路局]電子標籤基本資料/Road/Traffic/ETag/Freeway

  • 取得[高速公路局]電子標籤配對基本資料/Road/Traffic/ETagPair/Freeway

• Traffic Live API URI規則：

  • 取得指定[縣市]路段即時資料/Road/Traffic/Live/City/{City}

  • 取得指定[縣市]車輛偵測器即時資料/Road/Traffic/Live/VD/City/{City}

  • 取得指定[縣市]資訊可變標誌即時資料/Road/Traffic/Live/CMS/City/{City}

  • 取得指定[縣市]自動車輛辨識即時資料/Road/Traffic/Live/AVI/City/{City}

  • 取得指定[縣市]電子標籤即時資料/Road/Traffic/Live/ETag/City/{City}

  • 取得指定[縣市]透過車載GPS探偵產生之路段即時資料/Road/Traffic/Live/GVP/City/{City}

  • 取得指定[縣市]透過手機網路信令探偵產生之路段即時資料/Road/Traffic/Live/CVP/City/{City}

  • 取得[公路總局]路段即時資料/Road/Traffic/Live/Highway

  • 取得[公路總局]車輛偵測器即時資料/Road/Traffic/Live/VD/Highway

  • 取得[公路總局]資訊可變標誌即時資料/Road/Traffic/Live/CMS/Highway

  • 取得[公路總局]自動車輛辨識即時資料/Road/Traffic/Live/AVI/Highway

  • 取得[公路總局]電子標籤即時資料/Road/Traffic/Live/ETag/Highway

  • 取得[公路總局]透過車載GPS探偵產生之路段即時資料/Road/Traffic/Live/GVP/Highway

  • 取得[公路總局]透過手機網路信令探偵產生之路段即時資料/Road/Traffic/Live/CVP/Highway

  • 取得[高速公路局]路段即時資料/Road/Traffic/Live/Freeway

  • 取得[高速公路局]車輛偵測器即時資料/Road/Traffic/Live/VD/Freeway

  • 取得[高速公路局]資訊可變標誌即時資料/Road/Traffic/Live/CMS/Freeway

  • 取得[高速公路局]自動車輛辨識即時資料/Road/Traffic/Live/AVI/Freeway

  • 取得[高速公路局]電子標籤即時資料/Road/Traffic/Live/ETag/Freeway

  • 取得[高速公路局]透過車載GPS探偵產生之路段即時資料/Road/Traffic/Live/GVP/Freeway

  • 取得[高速公路局]透過手機網路信令探偵產生之路段即時資料/Road/Traffic/Live/CVP/Freeway