ルート検索（EV）
/route_ev_car [GET]
基本情報
概要
電気自動車（EV）を移動手段として、２地点間のルートを検索します。経由地の指定も可能です。
指定した電費に基づいた移動区間ごとの消費電費を出力します。
URL
https://{HOST}/{CID}/v1/route_ev_car
※APIマーケットの場合はURL体系が異なります
出力形式
- JSON
- GeoJSON
対応言語
- ja, en, ko, zh-CN, zh-TW, th
出力順
- 出力順はorderパラメータで指定した項目で並び替えを行った順
パラメータ
| パラメータ名 | 必須 | 概要 | 型名 | デフォルト値 | 上下限/選択値 | 備考 |
|---|---|---|---|---|---|---|
| start | ✔ | 出発地点 | ・地点のJSON表現 ・文字列（ノードID） ・カンマ区切りの数値（緯度,経度） |
緯度経度の指定例：35.689457,139.691935（東京都庁） | ||
| goal | ✔ | 到着地点 | ・地点のJSON表現 ・文字列（ノードID） ・カンマ区切りの数値（緯度,経度） |
|||
| power_cost | ✔ | 電費 | 各モードのJSON表現 数値(単位：Wh/km) |
詳細はこちらをご覧ください | ||
| altitude | 標高考慮 | 真偽値 | ※標高データオプション申し込み時のみ利用可能 (APIマーケットでは利用不可) |
|||
| start_time | 出発時刻 | 文字列（日付時刻） YYYY-MM-DDThh:mm:ss |
時刻の指定例 2023-02-01T08:00:00 詳細はこちらをご覧ください |
|||
| goal_time | 到着時刻 | 文字列（日付時刻） YYYY-MM-DDThh:mm:ss |
時刻の指定例 2023-02-01T08:00:00 詳細はこちらをご覧ください |
|||
| via | 経由地 | 地点のJSON表現（配列） | 経由地指定の上限数はvia_typeによって異なります ・指定順：50地点 ・最適順：10地点 ・経由地間最適順：10地点 |
|||
| via_type | 経由地巡回モード | 文字列 | specified | specified: 指定順 optimal: 最適順 via_optimal: 経由地間最適順 |
指定した経由地をどのように巡回するかを指定します via_optimalの詳細はこちらをご覧ください |
|
| condition | 経路検索条件 | 文字列 | recommend | recommend：推奨 toll_time：有料道路優先、時間優先 toll_distance：有料道路優先、距離優先 free_time：無料道路優先、時間優先 free_distance：無料道路優先、距離優先 free_only：無料道路利用 |
||
| order | 出力順 | 文字列 | time | total_distance: 総移動距離 time: 所要時間 |
||
| use_road | 利用したい道路ID | 文字列 | ピリオド区切りで複数指定可能です 詳細はこちらをご覧ください |
|||
| unuse_road | 利用したくない道路ID | 文字列 | ピリオド区切りで複数指定可能です 詳細はこちらをご覧ください |
|||
| use_traffic | 渋滞情報の考慮 | 文字列 | vics：VICS提供の道路交通情報 probe：プローブから生成された道路交通情報 |
ピリオド区切りで複数指定が可能です パラメータ「start_time」または「goal_time」を指定時のみ有効です 検索対象が過去日時の場合は考慮されません ※VICS / プローブのご利用は、オプション機能のため、別途契約が必要となります (APIマーケットでは利用不可) ※vicsを指定した場合は、リクエストヘッダー「x-ntj-uid」、または、パラメータ「uid」を必ず設定してください |
||
| uid | (✔) | VICS使用時のユーザー識別子 | 文字列 | 1文字以上50文字以内 | ※VICS / プローブのご利用は、オプション機能のため、別途契約が必要となります (APIマーケットでは利用不可) ※パラメータ「use_traffic」で「vics」を指定した場合は、リクエストヘッダー「x-ntj-uid」、または、パラメータ「uid」を必ず設定してください |
|
| options | 追加出力情報 | 文字列 | turn_by_turn：ターンバイターン情報 | 交差点等、進行情報を案内するための地点情報を取得します | ||
| smart_ic | スマートIC考慮 | 文字列 | unuse | unuse : スマートICを考慮しない use : スマートICを考慮する |
||
| ferry | フェリー優先検索 | 文字列 | use | unuse : フェリーを使わない use : フェリーを使う more_use : フェリーを優先して使う |
||
| wide | 道幅の考慮 | 文字列 | unuse | unuse：道幅を考慮しない use：道幅を考慮する more_use : 積極的に道幅を考慮する |
||
| etc | ETC料金計算 | 文字列 | unuse | use：時刻を考慮したETC料金計算を行う unuse : 時刻を考慮したETC料金計算を行わない |
use指定時にfareに出力される料金はETC料金のみとなります | |
| avoid_etc_only | ETC専用料金所の回避 | 真偽値 | false | true : ETC専用料金所を回避する false : ETC専用料金所を回避しない |
対応しているICの詳細はこちらをご覧ください |
|
| shape | 形状出力 | 真偽値 | false | true：形状を出力する false：形状を出力しない |
trueを指定時にはshapes(ルート形状)が出力されます | |
| datum | 緯度経度の測地系 | 文字列 | wgs84 | wgs84：世界測地系 tokyo：旧日本測地系 |
||
| coord_unit | 出力データに含まれる緯度経度の単位 | 文字列 | degree | degree：度表記の10進法 millisec：ミリ秒表記 |
||
| lang | 言語 | 文字列 | ja: 日本語 en: 英語 ko: 韓国語 zh-CN: 中国語(簡体字) zh-TW: 中国語(繁体字) th: タイ語 |
出力する言語を指定します ※多言語オプション申込時のみ利用可能 (APIマーケットでは利用不可) |
1対多、多対1ルート検索について
複数の経路を一度に求めることのできるルート検索です（複数地点を登録する際の上限数は10地点です）。
1対多ルート検索：1つの出発地点に対し、複数の到着地点を指定します。
多対1ルート検索：複数の出発地点に対し、1つの到着地点を指定します。
これらのルート検索を行う場合、経由地を指定することはできません。
緯度経度指定によるパラメータ指定例（1対多ルート検索）は以下の通りです。
start=35.439582,139.380180&goal=[{"lat":35.706822,"lon":139.813956},{"lat":35.655392,"lon":139.748642}]
※出発地点、到着地点の両方で複数の地点を登録することはできません（多対多ルート検索には対応していません）。
※経路探索に失敗したルートはレスポンスに含まれません。
複数地点の中に「ic」と「node」を含めることはできません。
※演算負荷の高い検索を行うため、距離が長い検索を行う場合などリクエスト内容によってはエラーが発生することがあります。
また、時間当たりのリクエスト数制限についても、1対1のルート検索や他のAPIとは異なります。詳しくは営業担当までお問い合わせください。
ルート検索時の日付（時刻）指定について
出発時刻(start_time)と到着時刻(goal_time)を指定する場合は、どちらか片方を指定してください(同時指定はできません)。
・start_time（日付時刻指定）：出発地からの出発時刻の指定
・goal_time（日付時刻指定）：目的地への到着時刻の指定
両方未指定の場合は、検索実行日時が出発時刻となります。
経路検索条件の無料道路利用の注意点について
無料道路利用は無料道路優先より高い優先度で検索する経路検索条件です。
パラメータの組み合わせによって、一部経路結果に有料道路が含まれる場合がありますのでご了承ください。
利用したい道路ID(use_road)について
利用したい道路の道路IDを指定することで、その道路を利用するルートを優先して検索します。
出発地・目的地の位置関係や道路データ収録状況の影響により、指定した道路が考慮されない場合があります。
利用したくない道路ID(unuse_road)と同一の道路IDを指定した場合はエラーとなります。
利用したくない道路ID(unuse_road)について
利用したくない道路の道路IDを指定することで、その道路を利用しないルートを優先して検索します。
指定した道路が考慮されない場合があります(例えば指定した道路が出発地と重なった場合)。
利用したい道路ID(use_road)と同一の道路IDを指定した場合はエラーとなります。
対応しているICについて(avoid_etc_only)
首都高(ICは入口のみETC専用化)
霞ヶ関(内外)、代官町(内)、空港西(上)、新宿(上)、初台(下)、幡ヶ谷(上)、一ツ橋(下)、護国寺(上)、中環大井南(外)、富ヶ谷(外)、初台南(内)、滝野川(内)、高松(外)、王子北(外)、四つ木(内外)、清新町(内)、さいたま見沼(上)、浦和南(上)、浜町(上下)、加平(南)(上下)、加平(北)(上下)、晴海(下)、加賀(上)、安行(上)、新木場(東西)、大井(東)、磯子(東)、木場(上)、横浜駅東口(下)、新山下(上下)、馬場
東日本高速道路(ICは入口のみETC専用化)
戸田西(内)、戸田東(外)
中日本高速道路
稲城(入口)、八王子西(出入口)
地点の JSON 表現
| プロパティ名 | 必須 | 概要 | 型名 | デフォルト値 | 備考 |
|---|---|---|---|---|---|
| lat | (✔) | 緯度 | 数値 | ||
| lon | (✔) | 経度 | 数値 | ||
| node | (✔) | 駅/連絡バス停ID | 文字列 | 経由地の場合は駅/連絡バス停IDは指定できません 緯度経度で指定してください |
|
| ic | (✔) | IC(インターチェンジ)のID | 文字列 | 経由地の場合はパラメータ「ic-passing-type」と合わせて指定してください | |
| ic-passing-type | (✔) | IC(インターチェンジ)の通過区分 | 文字列 | entrance：入口 exit：出口 経由地でパラメータ「ic」を指定する場合のみ使用可能です |
|
| name | 地点名称 | 文字列 | |||
| road-type | 地点の道路種別 | 文字列 | free | free：無料道路 toll：有料道路 any：有料無料全ての道路が対象 |
|
| angle | 方位 | 数値 | 0～360度 出発地を指定する場合のみ使用可能です |
||
| park-side | 横付け | 数値 | always_along：常に同一車線側に横付け along：狭い道路以外は同一車線側に横付け |
||
| stay-time | 経由地の滞在時間(単位：分) | 数値 | 最小値：0 最大値：300 経由地を指定する場合のみ使用可能です |
||
| arrival-times | 経由地への到着希望時間帯 | JSON表現（配列） | 経由地ごとに到着希望時間帯を設定できます 使用条件はこちらをご覧ください JSON表現は別途記載します 経由地を指定する場合のみ使用可能です |
出発地点と到着地点のJSON表現における必須項目の指定方法について
lat/lon、node、icの内いずれか一つの指定が必須となります(複数指定はエラー)。
latを指定した場合は、lonも必ず指定してください。
lonを指定した場合は、latも必ず指定してください。
経由地点のJSON表現における必須項目の指定方法について
lat/lon、icの内いずれか一つの指定が必須となります(複数指定はエラー)。
latを指定した場合は、lonも必ず指定してください。
lonを指定した場合は、latも必ず指定してください。
icを指定した場合は、ic-passing-typeも必ず指定してください。
経由地の指定方法について
経由地の数だけ地点のJSON表現を配列にして記述します。経由地が1点の場合でも配列表現が必要です。
経由地が1点の場合の記述例は以下の通りです。
via=[{"lat":35.706822,"lon":139.813956}]
最適順ルート、経由地間最適順ルートを求める場合、経由地は2地点以上登録する必要があります。
経由地指定の上限数は、指定順ルートの場合は50地点、最適順ルート、経由地間最適順ルートの場合は10地点です。出発地点、到着地点は含みません。
上限数を超える経由地を指定するとエラーとなります。
※オプション契約により、最適順ルート、経由地間最適順ルートでも最大50地点の経由地指定が可能です。
経由地にIC(インターチェンジ)を指定する場合の指定方法について
パラメータ「ic」に指定するIDは乗降IC検索APIにて取得することができます。
ICは経由地の数に含まれます。
ICを経由地にした場合の記述例は以下の通りです。
【横浜青葉IC入口と横浜町田IC出口を経由する場合】
via=[{"ic":"23040","ic-passing-type":"entrance","name":"横浜青葉IC入口"},{"ic":"23050","ic-passing-type":"exit","name":"横浜町田IC出口"}]
※経由地にICを指定する際、指定可能なvia_typeはspecified(指定順)のみとなります。
※optimal(最適順)、via_optimal(経由地間最適順)が指定された場合はエラーを返します。
経由地間最適順について
出発地から最後に到達する経由地までの所要時間を考慮した巡回モードとなります。
optimal(最適順)の場合とは異なり、最後に到達する経由地から目的地までの所要時間は考慮しません。
arrival-timesの使用条件について
arrival-timesを使用する際は以下の条件が必須となります。
【arrival-timesについて】
・指定できる到着希望時間帯（JSON表現）は2つ以下
※1つしか指定しない場合も配列表現で指定してください。
【他パラメータについて】
・経由地巡回モード（via-type）にoptimalを指定する
・経由地（via）を2つ以上指定する
また、start_time（もしくはgoal_time）の有無により、挙動が変わります。
・start_time（goal_time）を指定した場合 →start_time（goal_time）が固定された状態で、arrival-timesを考慮したルート検索を行います。
・start_time（goal_time）を指定しなかった場合 →指定されたarrival-timesから推奨出発時刻を算出し、それを用いてルート検索を行います。
power_costのJSON表現
| プロパティ名 | 必須 | 概要 | 型名 | デフォルト値 | 備考 |
|---|---|---|---|---|---|
| city | (✔) | 市街地モードの電費(単位：Wh/km) | 数値 | 1〜999の整数を指定してください | |
| suburban | (✔) | 郊外モードの電費(単位：Wh/km) | 数値 | 1〜999の整数を指定してください | |
| highway | (✔) | 高速道路モードの電費(単位：Wh/km) | 数値 | 1〜999の整数を指定してください | |
| total | (✔) | 市街地/郊外/高速道路の各走行モードを平均的な使用時間配分で構成した国際的な走行モード(以下、平均モードと記載)の電費(単位：Wh/km) | 数値 | 1〜999の整数を指定してください |
power_costの指定方法について
totalを指定するか、あるいはcity、suburban、highwaの3項目全てを指定してください。
指定値が不足した場合、エラーとなります。
ただし、totalを指定しており、かつcity、suburban、highwayのいずれかの指定が不足している場合はtotalを使用します。
total、city、suburban、highway全てを指定した場合は、より詳細な設定であるcity、suburban、highwayを使用します。
【平均モード：155Wh/km を指定する場合】
power_cost={"total":155}
【市街地モード：133Wh/km、 郊外モード：145Wh/km、 高速道路モード：171Wh/km を指定する場合】
power_cost={"city":133,"suburban":140,"highway":168}
arrival-times の JSON 表現
| プロパティ名 | 必須 | 概要 | 型名 | デフォルト値 | 備考 |
|---|---|---|---|---|---|
| from | ✔︎ | 到着希望時間帯の開始時刻 | 文字列（日付時刻）YYYY-MM-DDThh:mm:ss | 時刻の指定例 2023-02-01T08:00:00 | |
| to | ✔︎ | 到着希望時間帯の終了時刻 | 文字列（日付時刻）YYYY-MM-DDThh:mm:ss | 時刻の指定例 2023-02-01T08:00:00 |
arrival-timesを使用したルート検索ではarrival-timesで指定した時間帯と実際の到着時刻を比べて、最も差異の少ないルートを返却しています。
必ずしも全ての経由地が希望到着時間帯内に到着できるわけではありません。
arrival-timesのJSON表現例
・到着希望時間帯の開始時刻：2023-02-01T08:00:00, 到着希望時間帯の終了時刻：2023-02-01T08:15:00
"arrival-times":[
{
"from": "2023-02-01T08:00:00",
"to": "2023-02-01T08:15:00"
},
{
"from": "2023-02-01T16:00:00",
"to": "2023-02-01T16:15:00"
}
]
パラメータ構成例
・出発地：東京都庁、目的地：東京ディズニーランド、検索条件：有料道路利用、時間優先、出発時刻：2023年2月1日8時、電費：市街地モード：133Wh/km、 郊外モード：145Wh/km、 高速道路モード：171Wh/km
/route_ev_car?start={"lat":35.689572,"lon":139.692125,"name":"東京都庁"}&goal={"lat":35.632896,"lon":139.880394,"name":"東京ディズニーランド"}&condition=toll_time&start_time=2023-02-01T08:00:00&options=turn_by_turn&power_cost={"city":133,"suburban":140,"highway":168}
・出発地：東京都庁、目的地：東京ディズニーランド、検索条件：有料道路利用、時間優先、出発時刻：2023年2月1日8時、電費：平均モード：155Wh/km、ターンバイターン情報を出力
/route_ev_car?start={"lat":35.689572,"lon":139.692125,"name":"東京都庁"}&goal={"lat":35.632896,"lon":139.880394,"name":"東京ディズニーランド"}&condition=toll_time&start_time=2023-02-01T08:00:00&options=turn_by_turn&power_cost={"total":155}
JSON 表現は URL エンコードをした上でリクエストしてください
レスポンス
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| ルート情報 | items | Routeオブジェクト | 〇 | ルートに関する情報のまとまり |
| 単位情報 | unit | Unitオブジェクト | 出力される単位の情報 |
Routeオブジェクト
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| 経路の概要 | summary | RouteSummaryオブジェクト | 経路の概要に関する情報のまとまり | |
| 地点間の移動方法 | sections | RouteSectionItemオブジェクト | 〇 | 地点間の移動に関する情報のまとまり |
| 料金情報 | fares | FareItemオブジェクト | 〇 | 料金に関する情報のまとまり 有料道路利用時のみ出力 |
| ルート形状 | shapes | FeatureCollectionオブジェクト | ルート形状に関する情報のまとまり shape=true指定時のみ出力 shapesは/shape_ev_carのGeoJSON形式のレスポンスと同様 |
RouteSummaryオブジェクト
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| ルート結果内番号 | no | 文字列 | ルート結果内番号 | |
| 出発地点 | start | RouteSummaryItemオブジェクト 地点情報 |
出発地点に関する情報 | |
| 到着地点 | goal | RouteSummaryItemオブジェクト 地点情報 |
到着地点に関する情報 | |
| 移動情報 | move | RouteSummaryItemオブジェクト 移動情報 |
移動情報 | |
| 経由地 | via | RouteSummaryItemオブジェクト 地点情報 |
〇 | 経由地指定時のみ出力 |
RouteSummaryItemオブジェクト（type=point：地点情報）
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| タイプ | type | 文字列 | 常に'point'が入る | |
| 緯度経度 | coord | Coordinateオブジェクト | ||
| 地点名称 | name | 文字列 | 'start'または'goal'という文字列、または リクエストパラメータにて入力された地点情報のJSONにおけるnameの値 ノードIDを指定した場合は駅/空港/バス停名 langパラメータを指定した場合、指定言語の翻訳値が出力される 翻訳できない場合はリクエストパラメータにて入力された値または日本語の値が出力される |
|
| 出発時間 | from_time | 日付時刻 | 経由地出発時間 'summary:via'のときのみ出力 |
|
| 到着時間 | to_time | 日付時刻 | 経由地到着時刻 'summary:via'のときのみ出力 |
|
| 到着希望時間内外判定フラグ | in_time | 真偽値 | ・到着希望時間帯内に到着できているかどうかを判定するフラグ true: 時間内に到着 false: 時間外に到着 ・'summary:via'のときのみ出力 |
到着希望時間内外判定フラグについて
到着希望時間帯とは、arrival-timesパラメータで指定した時間帯を指します。
arrival-timesパラメータは地点のJSON表現内で指定することができます。
RouteSummaryItemオブジェクト（type=move：移動情報）
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| 料金 | fare | Fareオブジェクト | ||
| 有料道路走行距離(単位：m) | toll_road_distance | 数値 | ||
| タイプ | type | 文字列 | 常に'move'が入る | |
| 出発時刻 | from_time | 日付時刻 | ||
| 到着時刻 | to_time | 日付時刻 | ||
| 総移動時間(単位：分) | time | 数値 | ||
| 移動距離(単位：m) | distance | 数値 | ||
| 消費電力量(単位：Wh) | energy_consumption | 数値 | 小数点第一位までの値が出力される |
RouteSectionItemオブジェクト（type=point：地点間の地点情報）
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| タイプ | type | 文字列 | 常に'point'が入る | |
| 緯度経度 | coord | Coordinateオブジェクト | 出発地点または到着地点の緯度経度が出力される | |
| 地点名称 | name | 文字列 | 'start'または'goal'という文字列、または リクエストパラメータにて入力された地点情報のJSONにおけるnameの値 ターンバイターン情報つき指定時は交差点名が出力される langパラメータを指定した場合、指定言語の翻訳値が出力される 翻訳できない場合はリクエストパラメータにて入力された値または日本語の値が出力される |
|
| フェリー乗降 | ferry | 文字列 | on：フェリー乗り場 off：フェリー降り場 ターンバイターン情報つき指定時、かつフェリーを利用する場合に出力 |
|
| 前区間からの角度 | direction | 数値 | 右回りに16分割した角度 1の場合は22.5度 ターンバイターン情報つき指定時に出力 |
|
| 高速道路情報 | highway | 文字列 | on：IC乗り口 off：IC降り口 junction：ジャンクション connection：高速接続（用賀等） |
|
| 経由地フラグ | with_via | 真偽値 | 経由地かどうかのフラグ | |
| 経由地点の滞在時間 | stay_time | 数値 | 経由地の場合のみ出力 |
RouteSectionItemオブジェクト（type=move：地点間の移動情報）
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| タイプ | type | 文字列 | 常に'move'が入る | |
| 移動手段 | move | 文字列 | 常に'car'が入る | |
| 出発時間 | from_time | 日付時刻 | 一つ上のpointからの出発時刻 | |
| 到着時間 | to_time | 日付時刻 | 一つ下のpointへの到着時刻 | |
| 移動時間(単位：分) | time | 数値 | type=point間の移動時間 | |
| 移動距離(単位：m) | distance | 数値 | type=point間の移動距離 | |
| 道路名 | line_name | 文字列 | ターンバイターン情報つき指定時は道路名を出力 道路名がない場合は出力されない ターンバイターン情報つき未指定時は「"車"」固定 langパラメータ指定を指定した場合、指定言語の翻訳値が出力される 翻訳できない場合は日本語の値が出力される |
|
| フェリー利用状況 | use_ferry | 文字列 | partial: 一部区間でフェリーを利用している フェリー利用がある場合のみ出力 |
|
| 消費電力量(単位：Wh) | energy_consumption | 数値 | power_costで指定した電費に応じた消費電力量の値 小数点第一位までの値が出力される |
FareItemオブジェクト（type=point：地点の料金情報）
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| タイプ | type | 文字列 | 常に'point'が入る | |
| 緯度経度 | coord | Coordinateオブジェクト | ||
| 地点名称 | name | 文字列 | langパラメータ指定を指定した場合、指定言語の翻訳値が出力される 翻訳できない場合は日本語で出力される |
FareItemオブジェクト（type=move：地点間の料金情報）
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| 種別 | type | 文字列 | 常に'move'が入る | |
| 料金詳細情報 | detail | FareDetailオブジェクト | ||
| 出発時間 | from_time | 日付時刻 | 一つ上のpointからの出発時刻 | |
| 到着時間 | to_time | 日付時刻 | 一つ下のpointへの到着時刻 | |
| 移動時間(単位：分) | time | 数値 | type=point間の移動時間 | |
| 道路名 | line_name | 文字列 | 区間の道路名 langパラメータ指定を指定した場合、指定言語の翻訳値が出力される 翻訳できない場合は日本語の値が出力される |
FareDetailオブジェクト
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| 料金シーズン | fare_season | 文字列 | normal：通常期 busy：繁忙期 slack：閑散期 |
|
| 料金 | fare | Fareオブジェクト | 〇 |
Fareオブジェクト
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| 料金 | unit_{料金区分ID}_{車種ID} | 数値 | 〇 |
Coordinateオブジェクト
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| 地点の緯度 | lat | 数値 | ||
| 地点の経度 | lon | 数値 |
Unitオブジェクト
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| 緯度経度の測地系 | datum | 文字列 | ||
| 緯度経度の出力形式 | coord_unit | 文字列 | ||
| 距離の単位 | distance | 文字列 | ||
| 所要時間の単位 | time | 文字列 | ||
| 通貨の単位 | currency | 文字列 |
レスポンス例
・ルートの概要
{
"items": [
{
"summary": {
"no": "1",
"start": {
"type": "point",
"coord": {
"lat": 35.689457,
"lon": 139.691935
},
"name": "東京都庁"
},
"goal": {
"type": "point",
"coord": {
"lat": 35.862203,
"lon": 139.970888
},
"name": "柏"
},
"move": {
"fare": {
"unit_1024_1": 2010.0,
"unit_1025_1": 1050.0,
"unit_1024_2": 2470.0,
"unit_1025_2": 1280.0,
"unit_1024_3": 2900.0,
"unit_1025_3": 1480.0,
"unit_1024_4": 3850.0,
"unit_1025_4": 1940.0,
"unit_1024_5": 6210.0,
"unit_1025_5": 3080.0,
"unit_1024_100": 2010.0,
"unit_1025_100": 1050.0
},
"toll_road_distance": 40809,
"type": "move",
"from_time": "2019-10-01T08:00:00+09:00",
"to_time": "2019-10-01T09:05:39+09:00",
"time": 65,
"distance": 49169,
"energy_consumption": 7968.4
}
}
},
・・・
],
"unit": {
"datum": "wgs84",
"coord_unit": "degree",
"distance": "metre",
"time": "minute",
"currency": "JPY"
}
}
・ルート内の移動情報
"sections": [
{
"type": "point",
"coord": {
"lat": 35.689457,
"lon": 139.691935
},
"name": "東京都庁"
},
{
"type": "move",
"move": "car",
"from_time": "2019-10-01T08:00:00+09:00",
"to_time": "2019-10-01T08:00:37+09:00",
"time": 0,
"distance": 300,
"line_name": "都庁通り",
"energy_consumption": 40.0
},
{
"type": "point",
"coord": {
"lat": 35.692167,
"lon": 139.691689
},
"name": "都庁北",
"direction": 12
},
{
"type": "move",
"move": "car",
"from_time": "2019-10-01T08:00:37+09:00",
"to_time": "2019-10-01T08:03:49+09:00",
"time": 3,
"distance": 926,
"line_name": "北通り",
"energy_consumption": 123.3
},
{
・・・
},
{
"type": "point",
"coord": {
"lat": 35.862803,
"lon": 139.972091
},
"name": "交差点",
"direction": 12
},
{
"type": "move",
"move": "car",
"from_time": "2019-10-01T09:04:58+09:00",
"to_time": "2019-10-01T09:05:39+09:00",
"time": 0,
"distance": 100,
"energy_consumption": 13.3
},
{
"type": "point",
"coord": {
"lat": 35.862203,
"lon": 139.970888
},
"name": "柏"
}
]
・案内地点情報の概要（高速道路利用の場合）
{
"type": "point",
"coord": {
"lat": 35.691787,
"lon": 139.681759
},
"name": "中野長者橋出入口",
"direction": 2,
"highway": "on"
},
{
"type": "move",
"move": "car",
"from_time": "2019-10-01T08:05:24+09:00",
"to_time": "2019-10-01T08:13:07+09:00",
"time": 7,
"distance": 6881,
"line_name": "首都中央環状線",
"energy_consumption": 1156.0
}
・高速道路料金の概要
"fares": [
{
"type": "point",
"coord": {
"lat": 35.693907,
"lon": 139.682281
},
"name": "中野長者橋"
},
{
"detail": {
"fare_season": "normal",
"fare": {
"unit_1024_1": 1590.0,
"unit_1025_1": 950.0,
"unit_1096_1": 760.0,
"unit_1024_2": 1950.0,
"unit_1025_2": 1150.0,
"unit_1096_2": 920.0,
"unit_1024_3": 2310.0,
"unit_1025_3": 1340.0,
"unit_1096_3": 1070.0,
"unit_1024_4": 3110.0,
"unit_1025_4": 1780.0,
"unit_1096_4": 1420.0,
"unit_1024_5": 5080.0,
"unit_1025_5": 2860.0,
"unit_1096_5": 2290.0,
"unit_1024_100": 1590.0,
"unit_1025_100": 950.0,
"unit_1096_100": 760.0
}
},
"type": "move",
"move": "car",
"from_time": "2019-10-01T08:05:46+09:00",
"to_time": "2019-10-01T08:36:55+09:00",
"time": 31,
"line_name": "首都中央環状線"
},
{
"type": "point",
"coord": {
"lat": 35.832683,
"lon": 139.855988
},
"name": "三郷"
},
{
"detail": {
"fare_season": "normal",
"fare": {
"unit_1024_1": 420.0,
"unit_1025_1": 420.0,
"unit_1026_1": 420.0,
"unit_1039_1": 290.0,
"unit_1024_2": 520.0,
"unit_1025_2": 520.0,
"unit_1026_2": 520.0,
"unit_1039_2": 360.0,
"unit_1024_3": 590.0,
"unit_1025_3": 590.0,
"unit_1026_3": 590.0,
"unit_1039_3": 410.0,
"unit_1024_4": 740.0,
"unit_1025_4": 740.0,
"unit_1026_4": 740.0,
"unit_1039_4": 520.0,
"unit_1024_5": 1130.0,
"unit_1025_5": 1130.0,
"unit_1026_5": 1130.0,
"unit_1039_5": 790.0,
"unit_1024_100": 420.0,
"unit_1025_100": 420.0,
"unit_1026_100": 420.0,
"unit_1039_100": 290.0
}
},
"type": "move",
"move": "car",
"from_time": "2019-10-01T08:36:55+09:00",
"to_time": "2019-10-01T08:46:14+09:00",
"time": 9,
"line_name": "常磐自動車道"
},
{
"type": "point",
"coord": {
"lat": 35.907825,
"lon": 139.93741
},
"name": "柏"
}
]
レスポンス例（lang=en指定時）
・ルートの概要
{
"items": [
{
"summary": {
"no": "1",
"start": {
"type": "point",
"coord": {
"lat": 35.674673,
"lon": 139.757891
},
"name": "Hibiya Koen"
},
"goal": {
"type": "point",
"coord": {
"lat": 35.626297,
"lon": 139.633724
},
"name": "Yoga"
},
"move": {
"fare": {
"unit_1024_1": 1590.0,
"unit_1025_1": 410.0,
"unit_1024_2": 1950.0,
"unit_1025_2": 480.0,
"unit_1024_3": 2310.0,
"unit_1025_3": 540.0,
"unit_1024_4": 3110.0,
"unit_1025_4": 700.0,
"unit_1024_5": 5080.0,
"unit_1025_5": 1080.0,
"unit_1024_100": 1590.0,
"unit_1025_100": 410.0
},
"toll_road_distance": 12812,
"type": "move",
"from_time": "2019-10-01T08:00:00+09:00",
"to_time": "2019-10-01T08:23:18+09:00",
"time": 23,
"distance": 15805,
"energy_consumption": 2550.4
}
},
・・・
}
],
"unit": {
"datum": "wgs84",
"coord_unit": "degree",
"distance": "metre",
"time": "minute",
"currency": "JPY"
}
}
・ルート内の移動情報
"sections": [
{
"type": "point",
"coord": {
"lat": 35.674673,
"lon": 139.757891
},
"name": "Hibiya Koen"
},
{
"type": "move",
"move": "car",
"from_time": "2019-10-01T08:00:00+09:00",
"to_time": "2019-10-01T08:00:16+09:00",
"time": 0,
"distance": 116,
"line_name": "Hibiya-dori",
"energy_consumption": 15.4
},
{
"type": "point",
"coord": {
"lat": 35.67499,
"lon": 139.759426
},
"name": "Hibiya",
"direction": 12
},
{
"type": "move",
"move": "car",
"from_time": "2019-10-01T08:00:16+09:00",
"to_time": "2019-10-01T08:01:54+09:00",
"time": 1,
"distance": 568,
"line_name": "Harumi-dori",
"energy_consumption": 75.5
},
{
"type": "point",
"coord": {
"lat": 35.677462,
"lon": 139.75396
},
"name": "Intersection",
"direction": 15
},
{
"type": "move",
"move": "car",
"from_time": "2019-10-01T08:01:54+09:00",
"to_time": "2019-10-01T08:03:20+09:00",
"time": 1,
"distance": 595,
"line_name": "Sakurada-dori",
"energy_consumption": 79.1
},
{
・・・
},
{
"type": "point",
"coord": {
"lat": 35.621381,
"lon": 139.630996
},
"name": "Seta",
"direction": 11
},
{
"type": "move",
"move": "car",
"from_time": "2019-10-01T08:20:45+09:00",
"to_time": "2019-10-01T08:23:18+09:00",
"time": 2,
"distance": 600,
"line_name": "Prefectural road 427",
"energy_consumption": 79.9
},
{
"type": "point",
"coord": {
"lat": 35.626297,
"lon": 139.633724
},
"name": "Yoga"
}
]
・案内地点情報の概要（高速道路利用の場合）
{
"type": "point",
"coord": {
"lat": 35.673934,
"lon": 139.748006
},
"name": "Kasumigaseki Exit",
"direction": 12,
"highway": "on"
},
{
"type": "move",
"move": "car",
"from_time": "2019-10-01T08:04:14+09:00",
"to_time": "2019-10-01T08:05:28+09:00",
"time": 1,
"distance": 1027,
"line_name": "Inner Circular Route",
"energy_consumption": 172.4
},
{
"type": "point",
"coord": {
"lat": 35.667869,
"lon": 139.739848
},
"name": "Tanimachi JCT",
"direction": 4,
"highway": "junction"
}
・高速道路料金の概要
"fares": [
{
"type": "point",
"coord": {
"lat": 35.673323,
"lon": 139.74737
},
"name": "Kasumigaseki"
},
{
"detail": {
"fare_season": "normal",
"fare": {
"unit_1024_1": 1590.0,
"unit_1025_1": 510.0,
"unit_1096_1": 410.0,
"unit_1024_2": 1950.0,
"unit_1025_2": 600.0,
"unit_1096_2": 480.0,
"unit_1024_3": 2310.0,
"unit_1025_3": 680.0,
"unit_1096_3": 540.0,
"unit_1024_4": 3110.0,
"unit_1025_4": 880.0,
"unit_1096_4": 700.0,
"unit_1024_5": 5080.0,
"unit_1025_5": 1350.0,
"unit_1096_5": 1080.0,
"unit_1024_100": 1590.0,
"unit_1025_100": 510.0,
"unit_1096_100": 410.0
}
},
"type": "move",
"from_time": "2019-10-01T08:04:22+09:00",
"to_time": "2019-10-01T08:18:08+09:00",
"time": 13,
"line_name": "Inner Circular Route"
},
{
"type": "point",
"coord": {
"lat": 35.626418,
"lon": 139.630359
},
"name": "Yoga"
}
]