Jリーグ日程取得する勝手API

Jリーグ公式サイトをスクレイピングして、Jリーグの日程を取得する勝手WebAPIを作ってみた。

本体は、PHPで作成。最初、取得したHTMLをHTML_Parserを使用して、一旦xhtmlに変換してから修理してたのだが、HTMLのサイズがでかいので、ここでかなり時間を食っていた。
しょうがないので、HTMLを直接DOMdocumentのparseHTMLで読ませたら、なぜか文字化け。あれこれと調べてたら、どうもpaseHTMLは、HTML内のMETAデータを判断してエンコードしてるらしい。
取得したHTMLはいきなりBODYから始まってたんで、HEADタグすらない。しょうがないので、強引にHEADタグを挿入してみてから、parseHTMLしたらうまくいった。

API仕様

APIの仕様はこんな感じ。REST形式です。

リクエストURL(暫定): http://labs.s-koichi.info/jleague/jleagueAPI.php

リクエストパラメータ:

パラメータ	値	説明
year(必須)	string	取得する予定表の年です。
league(必須)	string	リーグの種類: j1: J1リーグ j1-1: J1 1stステージ j1-2: J1 2ndステージ j2: J2リーグ ync: ヤマザキナビスコカップ
_render	string: json(デフォルト)	取得するデータ形式: json: JSON(P)形式 xml: XML形式
_callback	string	コールバック関数名です。データ形式がJSONのときに指定すると、JSONP形式で返します。

リクエストURLは暫定です。変わる可能性があります。というか、変わる予定です。

APIソースコード

さっそく、ソースを公開。こちらがAPI本体のクラス。

JleagueAPI.class.php

<?php
/*
 * $Id: jleagueAPI.class.php 459 2008-02-22 03:52:52Z koichi $
 */
require_once 'PEAR.php';
require_once 'HTTP.php';
require_once 'Cache/Lite.php';

require_once('jleagueclub.class.php');

/**
 * J.Leagueの試合予定を返すAPIクラス
 */
class jleagueAPI {
	/**
	 * URL取得用の変換キー
	 */
	protected $leaguekeys = array(
			'j1' => '010001',
			'j1-1' => '010001',
			'j1-2' => '010002',
			'j2' => '020003',
			'ync' => '002000',
		);

/**
	 * リーグ
	 */
	protected $league = null;
	public function getLeague()
	{
		return $this->league;
	}
	
	protected $year = null;
	/**
	 * 年
	 */
	public function getYear()
	{
		return $this->year;
	}

/**
	 * キャッシュのディレクトリ
	 */
	protected $cacheDir = "/tmp/cache/";
	
	/**
	 * キャッシュオブジェクト
	 */
	protected $cache;

/**
	 * 結果
	 */
	protected $result;
	
	/**
	 * コンストラクタ
	 */
	function __construct($league, $year, $cacheDir = NULL)
	{
		$this->league = $league;
		$this->year = $year;
		if($cacheDir) {
			$this->cacheDir = $cacheDir;
		}
	}
	
	/**
	 * URLを生成する
	 */
	private function getURL()
	{
		$url = 'http://www.j-league.or.jp/';
		$url .= 'SS/jpn/news/';
		$url .= $this->year;
		$url .= $this->leaguekeys[$this->league];
		$url .= '_W0501_J.html';
		
		return $url;
	}
	
