Header 27c38522c852ca87ddbf41b4386cb8e585db7b331703443dfb8f1c9bb3c231cd

電脳交通API@AWARDS用

電脳交通はタクシー事業者様の配車業務のお手伝いをし地域交通を支えるベンチャー企業です。
それとタクシー需要を掘り起こし、業界の盛り上げのお役に立ちたいとも思っています。
新しいタクシーの使い方を皆さんと考えるため MASHUP AWARDS 2016 およびLINE BOT AWARDS にAPIを提供させていただきます。
今回はデモAPIで現実のタクシーとは連動せず利用申請もありませんので、お気軽にお試しください。

1.事業者検索API

現在地に配車可能なタクシー事業者の一覧を検索します。
※全ての地点で同一の架空の事業者がレスポンスされます

http://ma2016.gtlab.jp/dennoapi/companies?lat=35.66566&lng=139.73091

リクエスト

世界測地系です
  • lat : 乗車場所の緯度
  • lng : 乗車場所の経度

レスポンス

info
  • request_id : 依頼を特定する固有ID
companiesに事業者の一覧が格納されます
  • company_id : 事業者の固有ID
  • name : 事業者の名前

2.タクシー検索API

指定した事業者が乗車場所に配車可能なタクシーを検索します。
※架空のタクシーがレスポンスされます
※山間部や海上では0件になる場合もあります

http://ma2016.gtlab.jp/dennoapi/cars?request_id=d7bf78e7ea0e53df95e69978097d1f5c6028d6f09efe541cfd793e0592fcd361&company_id=3

リクエスト

  • request_id : 1で得られた依頼の固有ID
  • company_id : 1で得られた事業者の固有ID

レスポンス

carsにタクシーの一覧が格納されます
  • car_id : タクシーの固有ID
  • lat : タクシーの緯度
  • lng : タクシーの経度
  • dist : 現在地からタクシーまでの距離(m)

3.配車依頼API

指定した事業者に配車を依頼します
※デモ用にランダムな車両が即配車されるという動作になっています。本来は弊社オペレーターが最適な車両を選び配車します

http://ma2016.gtlab.jp/dennoapi/request?request_id=d7bf78e7ea0e53df95e69978097d1f5c6028d6f09efe541cfd793e0592fcd361&company_id=3&memo=スタバ前に女3人で立っています

リクエスト

  • request_id : 1で得られた依頼の固有ID
  • company_id : 1で得られた事業者の固有ID
  • memo : 運転手が依頼者を見つけるための情報
    具体的な場所、性別、容姿、など
    * 個人情報は送信しないでください

レスポンス

infoに依頼の状況がレスポンスされます
  • success : 成功時 メッセージ
  • error : 失敗時 メッセージ
  • requested_at : 依頼の受付日時(unixtime)
  • car_id : 依頼した車両の固有のID
  • memo : 運転手に伝えた情報

依頼後の流れ

タクシー検索APIのレスポンスのcarsに requested_at など配車車両と判別できる情報が追加されます。
また、配車されたタクシーが現在地に向かって移動してきます。(他のタクシーは動きません)
架空のタクシーですので、移動は距離や経路に関係なく直進し15秒で到着するように調整しています。
到着後15秒経つと乗車したと仮定し依頼を削除し、タクシーは元の位置にワープします。

その他注意事項

APIのレスポンスはjsonで、クロスドメインでの呼び出しに対応しています。
エラーメッセージが出ない、たまにメンテナンスでAPIが落ちる、など不便もありますがデモなのでご了承ください。
使い方がわからない方は y.bando@gtlab.jp までお気軽に。
あと「こういう機能あったら面白いの作れるのに」とアイデアいただければ、今回はデモなので気軽に対応いたします。

動作デモ

中心地点で事業者を検索