API 文件

將 ABRP 強大的電動車路線與規劃能力整合到您的平台。我們完整的 API 套件可無縫整合車輛感知路由、遙測資料與深層連結等功能。

API 與整合

使用我們的 API 套件，將電動車路由、遙測與深層連結整合至您的平台。

Planning API

v2（建議）

v1（舊版）

具車輛感知能力的路由與完整電動車規劃功能

Planning API 提供隨 ABRP 持續演進的進階路線規劃，包含能耗建模、充電最佳化、即時車流整合與納入天氣的路線規劃。

API 採 REST 架構並以 JSON 輸出，同時支援舊版（v1）與現代化（v2）端點。設定成本與每方案計價會依整合需求與用量而有所不同。

v2 Planning 文件 v1 Planning 文件（舊版）

Telemetry API

用於即時追蹤與車輛建模的即時車輛數據

Telemetry API 可傳輸即時車輛數據，用於即時旅程追蹤、能耗分析與持續改進車型模型，協助我們精進能耗預測與路由準確度。

我們提供免費 API 金鑰供整合使用。送出數據需要使用者權杖，可透過 OAuth2 流程（建議）取得，或在測試與開發階段手動取得權杖。

Telemetry 文件管理您的 Telemetry API 金鑰

OAuth2 API

安全的使用者驗證與授權

OAuth2 提供安全且便利的方式，讓使用者在 Iternio 完成身分驗證。設定 OAuth2 需要 API 金鑰，並提供重新導向網址與應用程式名稱。

授權流程

第一次呼叫會回傳 HTML 頁面，使用者可登入並授權您的應用程式。若在使用者預設瀏覽器中開啟，登入狀態可能已快取以簡化流程。

https://abetterrouteplanner.com/oauth/auth?client_id=<your_client_id>&scope=<requested_scope>&response_type=code&redirect_uri=<your_redirect_uri>

允許的範圍：

get_telemetry: 讀取使用者最新遙測資料
set_telemetry: 將新遙測更新推送到車輛
get_plan: 以精簡格式取得最新計畫（詳情請聯絡我們）
vehicle_history: 讀取歷史行駛與充電紀錄（詳情請聯絡我們）

在您的重新導向 URI 收到的回應：

https://your_redirect_uri?state=<state_provided>&auth_code=<returned_auth_code>

取得權杖

取得授權碼後，即可取得可儲存並依需求重複使用的權杖。

https://api.iternio.com/1/oauth/token?client_id=<your_client_id>&client_secret=<your_api_key>&code=<auth_code>

回應格式：

{
  "access_token": "<the created token>",
  "token_type": "bearer",
  "state": "<your supplied state>"
}

使用者資訊

取得權杖後，請使用「me」端點讀取使用者資訊：

https://api.iternio.com/1/oauth/me?access_token=<the user token>&api_key=<your api key>

回應格式：

{
  "user_id": <the numeric ID of the user>,
  "full_name": "<Full name of the user>",
  "email": "<Email of user>",
  "vehicle_id": <The numeric ID of the vehicle, if part of the scope>,
  "vehicle_name": "<The vehicle name>",
  "vehicle_typecode": "<The vehicle typecode>"
}

Deep Links

以網址整合預先設定的路線規劃

建立自訂網址，以預設路線、車款與規劃參數啟動 ABRP。適合嵌入應用程式、網站或導航系統，而無需整合 API。

深層連結支援多種網址參數，包含起訖點座標、中途點、車型、電量與使用者偏好。基礎網址： https://abetterrouteplanner.com

Deep Links 文件