WEBを駆使した売上UP/トータルサポートを提供　
株式会社パルムゲート

鉄道路線と駅のデータを無償提供してくれている「駅データ.jp」さんのデータを、CakePHP からなるべく簡単に使う方法を考えてみた。

折角だから、CakePHP のキャッシュを使って駅データサーバへのアクセスを減らすようにした。

//
// 駅データ.jp API をアクセスするためのクラスとメソッド群
//
class EkiDataAccess extends Object
{
	const CacheKey = 'EkiData';

	public function __construct()
	{
		// 駅データ.jp 用キャッシュキー設定
		if ( !Cache::config(self::CacheKey) )
		{
			// EkiData キャッシュが設定されていない場合のみ既定値で設定する。
			Cache::config(self::CacheKey, array(
				'engine' => 'File',
				'duration' => '+7 days',	// キャッシュの有効期限は7日
				'path' => CACHE . self::CacheKey . DS,
				'prefix' => 'ekidata_',
			));
		}
		parent::__construct();
	}
	// 都道府県 ID で指定された都道府県に所属する路線の一覧を配列形式で返す
	// 第2パラメータ $full が true の場合は、取得したデータをそのまま配列化して返す。
	// false の場合は {路線コード} => {路線名} の連想リストとして返す
	public function getLinesByPrefId($id, $full=TRUE)
	{
		if ( !($result=Cache::read("p_{$id}", self::CacheKey)) )
		{
			$result = Xml::toArray(Xml::build("http://www.ekidata.jp/api/p/{$id}.xml"));
			if ( !@$result['ekidata']['line'][0] )
			{
				// line 構造が1つしかない場合の処理
				$result['ekidata']['line'] = array($result['ekidata']['line']);
			}
			Cache::write("p_{$id}", $result, self::CacheKey);
		}
		if ( !$full )
		{
			$tmp = array();
			foreach ( $result['ekidata']['line'] as $l )
			{
				$tmp[$l['line_cd']] = $l['line_name'];
			}
			$result = $tmp;
		}
		return $result;
	}

	// 路線 ID で指定された路線に所属する駅の一覧を配列形式で返す
	// 第2パラメータ $full が true の場合は、取得したデータをそのまま配列化して返す。フルデータには路線名情報も含まれている。
	// false の場合は {駅コード} => {駅名} の連想リストとして返す
	public function getStationsByLineId($id, $full=TRUE)
	{
		if ( !($result=Cache::read("l_{$id}", self::CacheKey)) )
		{
			$result = Xml::toArray(Xml::build("http://www.ekidata.jp/api/l/{$id}.xml"));
			if ( !@$result['ekidata']['station'][0] )
			{
				// station 構造が1つしかない場合の処理
				$result['ekidata']['station'] = array($result['ekidata']['line']);
			}
			Cache::write("l_{$id}", $result, self::CacheKey);
		}
		if ( !$full )
		{
			$tmp = array();
			foreach ( $result['ekidata']['station'] as $s )
			{
				$tmp[$s['station_cd']] = $s['station_name'];
			}
			$result = $tmp;
		}
		return $result;
	}

	// 駅 ID で指定された駅情報を返す
	public function getStationDetailByStationId($id)
	{
		if ( !($result=Cache::read("s_{$id}", self::CacheKey)) )
		{
			$result = Xml::toArray(Xml::build("http://www.ekidata.jp/api/s/{$id}.xml"));
			Cache::write("s_{$id}", $result, self::CacheKey);
		}
		return $result;
	}
}

使用する場合は CakePHP のコード中で以下のようにする。

	App::uses('EkiDataAccess', {配置した場所});	// EkiDataAccess クラスをロードする

	$ekidata = new EkiDataAccess();	// EkiDataAccess クラスのインスタンスを生成する

	// 都道府県番号 (1～47) で指定された都道府県に所属する路線の簡易一覧を取得する
	$line_list = $this->ekidata->getLinesByPrefId({都道府県番号}, FALSE);
	// 駅データ.jp の路線番号で指定された路線の所属駅の簡易一覧を取得する
	$station_list = $this->ekidata->getStationsByLineId({駅データ.jp の路線番号}, FALSE);

以上で CakePHP から「駅データ.jp」の路線駅情報をアクセスできる。