ルート検索（車）
/route_car [GET]
基本情報
概要
自動車を移動手段として、２地点間のルートを検索します。経由地の指定も可能です。
URL
https://{HOST}/{CID}/v1/route_car
※APIマーケットの場合はURL体系が異なります
出力形式
- JSON
- GeoJSON
対応言語
- ja, en, ko, zh-CN, zh-TW, th
出力順
- 出力順はorderパラメータで指定した項目で並び替えを行った順
パラメータ
| パラメータ名 | 必須 | 概要 | 型名 | デフォルト値 | 上下限/選択値 | 備考 |
|---|---|---|---|---|---|---|
| start | ✔ | 出発地点 | ・地点のJSON表現 ・文字列（ノードID） ・カンマ区切りの数値（緯度,経度） |
緯度経度の指定例：35.689457,139.691935（東京都庁） | ||
| goal | ✔ | 到着地点 | ・地点のJSON表現 ・文字列（ノードID） ・カンマ区切りの数値（緯度,経度） |
|||
| start_time | 出発時刻 | 文字列（日付時刻）YYYY-MM-DDThh:mm:ss |
時刻の指定例 2019-10-01T08:00:00 詳細はこちらをご覧ください |
|||
| goal_time | 到着時刻 | 文字列（日付時刻）YYYY-MM-DDThh:mm:ss |
時刻の指定例 2019-10-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：有料道路優先、距離優先 toll_gas：有料道路優先、ガソリン節約優先 free_time：無料道路優先、時間優先 free_distance：無料道路優先、距離優先 free_gas：無料道路優先、ガソリン節約優先 free_only：無料道路利用 |
||
| regulation | 規制に関する車体情報 | JSON表現 | JSON表現の詳細はこちらをご覧ください ※大型車の規制情報利用は、オプション機能のため、別途契約が必要となります (APIマーケットでは利用不可) |
|||
| order | 出力順 | 文字列 | time | total_distance: 総移動距離 time: 所要時間 co2: 二酸化炭素排出量 |
1対多、または多対1ルート検索の場合のみ有効です 二酸化炭素排出量についての詳細はこちらをご覧ください |
|
| 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：ターンバイターン情報 co2：二酸化炭素概算排出量 |
交差点等、進行情報を案内するための地点情報を取得します 二酸化炭素排出量についての詳細はこちらをご覧ください |
||
| 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(ルート形状)が出力されます | |
| divide_with | セクション分割出力 | 文字列 | sa：サービスエリア pa：パーキングエリア |
ルート検索結果のセクション情報を指定の要素で分割して返却します ピリオド区切りで複数指定が可能です 「options」で「turn_by_turn」を指定時のみ有効です |
||
| datum | 緯度経度の測地系 | 文字列 | wgs84 | wgs84：世界測地系 tokyo：旧日本測地系 |
||
| coord_unit | 出力データに含まれる緯度経度の単位 | 文字列 | degree | degree：度表記の10進法 millisec：ミリ秒表記 |
||
| lang | 言語 | 文字列 | ja: 日本語 en: 英語 ko: 韓国語 zh-CN: 中国語(簡体字) zh-TW: 中国語(繁体字) th: タイ語 |
出力する言語を指定します ※多言語オプション申込時のみ利用可能 (APIマーケットでは利用不可) |
||
| optimize_riding_location | 最適乗車位置取得 | 真偽値 | false | true：最適乗車位置情報を取得する false：最適乗車位置情報を取得しない |
パラメータ「start」にカンマ区切りの緯度経度を指定した場合、またはJSON表現でlat/lonを指定した場合のみ有効です 詳細はこちらをご覧ください |
|
| use_byway | 抜け道ルートの検索 | 真偽値 | false | true：抜け道ルートを検索する false：抜け道ルートを検索しない |
リクエスト条件や交通情報等により、抜け道ルートが出ない場合があります ※抜け道ルート検索オプション申し込み時のみ利用可能 |
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（日付時刻指定）：目的地への到着時刻の指定
両方未指定の場合は、検索実行日時が出発時刻となります。
経路検索条件の無料道路利用の注意点について
無料道路利用は無料道路優先より高い優先度で検索する経路検索条件です。
パラメータの組み合わせによって、一部経路結果に有料道路が含まれる場合がありますのでご了承ください。
二酸化炭素排出量の注意点について
二酸化炭素排出量(g/m)は1人を1m運ぶ際の概算量です。
移動手段と移動距離による単純計算により算出しています。
渋滞や信号停止による加算、速度や車種等の細かい条件は考慮されていません。
出典元：「運輸・交通と環境 2018年版」
監修：「国土交通省総合政策局環境政策課」
利用したい道路ID(use_road)について
利用したい道路の道路IDを指定することで、その道路を利用するルートを優先して検索します。
出発地・目的地の位置関係や道路データ収録状況の影響により、指定した道路が考慮されない場合があります。
利用したくない道路ID(unuse_road)と同一の道路IDを指定した場合はエラーとなります。
利用したくない道路ID(unuse_road)について
利用したくない道路の道路IDを指定することで、その道路を利用しないルートを優先して検索します。
指定した道路が考慮されない場合があります(例えば指定した道路が出発地と重なった場合)。
利用したい道路ID(use_road)と同一の道路IDを指定した場合はエラーとなります。
対応しているICについて(avoid_etc_only)
首都高(ICは入口のみETC専用化)
霞ヶ関(内外)、代官町(内)、空港西(上)、新宿(上)、初台(下)、幡ヶ谷(上)、一ツ橋(下)、護国寺(上)、中環大井南(外)、富ヶ谷(外)、初台南(内)、滝野川(内)、高松(外)、王子北(外)、四つ木(内外)、清新町(内)、さいたま見沼(上)、浦和南(上)、浜町(上下)、加平(南)(上下)、加平(北)(上下)、晴海(下)、加賀(上)、安行(上)、新木場(東西)、大井(東)、磯子(東)、木場(上)、横浜駅東口(下)、新山下(上下)、馬場
東日本高速道路(ICは入口のみETC専用化)
戸田西(内)、戸田東(外)
中日本高速道路
稲城(入口)、八王子西(出入口)
最適乗車位置の取得について(optimize_riding_location)
指定された出発地点から最適な乗車位置を検索します。
指定した出発位置によっては、最適な乗車位置の取得ができない場合があります。
地点の 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 | 経由地の滞在時間(単位：分) | 数値 | 滞在時間の最小値、最大値はvia_typeによって異なります ・指定順： 最小値：0 最大値：720 ・最適順/経由地間最適順 最小値：0 最大値：300 経由地を指定する場合のみ使用可能です |
||
| intersection | 交差点ID | 文字列 | 2桁〜5桁 交差点を2地点まで指定する場合に使用可能です 緯度経度と併せて指定してください |
||
| 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地点の経由地指定が可能です。
※オプション契約していただいた方に限り、多地点巡回ルート検索(車)を利用いただくと150地点まで指定することが可能です。
経由地に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(経由地間最適順)が指定された場合はエラーを返します。
経由地に交差点IDを指定する場合の指定方法について
パラメータintersectionに指定するID及びその緯度経度は交差点名検索APIにて取得することができます。
intersectionを指定した場合は、lat/lonも必ず指定してください。
intersectionは経由地の数に含まれます。
intersectionを経由地に指定した場合の記述例は以下の通りです。
【南青山三丁目交差点と神宮前一丁目交差点を経由する場合】
via=[{"lat":35.669059,"lon":139.715981,"intersection":"49832"},{"lat":35.67214,"lon":139.708141,"intersection":"51710"}]
※経由地に交差点を指定する際、指定可能な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から推奨出発時刻を算出し、それを用いてルート検索を行います。
regulation の JSON 表現
| プロパティ名 | 必須 | 概要 | 型名 | デフォルト値 | 備考 |
|---|---|---|---|---|---|
| regulation-type | 車両区分 | 文字列 | 以下のいずれかより1つ指定します standard_passenger :普通乗用自動車 medium_passenger :中型乗用自動車 specific_medium_passenger :特定中型乗用自動車 large_passenger :大型乗用自動車 standard_truck :普通貨物自動車 medium_truck :中型貨物自動車 specific_medium_truck :特定中型貨物自動車 large_truck :大型貨物自動車 large_special_vehicle :大型特殊自動車 small_special_vehicle :小型特殊自動車 light_vehicle :軽自動車 semimedium_passenger :準中型乗用自動車 semimedium_truck :準中型貨物自動車 |
||
| toll-type | 料金車種区分 | 文字列 | 以下のいずれかより1つ指定します small :軽自動車等 standard :普通車 medium :中型車 large :大型車 extra_large :特大車 |
||
| dangerous-goods | 危険物積載車両通行規制考慮 | 文字列 | use：考慮する | ||
| car-body | 車体情報 | JSON表現 |
car-body の JSON 表現
| プロパティ名 | 必須 | 概要 | 型名 | デフォルト値 | 備考 |
|---|---|---|---|---|---|
| height | 車の高さ(単位：cm) | 数値 | |||
| width | 車の幅(単位：cm) | 数値 | |||
| length | 車の長さ(単位：cm) | 数値 | |||
| weight | 車の重量(単位：kg) | 数値 | |||
| max-loading-capacity | 車の最大積載量(単位：kg) | 数値 |
arrival-times の JSON 表現
| プロパティ名 | 必須 | 概要 | 型名 | デフォルト値 | 備考 |
|---|---|---|---|---|---|
| from | ✔︎ | 到着希望時間帯の開始時刻 | 文字列（日付時刻）YYYY-MM-DDThh:mm:ss |
時刻の指定例 2019-10-01T08:00:00 | |
| to | ✔︎ | 到着希望時間帯の終了時刻 | 文字列（日付時刻）YYYY-MM-DDThh:mm:ss |
時刻の指定例 2019-10-01T08:00:00 |
arrival-timesを使用したルート検索ではarrival-timesで指定した時間帯と実際の到着時刻を比べて、最も差異の少ないルートを返却しています。
必ずしも全ての経由地が希望到着時間帯内に到着できるわけではありません。
regulation、car-bodyのJSON表現について
入力された項目のみ考慮しますので、すべての項目を指定する必要はありません
規制に関する車体情報の用途について
regulation-type：通行止め、指定方向外通行禁止などの道路規制の対象となる車両区分を指定します
toll-type：スマートICで通行可否を考慮する場合の料金車種区分を指定します
dangerous-goods：危険物積載車両通行規制道路を通行できるかどうかを判定するために使用します
car-body：車両の大きさや重量により対象道路を通行できるかどうかを判定するために使用します
regulationのJSON表現例
・規制種別：大型貨物自動車, 料金車種：大型自動車, 車長：1200cm, 車高：320cm, 車幅：250cm,重量：24860kg, 最大積載量：15300kg
{
"regulation-type": "large_truck",
"toll-type": "large",
"car-body": {
"length": 1200,
"height": 320,
"width": 250,
"weight": 24860,
"max-loading-capacity": 15300
}
}
arrival-timesのJSON表現例
・到着希望時間帯の開始時刻：2019-10-01T08:00:00, 到着希望時間帯の終了時刻：2019-10-01T08:15:00
"arrival-times":[
{
"from": "2019-10-01T08:00:00",
"to": "2019-10-01T08:15:00"
},
{
"from": "2019-10-01T16:00:00",
"to": "2019-10-01T16:15:00"
}
]
パラメータ構成例（1対1ルート検索）
・出発地：東京都庁、目的地：柏駅、検索条件：有料道路利用、時間優先、出発時刻：2019年10月1日8時、ターンバイターン情報を出力
/route_car?start={"lat":35.689457,"lon":139.691935,"name":"東京都庁"}&goal=00007423&condition=toll_time&start_time=2019-10-01T08:00:00&options=turn_by_turn
パラメータ構成例（1対多ルート検索）
・出発地：東京都庁、目的地1：墨田区錦糸町付近、目的地2：港区芝公園付近、の2ルートを出力
/route_car?start=35.689457,139.691935&goal=[{"lat":35.706822,"lon":139.813956},{"lat":35.655392,"lon":139.748642}]&condition=toll_time&start_time=2019-10-01T08:00:00
JSON 表現は URL エンコードをした上でリクエストしてください
レスポンス
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| ルート情報 | items | Routeオブジェクト | 〇 | ルートに関する情報のまとまり |
| 単位情報 | unit | Unitオブジェクト | 出力される単位の情報 |
Routeオブジェクト
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| 経路の概要 | summary | RouteSummaryオブジェクト | 経路の概要に関する情報のまとまり | |
| 地点間の移動方法 | sections | RouteSectionItemオブジェクト | 〇 | 地点間の移動に関する情報のまとまり |
| 料金情報 | fares | FareItemオブジェクト | 〇 | 料金に関する情報のまとまり 有料道路利用時のみ出力 |
| ルート形状 | shapes | FeatureCollectionオブジェクト | ルート形状に関する情報のまとまり shape=true指定時のみ出力 shapesは/shape_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'のときのみ出力 |
|
| 最適乗車位置返却可否フラグ | optimized_riding_location | 真偽値 | true：最適乗車位置返却可能 false：最適乗車位置返却不可 'start'内に出力 optimize_riding_locationパラメータにtrueを指定した場合のみ返却 |
到着希望時間内外判定フラグについて
到着希望時間帯とは、arrival-timesパラメータで指定した時間帯を指します。
arrival-timesパラメータは地点のJSON表現内で指定することができます。
最適乗車位置返却可否フラグについて
trueの場合、startの緯度経度が最適乗車位置となります。
多対1、1対多検索の場合、最適乗車位置が取得できた経路のみstartの緯度経度が最適乗車位置となり、trueを返却します。
一部の経路探索が失敗した場合は、全経路一律falseとなります。
・最適乗車位置の返却例
"summary":{
"no": "1",
"start":{
"type": "point",
"coord":{
"lat": 35.665451,
"lon": 139.712596
},
"name": "start",
"optimized_riding_location": true
},
・・・
RouteSummaryItemオブジェクト（type=move：移動情報）
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| 料金 | fare | Fareオブジェクト | ||
| 有料道路走行距離(単位：m) | toll_road_distance | 数値 | ||
| タイプ | type | 文字列 | 常に'move'が入る | |
| 出発時刻 | from_time | 日付時刻 | ||
| 到着時刻 | to_time | 日付時刻 | ||
| 総移動時間(単位：分) | time | 数値 | ||
| 移動距離(単位：m) | distance | 数値 | ||
| 規制情報 | notations | 文字列 | regulation：規制突破 | |
| その他料金 | other_fare | OtherFareオブジェクト | ||
| 二酸化炭素排出量(単位 : g/m) | co2 | 数値 |
OtherFareオブジェクト
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| タクシー料金(単位：円) | taxi | 数値 | 各地域の初乗り料金/加算料金等を考慮した概算料金 |
タクシーの乗車時間と料金について
・タクシーの乗車時間と料金は目安です。
・乗車時間は道路事情により、実際と異なる場合がございます。 タクシー料金は概算の金額です。走行距離で算出しており､信号や渋滞による停車などの時間は考慮しておりません
・料金は、出発地の初乗り料金と加算料金を基準としております。深夜料金は22時～5時の間に乗車した場合､全走行距離2割増で算出しています。また､有料道路の料金は含まれておりません。
・各タクシー会社や地域により料金は異なることがあります。 あくまで参考としてご覧ください。
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 | 数値 | 経由地の場合のみ出力 | |
| SA/PA種別 | sapa_type | 文字列 | SA：サービスエリア PA：パーキングエリア ターンバイターン情報つき指定時、かつSA/PAの場合のみ出力 |
|
| SA/PAのID | sapa_id | 文字列 | ターンバイターン情報つき指定時、かつSA/PAの場合のみ出力 |
RouteSectionItemオブジェクト（type=move：地点間の移動情報）
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| タイプ | type | 文字列 | 常に'move'が入る | |
| 移動手段 | move | 文字列 | 常に'car'が入る | |
| 出発時間 | from_time | 日付時刻 | 一つ上のpointからの出発時刻 | |
| 到着時間 | to_time | 日付時刻 | 一つ下のpointへの到着時刻 | |
| 移動時間(単位：分) | time | 数値 | type=point間の移動時間 | |
| 移動距離(単位：m) | distance | 数値 | type=point間の移動距離 | |
| 道路名 | line_name | 文字列 | ターンバイターン情報つき指定時は道路名を出力 道路名がない場合は出力されない ターンバイターン情報つき未指定時は「"車"」固定 langパラメータ指定を指定した場合、指定言語の翻訳値が出力される 翻訳できない場合は日本語の値が出力される |
|
| 規制情報 | restrictions | Restrictionオブジェクト | 〇 | |
| フェリー利用状況 | use_ferry | 文字列 | partial: 一部区間でフェリーを利用している フェリー利用がある場合のみ出力 |
Restrictionオブジェクト
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| 緯度経度 | coord | Coordinateオブジェクト | ||
| リンクの長さ | link_length | 数値 | ||
| 規制内容 | matter | 文字列 | closed：通行止め ingress：進入禁止 closed_one_way：一方通行逆走 closed_before_opening：開通前道路走行 closed_dangerous_goods：危険物積載車両 closed_zone30：ゾーン30情報 closed_tandem：タンデム規制 closed_speed：速度規制 closed_lane：車線規制 closed_one_side：片側規制 closed_chain：チェーン規制 closed_moving：移動規制 closed_on_ramp：オンランプ規制 closed_off_ramp：オフランプ規制 closed_others：その他規制 limit_car_width：車幅規制[cm] limit_car_height：車高規制[kg] limit_car_weight：重量規制[kg] limit_car_length：車長規制[cm] limit_car_max_load：最大積載量規制[kg] car_type_closed：車種別通行止め car_type_ingress：車種別進入禁止 |
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": 1370.0,
"unit_1024_2": 2470.0,
"unit_1025_2": 1670.0,
"unit_1024_3": 2900.0,
"unit_1025_3": 1930.0,
"unit_1024_4": 3850.0,
"unit_1025_4": 2520.0,
"unit_1024_5": 6210.0,
"unit_1025_5": 3990.0,
"unit_1024_100": 2010.0,
"unit_1025_100": 1370.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
}
}
},
・・・
],
"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
},
{
"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
},
{
・・・
},
{
"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
},
{
"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": "首都中央環状線"
}
・高速道路料金の概要
"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": 510.0,
"unit_1024_2": 1950.0,
"unit_1025_2": 600.0,
"unit_1024_3": 2310.0,
"unit_1025_3": 680.0,
"unit_1024_4": 3110.0,
"unit_1025_4": 880.0,
"unit_1024_5": 5080.0,
"unit_1025_5": 1350.0,
"unit_1024_100": 1590.0,
"unit_1025_100": 510.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,
"other_fare": {
"taxi": 5460
}
}
},
・・・
}
],
"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"
},
{
"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"
},
{
"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"
},
{
・・・
},
{
"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"
},
{
"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"
},
{
"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"
}
]