	/**
	 * パースする
	 */
	public function execParse()
	{
		// キャッシュの設定 60秒x60分x24時間x60日保存する
		$options = array(
			'cacheDir' => $this->cacheDir,
			'lifeTime' => 60 * 60 * 24 * 60
		);
		
		// Cache_Liteを生成する。
		$this->cache = new Cache_Lite($options);
		if(!$this->cache) {
			print "キャッシュが生成できていない";
			return;
		}
		// キャッシュキーを生成
		$cachekey = "jleagueAPI_" . $this->year . "_" . $this->league;
		
		// URLを取得する。
		$url = $this->getURL();
		
		// ヘッダーを取得
		$result = HTTP::head($url);
		if(PEAR::isError($result)) {
			echo "error: " . $result->getMessage();
		}
		else if($result['response_code'] != "200") {
			// Responseが200以外はエラーにする。
			$this->result['http_error'] = $result;
			$this->result['count'] = 0;
			return false;
		}
		
		// キャッシュを取得
		$data = $this->cache->get($cachekey);
		if(!$data) { // キャッシュがなかった場合
			// HTMLを取得する。
			$html = file_get_contents($url);
			// UTF-8に変換
			mb_convert_variables('UTF-8', 'Shift_JIS', $html);

// loadHTMLの文字化け対策
			$html = str_replace('<BODY>', '<HEAD><META http-equiv="content-type" content="text/html; charset=UTF-8" /></HEAD><BODY>', $html);
			// キャッシュに保存
			$this->cache->save($html, $cachekey);
		}
		else { // キャッシュがあった場合
			$html = $data;
		}	
		
		// DOMdocumentを生成
		$doc = new DOMdocument();
		// HTMLを読み込む
		$doc->loadHTML($html);
		
		// DOMXPathを生成
		$xpath = new DOMXPath($doc);
		// 予定表部分を取得
		$entries = $xpath->query("//center/table[@border='0']/tr");
		
		$secdata = array(); // 節毎のデータ
		$sec = NULL; // 節
		$date = NULL; // 日付
		$match = NULL; // 試合毎のデータ
		foreach($entries as $node) {
			// 横線はスルー
			$linepath = $xpath->query("td[@colspan='8']", $node);
			if($linepath->length) {
				continue;
			}
						
			// 節
			$secpath = $xpath->query("td[@width='101']/font[@size='+0']", $node);
			if($secpath->length) {
				$secvalue = trim($secpath->item(0)->nodeValue);
				if($secvalue != "") {
					if($sec == NULL || $sec['sec'] <> $secvalue) {
						// 節が変わったので、節毎のデータを収納
						if($sec <> NULL) {
							$secdata[] = $sec;
						}
						// 節毎のデータを初期化
						$sec = array();
						$sec['sec'] = $secvalue;
						$sec['match'] = array();
					}
				}
			}

// 日ごとのデータをを初期化
			$data = array();
			// 開催日
			if($this->league == 'ync') {
				// ナビスコカップの場合
				$datepath = $xpath->query("td[@width='90']/font[@size='+0']", $node);
			}
			else {
				$datepath = $xpath->query("td[@width='37']/font[@size='+0']", $node);
			}
			if($datepath->length) {
				$datevalue = trim($datepath->item(0)->nodeValue);
				if($datevalue != "" && ereg("[0-9]{2}\/[0-9]{2}", $datevalue)) {
					// 日付だったら
					if($date != $datevalue) {
						// 日付が変わった
						$date = $datevalue;
					}
				}
			}

// キックオフ時間
			$kickoffpath = $xpath->query("td[@width='42']/font[@size='+0']", $node);
			if($kickoffpath->length) {
				$kickofftime = trim($kickoffpath->item(0)->nodeValue);
			}
			
			// ホーム
			$homepath = $xpath->query("td[@width='53']/font[@size='+0']", $node);
			if($homepath->length) {
				$home = trim($homepath->item(0)->nodeValue);
			}

// 処理しない場合
			if((($datevalue != "" || !ereg("[0-9]{2}\/[0-9]{2}", $datevalue)) && $home == "") || ($home == "ホーム")) {
				continue;
			}

// ここで、日付、キックオフ時間、ホームを設定する。
			$data['date'] = $date; 
			$data['kickofftime'] = ereg("[0-9]{2}:[0-9]{2}", $kickofftime)?$kickofftime:'';
			$data['home'] = $home;
			
			// スコア
			$scorepath = $xpath->query("td[@width='62' and @align='center']/font[@size='+0']", $node);
			if($scorepath->length) {
				$score = trim($scorepath->item(0)->nodeValue);
				$data['score'] = $score!='vs'?$score:null; // スコアが設定されていたら収納
			}
			
			// アウェイ
			$awaypath = $xpath->query("td[@width='69']/font[@size='+0']", $node);
			if($awaypath->length) {
				$data['away'] = $awaypath->item(0)->nodeValue;
			}
			// 競技場
			$placepath = $xpath->query("td[@width='62' and @align='left']/font[@size='+0']", $node);
			if($placepath->length) {
				$data['place'] = $placepath->item(0)->nodeValue;
			}
			// 備考
			$notepath = $xpath->query("td[@width='275']/font[@size='+0']", $node);
			if($notepath->length) {
				$data['note'] = $notepath->item(0)->nodeValue;
			}
			
			// 試合後とに配列へ代入
			$sec['match'][] = $data;
		}
		
		// 最後の試合を処理
		if(count($sec['match']) > 0) {
			$secdata[] = $sec;
		}
		
		$this->result['year'] = $this->year;
		$this->result['league'] = $this->league;
		$this->result['count'] = count($secdata);
		$this->result['sec'] = $secdata;
		return true;
	}
	
	/**
	 * 結果を返す
	 */
	public function getResult()
	{
		return $this->result;
	}
	
	/**
	 * JSON形式で返す
	 */
	public function getJSON()
	{
		// JSONに変換して返す
		return json_encode($this->result);
	}
	
