交通費計算(トータルナビ)

/widget/calc_cost [GET]

基本情報

概要

交通費計算を行うWebコンテンツ (HTML, JavaScript, CSS) を取得します。
※当APIをご利用の場合は、オプション契約が別途必要となります

URL

https://{HOST}/{CID}/v1/widget/calc_cost

※RapidAPIでは提供しておりません

出力形式

  • HTML
  • JavaScript
  • CSS
  • JSON

対応言語

  • ja

交通費計算Widget画面の呼び出しについて

経路や運賃などの情報を返却する呼び出し元画面は、サーバ上に配置したHTMLファイルである必要があります。

交通費計算Widget画面の認証について

下記のいずれかの方法でアクセス制限を設定することができます。
・IP制限（推奨）
お客様のCIDを利用するリクエストについて、指定したIPアドレス以外からのアクセスを拒否します。
第三者による不正アクセスを防ぐことができますが、お客様のサーバ側で交通費計算Widgetを返却する処理の実装が必要となります。
・ホスト制限
お客様のCIDを利用するリクエストについて、指定したホスト(リファラ)以外からのアクセスを拒否します。
簡易的な実装のみで交通費計算Widgetを利用することができますが、リファラは改ざん可能なため、セキュリティレベルが低くなります。

※IPが一意に定まらない環境をご使用の場合は、ホスト制限のみをご利用ください。

パラメータ

パラメータ名 必須 概要 型名 デフォルト値 上下限/選択値 備考
host ✔ サイトのドメイン 文字列
parts_color 各パーツのカラー 文字列(「#」より後ろのカラーコード) 007800 3桁もしくは6桁のカラーコードに対応しています
back_color 背景カラー 文字列(「#」より後ろのカラーコード) f9fdff 3桁もしくは6桁のカラーコードに対応しています
commuter_pass 定期券区間指定 文字列 レスポンス「commuter_pass_info」の値を指定してください(詳細はこちらをご覧ください)
以下の場合は定期券区間を指定しても無効になります
・経由地を指定した場合
・新幹線を利用する場合
・定期券区間が100kmを超える場合

定期券区間の指定について

定期券区間を指定する場合、一度指定したい定期券区間をウィジェットから取得する必要があります。
ウィジェットで取得した結果に定期券情報が存在する場合、「commuter_pass_info」として返却されます。

パラメータ構成例

・https://example.com/foo/baa.html のサイト上で各パーツのカラー(#264A84)と背景カラー(#DBDEDD)を指定し取得

/widget/calc_cost?host=example.com&parts_color=264A84&back_color=DBDEDD

レスポンス

名称 レスポンス名 型名 配列 説明
出発地点 start SpotInfoオブジェクト
目的地点 goal SpotInfoオブジェクト
経由地点 via SpotInfoオブジェクト 経由地指定時のみ出力
乗換回数 transit_count 数値
運賃
(ICカード/きっぷ, 片道/往復)		 fare 数値 運賃が存在する場合のみ出力
ウィジェット上の条件設定により、同一経路でも出力される値が変化します
総所要時間(単位：分) time 数値
総距離(単位：m) distance 数値
定期券運賃 total_commuter_pass TotalCommuterPassオブジェクト
乗車駅, 降車駅のリスト node_list 文字列 〇
乗車路線のリスト link_list 文字列 〇
各路線の運賃情報 transport_sections TransportSectionsオブジェクト 〇
定期券区間情報 commuter_pass_info 文字列 定期券のデータが存在する場合のみ出力
定期券区間を指定する場合、この値をパラメータ「commuter_pass」に設定してください

SpotInfoオブジェクト

名称 レスポンス名 型名 配列 説明
地点の名称 name 文字列 駅名もしくは住所から検索した場合のみ出力
緯度経度 coord Coordinateオブジェクト

Coordinateオブジェクト

名称 レスポンス名 型名 配列 説明
緯度 lat 数値
経度 lon 数値

TotalCommuterPassオブジェクト

名称 レスポンス名 型名 配列 説明
列車の定期券運賃 train CommuterPassオブジェクト 列車の定期券運賃が存在する場合のみ出力
バスの定期券運賃 bus CommuterPassオブジェクト バスの定期券運賃が存在する場合のみ出力

CommuterPassオブジェクト

名称 レスポンス名 型名 配列 説明
1ヶ月の運賃 1_month 数値 1ヶ月通勤定期のデータが存在する場合のみ出力
3ヶ月の運賃 3_months 数値 3ヶ月通勤定期のデータが存在する場合のみ出力
6ヶ月の運賃 6_months 数値 6ヶ月通勤定期のデータが存在する場合のみ出力

TransportSectionsオブジェクト

名称 レスポンス名 型名 配列 説明
移動手段 move_type 文字列
路線名 link_name 文字列
乗車駅と降車駅情報 node Nodeオブジェクト
運賃 fare 数値 運賃が存在する場合のみ出力
定期券運賃 commuter_pass CommuterPassオブジェクト 定期券運賃が存在する場合のみ出力

Nodeオブジェクト

名称 レスポンス名 型名 配列 説明
乗車駅名称 from 文字列
降車駅名称 to 文字列

バスデータの利用について

バス利用を含むルート検索には別途利用契約が必要になります（ご契約されていない状態ですと利用できません）
ご希望の場合は、営業担当もしくはサポートまでご連絡ください。

時刻表データの利用について

時刻表データ利用はオプション機能のため、別途契約が必要になります。
※時刻表オプション利用時のみ経路検索結果における時刻表示を行います
※時刻表データ利用のオプションをご利用しない場合は、ナビタイム独自の平均時間を用いた経路検索を行います

平均時間を用いた経路検索について

詳細は、Tipsの平均時間を用いた乗換検索をご確認ください。

本APIのサンプルについて

サンプルはこちらからご確認いただけます。

レスポンス例

{
    "start": {
        "name": "品川",
        "coord": {
            "lat": 35.628066,
            "lon": 139.738891
        }
    },
    "goal": {
        "coord": {
            "lat": 35.667399,
            "lon": 139.714888
        }
    },
    "via": {
        "name": "渋谷",
        "coord": {
            "lat": 35.658514,
            "lon": 139.701692
        }
    },
    "transit_count": 1,
    "fare": 336,
    "time": 26,
    "distance": 8906,
    "total_commuter_pass": {
        "train": {
            "1_month": 11700,
            "3_months": 33340,
            "6_months": 60020
        }
    },
    "node_list": [
        "品川",
        "渋谷",
        "表参道"
    ],
    "link_list": [
        "ＪＲ山手線",
        "東京メトロ銀座線"
    ],
    "transport_sections": [
        {
            "move_type": "local_train",
            "link_name": "ＪＲ山手線",
            "node": {
                "from": "品川",
                "to": "渋谷"
            },
            "fare": 168,
            "commuter_pass": {
                "1_month": 5270,
                "3_months": 15010,
                "6_months": 25290
            }
        },
        {
            "move_type": "local_train",
            "link_name": "東京メトロ銀座線",
            "node": {
                "from": "渋谷",
                "to": "表参道"
            },
            "fare": 168,
            "commuter_pass": {
                "1_month": 6430,
                "3_months": 18330,
                "6_months": 34730
            }
        }
    ]
}

動作環境について

当 API の動作環境は次のとおりです。

【ブラウザ】

  • Safari 最新バージョン
  • Google Chrome 最新バージョン

スマホ・タブレットでの表示について

スマホやタブレットを使用した表示に対応しています。