これは「APIって何？　どんな役に立つの？」と思っている、APIをよく知らない人に向けた紹介記事です。

APIとは、かいつまんで言えば「よそが提供しているデータを受け取るための仕組み」です。

おおまかすぎて厳密な定義としては間違っているかもしれないですが、利用者としてはそのように認識しておけばOKです。


では世の中にはどんなAPIがあるのでしょう？

どんな役に立つのでしょう？


よく使われていて、おそらく誰でも見たことがあるのが「google map」のAPIでしょう。

「google map」といえば、スムーズな画面遷移で人気になった地図データサービスですが、こちらの一部だけをはりつけたページをよくみかけますよね？

あれは「google map」のデータの一部を借りて自分のサイトに貼り付けているのです。

こうしたデータの一部を提供する仕組みがAPIです。

参考：Google Maps API ファミリー


データを持っている大きな企業・団体があり、その他の企業や個人がそのデータを借りて、自分のサイトに表示する。

その仲立ちのシステムがAPIであると言えるでしょう。


データが保存してあるサーバーがあり、ここにリクエストを送る（例えば東京都新宿区の地図データをください！）と、サーバーから「ほらよ」とデータが送り返されてきます。

それを受け取って、自分のサイトに表示するコードを埋めこむと、あら不思議、地図がバーンと表示できてしまいます。


このようにしてよそがこしらえたデータを借りて自分で使えるのがAPIです。


地図を具体例として出しましたが、例えば旅行サイトの「じゃらん」はホテルの詳細な情報を提供していますし、最近では「Yahoo!」が電力使用状況のデータのAPIを提供したりしています。


こういったデータをどう使いこなすかというと、地図データであれば自分のオフィスや店舗のアクセス情報の一部として使うというのが一般的ですね。

こういった用途は多いから「google map」のデータはよく使われているわけです。


地域情報を乗せているサイトであれば、レストラン（ホットペッパーのAPI）の情報を乗せてみたり、ホテルの情報を乗せてみたりといった使い方があります。

元々自分の持っているサイトと関連性の高い情報を使用するのが活用のコツです。

そうすることでサイトのコンテンツを増加できますし、また広告掲載に用いて収入源とすることもできます。

参考：じゃらんWebサービス
　　　　リクルートWEBサービス
　　　　Yahoo!デベロッパーネットワーク – 震災関連情報 - 電力使用状況API

yahoo!が東京電力の使用状況APIを公開しています。

電力使用状況API

こちらを使えば、電力の使用量や最大供給量などのデータを取得できます。

データはxml, php, jsonで取得できます。

早速簡単な表示ページを作ってみました。


■現在の電力状況

※文字化けする場合はブラウザの文字コードをUTF-8にしてください


ソースコードはこんな感じです。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

<?php
 
//アプリケーションIDの入力
$key="アプリケーションIDを入力してください";
 
//APIへのリクエストURL
$url = "http://setsuden.yahooapis.jp/v1/Setsuden/latestPowerUsage?appid=" . $key;
 
//xmlを取得し、連想配列に格納（php, jsonも指定可能）
$fget = file_get_contents($url);
$xml = simplexml_load_string($fget) or die("パースエラー");
 
//使用量・最大供給量を万kwに変換
$siyou = ($xml->Usage / 10000);
$kyokyu = ($xml->Capacity / 10000);
 
//使用率を四捨五入
$siyouristu = round($siyou / $kyokyu * 100);
 
//データを出力
echo '電気使用量 / 最大供給量　' . $siyou . '万kw /' . $kyokyu . '万kw<br><br>';
echo '使用率　' . $siyouristu . "%<br><br>";
echo '集計日時　' . $xml->Date . ' ' . $xml->Hour . '時現在';
 
?>

「じゃらん」のAPIを使ったサイトを作ってみました。

APIから特定地域のホテル情報を呼び出し、一覧にして表示、そして「個別のホテルの詳細を紹介したページ」や、「じゃらんの詳細ページ」にリンクしています。

京都駅近くの人気ホテル・ビジネスホテルガイド


エリアは「京都駅周辺」というのがあったので、そこを使ってみました。

ホテルの表示件数は50を上限にして、50未満の場合はその分だけを表示するようにしています。

10件ごとのページ遷移だとか、キャッシュ処理とか、個別ページの「google map API」の実装とか残っているのですが、まあとりあえずで。

早急にキャッシュは実装したいのですが、PHPのpearがさくらインターネットのサーバーで使えるのか調べ中です。


ページ遷移とか地図は後回しでもいいかな、という感じです。

じゃらんのAPIで出力される緯度経度の仕様を、日本のものから海外共通のものにしないといけないらしいのですが、そのあたりの処理がいまいちよくわかりません。

郵便番号入力したら勝手に表示してくれるとかなら楽でいいんですけどね！

ジオコーディングというのを使えばいけるらしいのですが、どれが一番簡単なのかいまいちよくわからないので、とりあえず保留です。


まあともかく、この「じゃらんAPI」を使えば、多数のエリアごと、条件ごとのホテルサイトが作り放題のようです。

写真が豊富で、宿泊プランのデータもひっぱってこれますので、サイトのコンテンツもわりかし作りやすそうです。

ちなみに個別ページはこちらです。

天然温泉　花蛍の湯　ドーミーインＰＲＥＭＩＵＭ京都駅前


ちゃんと検索エンジンに引っかかるのかどうかも検証しようと思っています。