API ドキュメント

ABRP の強力な EV ルーティングと計画機能をプラットフォームへ。車両を考慮したルーティング、テレメトリ、ディープリンクまで、包括的な API でスムーズに統合できます。

API と統合

EV ルーティング、テレメトリ、ディープリンクをプラットフォームに取り込む API 群にアクセスできます。

Planning API

v2（推奨）

v1（レガシー）

車両を考慮したルーティングと、充実した EV 計画機能

Planning API は、ABRP の継続的な改善とともに進化する高度なルート計画を提供します。消費電力モデル、充電の最適化、リアルタイム交通、天候を踏まえた計画などに対応します。

REST アーキテクチャで JSON 出力。レガシー（v1）とモダン（v2）の両エンドポイントに対応。導入コストと従量料金は、統合の要件と利用量により異なります。

v2 Planning ドキュメント v1 Planning ドキュメント（レガシー）

Telemetry API

ライブ追跡と車両モデリング向けのリアルタイム車両データ

Telemetry API で車両データをリアルタイム送信し、走行の追跡、消費分析、車モデルの継続改善が可能になります。エネルギー予測とルーティング精度の向上に役立ちます。

統合向けの無料 API キーを提供。データ送信にはユーザートークンが必要で、OAuth2 フロー（推奨）またはテスト用の手動取得が利用できます。

Telemetry ドキュメントテレメトリ API キーを管理

OAuth2 API

安全なユーザー認証と認可

OAuth2 は Iternio のユーザーを特定・認証する安全で便利な手段です。設定には API キーに加え、リダイレクト URL とアプリケーション名が必要です。

認可フロー

最初の呼び出しでは、ユーザーがログインしてアプリを承認する 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>"
}

ディープリンク

事前設定済みルート計画を URL で連携

出発地・目的地や車両、計画パラメータを埋め込んだカスタム URL で ABRP を起動できます。API を使わずにアプリや Web、ナビに組み込むのに最適です。

ディープリンクでは、起点・終点座標、経由地、車種、残量、ユーザー設定など多様なクエリに対応。ベース URL: https://abetterrouteplanner.com

ディープリンクのドキュメント