ForHosting KIT · 開発者向けツール

EV長距離ドライブの充電回数計算ツール

公表されている最大航続距離を使い切る前提にせず、電気自動車の長距離移動を計画できます。総走行距離、満充電時の航続距離、残しておきたい安全余裕率を入力してください。計算ツールは余裕分を差し引いて実用航続距離を求め、必要な途中充電の最小回数を算出し、その範囲内に収まる均等な走行区間へルートを分けます。旅行距離と航続距離で同じ単位を使えば、マイルでもキロメートルでも計算できます。

● Beta無料・ブラウザ内で実行

無料で実行 API仕様を見る

ご利用方法ウェブAPIメールTelegramアプリ近日

公称航続距離を現実的な計画上限に変換します

満充電時の航続距離は有用な目安ですが、各区間の終点で電池残量がゼロになる計画は安全とはいえません。天候、速度、標高差、暖房や冷房、渋滞、タイヤの状態、迂回などにより、実際の電力消費は変動します。安全余裕率を設定すると、公称値から余裕分を除いた、より慎重な実用航続距離を利用できます。たとえば20パーセントの余裕を設ける場合、入力した航続距離の80パーセントで計画します。この計算ツールは単位を固定していません。両方をマイルで入力すれば結果もマイルになり、両方をキロメートルで入力すれば結果もキロメートルになります。単位変換は行わないため、必ず統一してください。余裕率を大きくすると実用航続距離が短くなり、充電回数が増える場合があります。小さくすると長く走れますが、予想外の変化に対応できる幅は狭くなります。この結果は電池性能の保証ではなく、根拠が明確な計画の出発点です。ルート、走行条件、到着時に残したい充電量に応じて余裕率を選び、実在する充電設備と照合してください。

充電回数と推奨間隔の意味を確認します

最初に、満充電時の航続距離へ安全余裕率を差し引いた割合を掛け、実用航続距離を求めます。次に総走行距離をその値で割り、切り上げて必要最小限の走行区間数を算出します。途中の充電回数は区間数から1を引いた数です。満充電で出発し、目的地へ着いた後の充電は途中の停止として数えないためです。そのため、実用航続距離の1区間だけで到着できる旅行では、途中充電は0回になります。必要な区間数が決まると、総距離を均等に分けます。この値が充電地点または出発地と目的地の間に推奨される距離です。毎回限界まで走るより、均等な間隔を検索目標にしたほうが充電所を選びやすく、最後の区間だけが不必要に短くなることも避けられます。表示距離は安定して同じ結果になるよう、小数点以下6桁に丸めます。入力値が実際の条件を適切に表していれば、推奨される各区間は実用航続距離を超えず、停止回数も慎重な値になります。

実際の充電設備に合わせて結果を調整します

推奨距離を目安として使い、ルート上に実在する充電所へ当てはめてください。たとえば3回の充電と4つの均等区間が示された場合、累積した各区間の境界付近で適切な設備を探します。距離が完全に一致する必要はありません。コネクター規格、充電出力、利用可能時間、支払い方法を確認し、可能であれば直近の稼働情報も調べてください。寒冷時、向かい風、山岳路、代替設備が少ない地域では、実用航続距離を超えて走るより、早めの充電所を選ぶほうが安全です。このツールは充電時間、充電曲線、標高、設備のリアルタイム状態、けん引、積載量、走行中の効率変化を計算しません。また、満充電で出発することを前提としています。100パーセント未満で出発する場合は、最初の区間だけを短くするか、より控えめな航続距離を入力してください。条件が変わったときは再計算をおすすめします。旅程作成を自動化する場合は、同じ決定論的な計算を1回$0.002のAPIで利用でき、同じ数値入力から常に同じ結果を得られます。

活用例

長距離の休暇旅行を準備します

数日間のルートで宿泊先、食事休憩、充電場所を決める前に、必要最小限の充電回数を見積もれます。

2台の電気自動車を比較します

同じ旅行距離と余裕率を各車の航続距離に適用し、想定される充電回数と区間距離を比較できます。

冬季向けの慎重な旅程を作ります

不確かな走行条件に備えて安全余裕率を増やし、追加の充電が必要になるか確認できます。

よくある質問

マイルとキロメートルのどちらも使えますか？

はい。総走行距離と航続距離に同じ単位を使ってください。結果の距離もその単位で表示されます。

航続距離から安全余裕分を引くのはなぜですか？

公称航続距離の一部を不確実な状況に備えて残し、電池切れで到着する計画を避けるためです。

目的地での充電も回数に含まれますか？

いいえ。出発してから目的地へ到着するまでに必要な途中充電だけを数えます。

この計算ツールは充電所も検索しますか？

いいえ。推奨間隔と最小回数を示すため、実際のルートにある適切な設備はお客様が選択してください。

航続距離がゼロまたは負の場合はどうなりますか？

満充電時の航続距離には正の値が必要なため、入力エラーが返されます。

APIによる計算の料金はいくらですか？

APIは1回$0.002です。ブラウザー版では同じ決定論的な処理を端末内で実行できます。

開発者向け — APIアクセス

このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。

エンドポイント

POSThttps://api.kit.forhosting.com/final3/ev-road-trip-range-planner

Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。

お使いのスタックから呼び出す

curl -X POST https://api.kit.forhosting.com/final3/ev-road-trip-range-planner \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"trip_distance":620,"range_per_full_charge":300,"safety_buffer_percentage":20}'

const res = await fetch("https://api.kit.forhosting.com/final3/ev-road-trip-range-planner", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "trip_distance": 620,
    "range_per_full_charge": 300,
    "safety_buffer_percentage": 20
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/final3/ev-road-trip-range-planner",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "trip_distance": 620,
    "range_per_full_charge": 300,
    "safety_buffer_percentage": 20
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/final3/ev-road-trip-range-planner", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"trip_distance":620,"range_per_full_charge":300,"safety_buffer_percentage":20}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"trip_distance":620,"range_per_full_charge":300,"safety_buffer_percentage":20}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/final3/ev-road-trip-range-planner", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "trip_distance": 620,
  "range_per_full_charge": 300,
  "safety_buffer_percentage": 20
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "final3.ev_road_trip_range_planner",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。

料金

1リクエストあたり$0.002

単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。

エラー

HTTP	コード	意味
`401`	`unauthorized`	APIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。
`402`	`insufficient_balance`	残高が不足しています。チャージ後に再度お試しください。
`404`	`unknown_type`	指定されたタスクタイプは存在しません。タイプ名を確認してください。
`429`	`rate_limited`	リクエストが多すぎます。しばらく待ってから再度お試しください。

KITの完全なドキュメントを見る →