	/**
	 * XML形式で返す
	 */
	public function getXML()
	{
		require 'XML/Serializer.php';
	
		// XML_Serializerの設定	
		$options = array(
			"mode" => "simplexml" ,
			"indent"    => "\t",
			"linebreak" => "\n",
			"typeHints" => false,
			"addDecl"   => true,
			"encoding"  => "UTF-8",
			"rootName"  => "JLeagueSchedule",
			"rootAttributes" => array('version' => '1.0'),
			"defaultTagName" => "item",
			"attributesArray" => "_attributes"
		);
		
		// XML_Serializerを生成
		$serializer = &new XML_Serializer($options);
		
		// 結果をXMLへ
		$serializer->serialize($this->result);
		
		// 変換後の値を返す
		return $serializer->getSerializedData();
	}
}
?>

で、このクラスを使ってる、APIの呼び出し先のPHPコードがこちら。

JleagueAPI.php

APIサンプル

このAPIの使い道として想定しているのは、ブログパーツを作ったり、Googleガジェットにしてみたりってのを考えています。

作っただけでは、なんなのでサンプルを作ってみました。APIをAjaxで呼び出して結果を表示するものです。今回も、JQueryを使用しています。

まずは、表示するHTMLのソース。

jleaguesearch.html

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html lang="ja" xml:lang="ja" xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8" />
<meta name="generator" content="HeTeMuLu Creator Ver.1.10a" />
<style type="text/css" media="screen">
* {
	font-family: verdana ,arial ,san-serif;
    font-weight: normal;
}

#result {
}

#result .loading {
	text-align:center;
}

#jleague {
	margin-left: 40%;
}

.header {
	background-color: #c0c0c0;
}

.odd {
	background-color: white;
}

.even {
	background-color: #e0e0e0;
}

.date {
	width: 40px;
	text-align: left;
}

.kickofftime {
	width: 40px;
	text-align: left;
}

.home, .away {
	width: 60px;
	text-align: center;
}

.place {
	width: 60px;
	text-align: left;
}
</style>

<body>
<div id="forms" style="text-align:center;">
<form method="get" action=""><p>
<label>年</label><input type="text" name="year" id="year" value="" />
&nbsp;&nbsp;
<label>リーグ</label><select name="league" id="league">
<option value="j1">J1</option>
<option value="j1-1">J1 1st</option>
<option value="j1-2">J1 2nd</option>
<option value="j2">J2</option>
<option value="ync">ナビスコカップ</option>
</select>
</p>
<p>
<input type="submit" value="検索" />
</p>
</form>
</div>

</body>

</html>

JQueryを使ったAjaxのコードです。

jleaguesearch.js

/* 
 * $Id: jleaguesearch.js 458 2008-02-22 03:52:32Z koichi $
 */

$( document ).ready( function(){
	$( 'form' ).submit( function(){
		jsonp_request();
		return false;
	});
});

/* 
 * jsonを処理する
 */
function jsonp_request()
{
	// APIのURLを生成
	var url = "http://labs.s-koichi.info/jleague/jleagueAPI.php?" 
		+ '_render=json'
		+ '&_callback={callback}'
		+  '&year=' + $( 'form > p > input[@name=year]').val()
		+  '&league=' + $( 'form > p > select[@name=league]').val();

// 結果を一旦空に
	$( '#result' ).empty();
	// イメージ表示
	$( '#result' ).append( '<div class="loading"><img src="images/nowloading.gif" width="32" height="32" border="0" /></div>' );

// APIを呼んで、JSONPを処理	
	$.getJSONP(url, function(tree) {
		// 結果を空にする。
		$( '#result' ).empty();
		// 件数が0だったら終了
		if(tree.count == 0) {
			return;
		}
		// table作成
		$( '#result' ).append( '<table id="jleague" border="0"></table>' );
	
		var i = 0;
		var sec = '';
		var date = '';
		$( tree.sec ).each( function () {
			line = '<tr class="header">';
			if( this.sec != sec ) {
				sec = this.sec;
				date = '';
				line += '<td class="sec" colspan="6">' + sec + '</td>';
			}
			else {
				line += '<td></td>';
			}
			line += '</tr>';
			$( line ).appendTo( '#jleague' );
			
			$( this.match ).each( function () {
				line = '';
				if((i % 2) == 0) {
					line += '<tr class="even">';
				}
				else {
					line += '<tr class="odd"';
				}
				if(date == '' || date != this.date) {
					date = this.date;
					line += '<td class="date">';
					if(date != null) {
						line += date;
					}
					line += '</td>';
				}
				else {
					line += '<td></td>';
				}
				line += '<td class="kickofftime">' + this.kickofftime + '</td>';
				line += '<td class="home">' + this.home + '</td>';
				line += '<td class="vs">';
				line += (this.score)?this.score:'vs';
				line += '</td><td class="away">' + this.away + '</td>';
				line += '<td class="place">' + this.place + '</td>';
				line += '</tr>';
				$( line ).appendTo( '#jleague' );

i++;
			});
			
		});
	});
}

サンプルは以下のリンクから見れます。