タクシーを検索

APIメソッド:http://api.takutomo.com/v3/member/search_driver.php?api_key=xxxxxxx

■機能
空車のタクシーを検索します。
成功すると、予約可能なタクシー運転手の会員番号が返ります。
タクシー運転手の会員番号を member/get_profile に渡すと、タクシーの詳細データーを取得できます。

■引数
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]

depart_date :必須:必ずPOSTで送信して下さい。:出発日。形式は[yyyymmdd]
depart_hour:必須:必ずPOSTで送信して下さい。:出発時。形式は[hh]:00~23で指定。
depart_min:必須:必ずPOSTで送信して下さい。 :出発分。形式は[mm]:00~59で指定。

注意:
タクトモ側でタクシーの現在位置と乗客の現在位置から迎車に必要な時間を計算しています。
出発日時が現在時刻からすぐだと、迎車できる距離にいるタクシーが少なくなり、検査結果の件数が少なくなります。
最低でも現在時刻から10分以上あとの時間を指定しないとエラーを返します。

category:必須:必ずPOSTで送信して下さい。:次の選択しから1つ選び、UTF-8エンコーディングして送って下さい。
全て
高級車
運賃格安
安心大手
大型車

■動作確認用URL
http://api.takutomo.com/v3/member/search_driver.php?api_key=sample_user&dev_mode=ON
(dev_mode=ONをつけるとPOST引数を入力するフォームが表示され動作例を見ることができます。返り値のサンプルを取得できます。)

■返り値
成功の場合、status code に 0000~0999 が返ります。
失敗の場合は、status_codeに1000以上の数字が返ります。
成功の場合も、失敗の場合も、description に成功したメッセージまたはエラーの内容が返ります。そのままユーザーに表示できるように意図したメッセージ内容が返ります。

返り値の説明:
-
200100000000002010 運転手の会員番号。
1 お勧めタクシーの場合1、お勧めでないタクシーは0。
タクシー次郎 運転手氏名
タクトモ交通 会社名
プリウス 車種
カテゴリー
稚内駅(北海道) 現在位置の住所
45.4170 現在位置の緯度(世界測位系)
141.6770 現在位置の経度(世界測位系)
0 乗客からの距離
5260 概算運賃
0 指定した時間に迎車できる場合は0。少し遅れる場合は遅れる分数。

運転手が車や自分の写真をアップしている場合はそのパス。

Comments are closed.