ワリカン電卓
APIメソッド:http://api.takutomo.com/v3/member/calc_fare_split.php?api_key=xxxxxxx
■機能
相乗りしている最中に、各参加者の負担額を計算します。
■引数
api_key:必須:必ずGETで送信して下さい。
あなたのサイト/アプリからタクトモAPIへアクセスするためのAPI KEYです。タクトモに申請すると無料で取得できます。
prev_fare_per_person:必須:必ずGETで送信して下さい。
相乗りして最初に降りる人の負担額を計算する場合は 0 を送って下さい。
1人以上が降りたあとの2人目以降に降りる人の負担額を計算する場合は、直前に降りた人がいた時点での1人あたり負担額を送って下さい。
prev_meter_fare:必須:必ずGETで送信して下さい。
相乗りして最初に降りる人の負担額を計算する場合は 0 を送って下さい。
1人以上が降りたあとの2人目以降に降りる人の負担額を計算する場合は、直前に降りた人がいた時点での運賃(メーター+高速代)を送って下さい。
collected_fare:必須:必ずGETで送信して下さい。
相乗りして最初に降りる人の負担額を計算する場合は 0 を送って下さい。
1人以上が降りたあとの2人目以降に降りる人の負担額を計算する場合は、今まで降りた人が支払った総額を送って下さい。
get_off_everybody:必須:必ずGETで送信して下さい。
いま乗車中の人が全員降りる場合は、get_off_everybody=yes を送って下さい。
引続き乗車する人がいる場合は、get_off_everybody=no を送って下さい。
■使い方
一番最後に降りる人の携帯で計算して下さい。
タクシーで相乗りしている最中に、参加者が下車するたびに,運賃(メーター+高速代)を入力して下さい。
例えば3人で相乗りした場合、まず最初に降りる人がいた場所でのメーター料金を入力します。
その後,2人目が降りるときに再度入力します。
自動的に降りる人の負担額が計算されるので便利です。
■この電卓の計算式
途中で降りる人がいた場合は、一緒に乗っていた区間までを均等割し、残りの区間は引き続き乗っている人だけでワリカンします。
小銭のやりとり軽減のため100円未満の端数は,繰上げます。
■注記事項
出発地が全員同じ場所でないと計算できません。
■動作確認用URL
http://api.takutomo.com/v3/member/calc_fare_split.php?api_key=sample_user&dev_mode=ON
(dev_mode=ONをつけるとPOST引数を入力するフォームが表示され動作例を見ることができます。返り値のサンプルを取得できます。)
■返り値
成功の場合、status code に 0000~0999 が返ります。
失敗の場合は、status_codeに1000以上の数字が返ります。
成功の場合も、失敗の場合も、description に成功したメッセージまたはエラーの内容が返ります。そのままユーザーに表示できるように意図したメッセージ内容が返ります。
new_fare_per_person:一人あたり負担額。計算結果。この値は、次に降りる人の負担額を計算するときに、再帰的に使用します。
collected_fare:今までに徴収した金額。この値は、次に降りる人の負担額を計算するときに、再帰的に使用します。