相乗り募集リスト取得(API版)
１、【概要】
相乗り募集状況データーを取得できます。
２、【使用方法】
http://api.takutomo.com/v2/search_event.php
に引数をPOSTまたはGETします。api_keyは必ずGETで送信して下さい。
返り値は、xml形式またはｃｓｖ形式で返ってきます。
３、【引数】
api_key(API KEY)：必須
あなたのサイト/アプリからタクトモAPIへアクセスするためのAPI KEYです。タクトモに申請すると無料で取得できます。
———————-
出発時間の指定：
depart_time_min : 取得するデーターの相乗り出発日の開始範囲。形式は[yyyymmddhhmm]：指定しない場合は現在時刻がデフォルトになります。
depart_time_max :取得するデーターの相乗り出発日の終了範囲。形式は[yyyymmddhhmm]：指定しない場合は、無限遠の未来となります。
———————-
出発場所の指定（検索中心点の緯度経度と検索半径で指定する場合）
世界測地系で指定：指定しない場合は、出発場所には関わらず他の条件だけで検索した結果となります。
from_lat_center : 取得するデーターの出発地の中心地の緯度。形式は[yyy.yyyy]
from_lon_center : 取得するデーターの出発地の中心地の経度。形式は[xxxx.xxxx]
from_radius : 取得するデーターの出発地の中心地からの検索半径。形式は[xxxxxx] 単位はメートル。
出発場所の指定（緯度経度で範囲を指定する場合）
世界測地系で指定：指定しない場合は、出発場所には関わらず他の条件だけで検索した結果となります。
from_lat_min : 取得するデーターの出発地の緯度範囲の最小値。形式は[yyy.yyyy]
from_lat_max : 取得するデーターの出発地の緯度範囲の最大値。形式は[yyy.yyyy]
from_lon_min : 取得するデーターの出発地の経度範囲の最小値。形式は[xxx.xxxx]
from_lon_max : 取得するデーターの出発地の経度範囲の最大値。形式は[xxx.xxxx]
———————-
目的地の指定（検索中心点の緯度経度と検索半径で指定する場合）
世界測地系で指定：指定しない場合は、目的地には関わらず他の条件だけで検索した結果となります。
to_lat_center : 取得するデーターの出発地の中心地の緯度。形式は[yyy.yyyy]
to_lon_center : 取得するデーターの出発地の中心地の経度。形式は[xxxx.xxxx]
to_radius : 取得するデーターの出発地の中心地からの検索半径。形式は[xxxxxx] 単位はメートル。
目的地の指定（緯度経度で範囲を指定する場合）
世界測地系で指定：指定しない場合は、目的地には関わらず他の条件だけで検索した結果となります。
to_lat_min : 取得するデーターの出発地の緯度範囲の最小値。形式は[yyy.yyyy]
to_lat_max : 取得するデーターの出発地の緯度範囲の最大値。形式は[yyy.yyyy]
to_lon_min : 取得するデーターの出発地の経度範囲の最小値。形式は[xxx.xxxx]
to_lon_max : 取得するデーターの出発地の経度範囲の最大値。形式は[xxx.xxxx]
———————-
返り値フォーマットの指定
format=csv : ｃｓｖ形式で返ります。
format=xml : ｘｍｌ形式で返ります。
指定しない場合は、ｘｍｌ形式となります。
———————-
※結果は出発日時順に返ります。結果が多い場合は１００件まで返ります。
４、【返り値フォーマット】
ｃｓｖ形式の場合：
[相乗り募集ID],[募集開始日時],[出発日時],[出発地],[目的地],
[出発地の緯度],[出発地の経度],[目的地の緯度],[目的地の経度],[将来拡張用]
形式は[yyyymmddhhmm],[yyyymmddhhmm],[string],[string],[number],[number],[number],[number]
データ１行ごとに改行が入ります。
１行の最後は、将来データーが追加される可能性があります。（[将来拡張用]と書いてある部分）
【使用例】
呼び出し例１：
http://api.takutomo.com/v2/search_event.php?api_key=sample_user&depart_time_min=200910150000&from_lat_min=34.0000&from_lat_max=36.0000&from_lon_min=138.0000&from_lon_max=140.0000
呼び出し例２：
http://api.takutomo.com/v2/search_event.php?api_key=sample_user&depart_time_min=200910150000&depart_time_max=200910170000&from_lat_center=35.6917&from_lon_center=139.7709&from_radius=50000&format=csv