SSIS001 安裝、設定與常見問題全攻略 (2024 最新版)
SSIS001，全名為「臺灣交通部公路總局速限資訊服務」，是一個提供臺灣公路速限資訊的開源專案，近年來受到許多對交通數據分析、導航應用、車機整合等有需求的使用者青睞。它能讓你透過簡單的 API 介面，取得即時且準確的臺灣公路速限資訊，方便開發各式各樣的應用程式。本文將詳細說明 SSIS001 的安裝方法、設定步驟、常見問題，以及進階使用技巧，希望能幫助你順利運用這項寶貴的資源。
一、SSIS001 簡介與應用場景
在深入安裝之前，先了解 SSIS001 的基本概念與應用場景是必要的。SSIS001 收集並整理了臺灣公路系統的速限資訊，並以 JSON 格式提供給使用者。這些資訊包含：
- 道路名稱： 例如「國道一號」、「台64線」等。
- 路段起訖點： 定義速限資訊適用的路段範圍。
- 速限值： 該路段的最高速限，單位為公里/小時。
- 速限類型： 例如「一般」、「施工」、「管制」等。
- 更新時間： 資訊更新的 timestamps。
SSIS001 的應用場景非常廣泛，包括：
- 導航應用程式： 整合 SSIS001，可提供更準確的導航資訊，並提醒駕駛人注意速限變化。
- 交通數據分析： 利用 SSIS001 數據，進行交通流量分析、道路安全研究等。
- 車機整合： 將 SSIS001 數據整合到車機系統中，提高駕駛安全性。
- 智慧交通系統： 作為智慧交通系統的數據來源之一，提供更完善的交通管理方案。
- 個人專案： 想要開發與臺灣交通相關的應用程式，SSIS001 是一個很好的起點。
二、SSIS001 安裝步驟 (詳解)
SSIS001 主要是透過 Python 環境運行，因此需要先安裝 Python 和相關套件。以下是詳細的安裝步驟：
1. 安裝 Python：
- 前往 Python 官方網站下載最新版本的 Python 安裝程式： https://www.python.org/downloads/
- 執行安裝程式，務必勾選「Add Python to PATH」選項，以便在命令提示字元中直接使用 Python 命令。
-
安裝完成後，打開命令提示字元，輸入
python --version或python3 --version，確認 Python 已成功安裝。
2. 安裝 Git：
SSIS001 的原始碼托管在 GitHub 上，因此需要安裝 Git 來下載原始碼。
- 前往 Git 官方網站下載最新版本的 Git 安裝程式： https://git-scm.com/downloads
- 執行安裝程式，採用預設選項即可。
-
安裝完成後，打開命令提示字元，輸入
git --version，確認 Git 已成功安裝。
3. 下載 SSIS001 原始碼：
打開命令提示字元，使用 Git 命令將 SSIS001 原始碼下載到你的電腦上。
bash
git clone https://github.com/daichi-xyz/ssis001.git
這會將 SSIS001 的原始碼下載到一個名為
ssis001
的資料夾中。
4. 安裝 Python 套件：
進入
ssis001
資料夾，使用 pip 安裝所需的 Python 套件。
bash
cd ssis001
pip install -r requirements.txt
requirements.txt
檔案列出了 SSIS001 運行所需要的所有 Python 套件，pip 會自動下載並安裝它們。
5. 設定環境變數 (重要!)
SSIS001 需要設定
GOOGLE_APPLICATION_CREDENTIALS
環境變數，指向你的 Google Cloud Platform 服務帳戶金鑰檔案。
-
申請 Google Cloud Platform 服務帳戶：
前往 Google Cloud Platform 控制台，建立一個新的專案，並建立一個具有適當權限 (例如
Storage Object Viewer) 的服務帳戶。 - 下載服務帳戶金鑰： 下載服務帳戶的金鑰檔案 (JSON 格式)。
-
設定環境變數： 在命令提示字元中設定
GOOGLE_APPLICATION_CREDENTIALS環境變數。-
Windows:
bash set GOOGLE_APPLICATION_CREDENTIALS="你的金鑰檔案路徑" -
macOS / Linux:
bash export GOOGLE_APPLICATION_CREDENTIALS="你的金鑰檔案路徑"
-
Windows:
請將
"你的金鑰檔案路徑"
替換為你的服務帳戶金鑰檔案的實際路徑。 建議將此設定添加到你的系統環境變數中，以便每次啟動時自動設定。
三、SSIS001 運行與測試
安裝完成後，就可以開始運行 SSIS001 了。
-
運行數據更新程式：
bash python update_data.py這個指令會從交通部公路總局網站下載最新的速限資訊，並儲存到本地檔案中。
-
運行 API 伺服器：
bash python app.py這個指令會啟動 API 伺服器，預設監聽在
127.0.0.1:5000。 -
測試 API：
在瀏覽器中輸入
http://127.0.0.1:5000/api/v1/speed_limits，或使用curl命令：bash curl http://127.0.0.1:5000/api/v1/speed_limits如果一切正常，你應該會看到 JSON 格式的速限資訊。
四、常見問題與解決方案
- Python 找不到指令： 確認 Python 已成功安裝，並已將 Python 加入到 PATH 環境變數中。
- pip 找不到指令： 確認 Python 已成功安裝，且 pip 已包含在 Python 安裝目錄中。
- 無法下載數據： 檢查網路連線是否正常，並確認交通部公路總局網站可以正常訪問。 另外，也請確認你的防火牆沒有阻擋 SSIS001 的網路連接。
- API 伺服器無法啟動： 檢查是否有端口衝突，嘗試更換端口。 確認已經安裝所有必要的 Python 套件。
-
Google Cloud Platform 驗證錯誤：
確認
GOOGLE_APPLICATION_CREDENTIALS環境變數設定正確，且服務帳戶的金鑰檔案有效。 確認服務帳戶具有讀取 Google Cloud Storage 儲存桶的權限。
五、進階使用技巧
- 定期更新數據： 可以使用 crontab (Linux/macOS) 或工作排程 (Windows) 定期自動更新數據。
- 資料庫儲存： 將數據儲存到資料庫中，方便查詢和分析。
- API 擴展： 可以根據需求擴展 API，例如提供路段查詢、特定道路查詢等功能。
- 錯誤處理： 在程式碼中加入錯誤處理機制，提高程式的穩定性。
- 部署到雲端： 將 SSIS001 部署到雲端伺服器，提供更穩定的服務。
六、結論
SSIS001 是一個非常有用的開源專案，可以幫助你輕鬆取得臺灣公路速限資訊。 透過本文的詳細說明，相信你已經掌握了 SSIS001 的安裝、設定和使用方法。 祝你使用愉快，開發出更多創新的應用程式！
