領域服務


智慧交通-車隊管理服務

車隊管理服務提供車機設備管理功能,相關使用與開發方式如下說明:
1. 南向協定:車機廠商可實作南向協定完成資料上傳以及指令轉送功能,並將相關資料儲存在平台中。
2. 北向 API:資料使用者可利用北向 API 取得平台中的資料,或是下達指令到平台後由 UDP Adapter 轉送至車機設備。
3. 設備納管:有實作南向協定的車機設備可利用掃描 QRCode 的方式進行設備納管,將整體流程自動化達成車隊管理的目的。
註1:南向協定說明文件請參考章節「相關連結」
註2:南向協定僅能以 UDP 協定實作,不支援 TCP 協定
註3:北向 API 請參考 API 文件說明

服務使用說明

步驟一、註冊會員
想要成為中華電信 IoT智慧聯網大平台會員,您必須透過一個 CHT 會員中心帳號 ,才可以於自己的帳號之下,新增專案、裝置、感測器,並存取相關的數據(Data)。
步驟二、新增專案
在透過CHT會員中心帳號登入之後,請於 IoT 平台網站右上方 專案管理 頁面新增專案,並在【基本資料】的頁籤中,輸入專案名稱以及專案描述,另外在【權限資料】的頁籤中,相關的設定預設會自動產生,您就可以獲取18碼英數字組合之 Project Key,這把金鑰將在您呼叫 API 時需要代入參數之中;當然,您也可以調整它所擁有的權限,預設是 Admin (完整權限),以下為流程操作圖,以及各個欄位之簡要說明:
* 專案管理/增加專案
* 填寫基本資料
* 瀏覽權限資料
步驟三、新增車機設備 (車機設備需實作南向協定)
使用者可透過平台提供的 APP 掃描車機設備上的 QRCode 將車機設備納管至專案中, 納管後設備內的所有感測器便會自動建立,並產生相對應的設備金鑰 (Device Key) 讓您在存取北向 API 時使用。 使用者也可自行建立設備,並對應車機設備實作的南向協定在平台上自行新增感測器。
* 掃描 QRCode
* 設備納管完成
* 設備金鑰 (Device Key)
步驟四、上傳數據
使用者納管車機設備後,可直接使用車機設備並在戶外進行測試,並利用平台的網頁確認車機設備是否正常將數據傳送到平台上。
* 利用平台網頁檢查車機設備上傳的數據
步驟五、取回數據
使用者完成前述步驟後,可利用北向 API 文件實作相關服務,並取得車機上傳的數據並確認是否正常。 使用者可以選擇透過 RESTful API 去訪問平台端,進而取得感測器上的數據。下面是使用北向 API 的範例,在範例開始前您必須先在 Chrome 瀏覽器中安裝相關的套件 Postman 用以測試 RESTful API;除了透過上述之瀏覽器套件獲取數據以外,你也可以於自己開發的 IoT 應用程式中,善用豐富的 API 來達成物聯網智慧應用。
1. RESTful API 主動取回數據
本範例將展示如何藉由 RESTful API 主動來取得車機設備之GPS數據 (GPSdata), 請參考下圖說明來進行操作,若您有更多樣化的需求,如:取得歷史GPS資料、取得特定感測器最新一筆數值...等,請查看詳細的 北向 API 文件說明
* 以 RESTful API 成功取回 GPSdata
步驟六、下達指令
使用者在確認數據上傳和取回數據成功後,可利用北向 API 下指令到平台,平台再轉送指令到車機設備。最後使用者可確認指令是否下達成功。下面是使用北向 API 的範例,在範例開始前您必須先在 Chrome 瀏覽器中安裝相關的套件 Postman 用以測試 RESTful API;除了透過上述之瀏覽器套件獲取數據以外,你也可以於自己開發的 IoT 應用程式中,善用豐富的 API 來達成物聯網智慧應用。
1. RESTful API 測試下達指令
本範例將展示如何藉由 RESTful API 主動針對車機設備的特定一個感測器 (Sensor) 下達指令, 請參考下圖說明來進行操作。
* 以 RESTful API 對車機設備的特定一個感測器下達指令