タクシーを予約
APIメソッド:http://api.takutomo.com/v3/member/reserve_driver.php?api_key=xxxxxxx
■機能
タクシーを予約します。
成功すると、タクシー運転手の電話番号が返りますので、乗客ユーザーに表示して電話をかけて迎車場所などの詳細を伝えるよう促してください。
タクトモでは予約成立直後、乗客から電話をかけるルールとなっています。
■引数
api_key:必須:必ずGETで送信して下さい。
あなたのサイト/アプリからタクトモAPIへアクセスするためのAPI KEYです。タクトモに申請すると無料で取得できます。
guidだけ または emailとパスワードの両方:必須:必ずPOSTで送信して下さい。
そのユーザーが登録した認証情報を送信して下さい。ユーザーを特定するために使われます。
guidで指定する例:
guid=docomo,sI21G7q
emailとpasswordで指定する例:
email=sample@docomo.ne.jp
password=abcde
from_lat : 必須:必ずPOSTで送信して下さい。:取得するデーターの出発地の緯度。世界測位系。形式は[yyy.yyyy]
from_lon : 必須:必ずPOSTで送信して下さい。:取得するデーターの出発地の経度。世界測位系。形式は[xxxx.xxxx]
to_lat : 必須:必ずPOSTで送信して下さい。:取得するデーターの目的地の緯度。世界測位系。形式は[yyy.yyyy]
to_lon : 必須:必ずPOSTで送信して下さい。:取得するデーターの目的地の経度。世界測位系。形式は[xxxx.xxxx]
from_address : 必須:必ずPOSTで送信して下さい。: 出発地の住所や駅名など(UTF-8エンコーディングして下さい)
to_address : 必須:必ずPOSTで送信して下さい。: 出発地の住所や駅名など(UTF-8エンコーディングして下さい)
注意:
from_address と to_address は一般的に誰でも理解できる地名にして下さい。タクシー運転手へ送信されるメールに記載されます。
良い例:東京都港区1丁目、赤坂駅
悪い例:自宅、国道1号線、秘密基地 など
depart_date :必須:必ずPOSTで送信して下さい。:出発日。形式は[yyyymmdd]
depart_hour:必須:必ずPOSTで送信して下さい。:出発時。形式は[hh]:00~23で指定。
depart_min:必須:必ずPOSTで送信して下さい。 :出発分。形式は[mm]:00~59で指定。
driver_m_id:必須:必ずPOSTで送信して下さい。予約したいタクシー運転手の会員番号
member/search_driver.php で予約可能なタクシー運転手の会員番号を取得できます。
phone:必須:必ずPOSTで送信して下さい。 :乗客の携帯電話番号。半角数字で指定。
■動作確認用URL
http://api.takutomo.com/v3/member/reserve_driver.php?api_key=sample_user&dev_mode=ON
(dev_mode=ONをつけるとPOST引数を入力するフォームが表示され動作例を見ることができます。返り値のサンプルを取得できます。)
■返り値
成功の場合、status code に 0000~0999 が返ります。
失敗の場合は、status_codeに1000以上の数字が返ります。
成功の場合も、失敗の場合も、description に成功したメッセージまたはエラーの内容が返ります。そのままユーザーに表示できるように意図したメッセージ内容が返ります。