Lightiweight Google Maps の API 解説

●●概要●●

  Lightweight Google Maps が内部的に持っている API の解説です。ウェブログで登録
した位置情報を他のアプリケーションで活用することができます。具体的には、位置情報
の絞り込み条件をつけて API を呼び出すと、希望するフォーマットで位置情報が返され
るという仕組みです。

(絞り込み条件)

・最近 nn 件の位置情報
・カテゴリー ID: nn に属する記事にある位置情報
・日付 YYYY-mm-dd に投稿された記事にある位置情報
・範囲 (y1, x1, y2, x2) にある位置情報 (y1,x1 は南西の緯度・経度、y2,x2 は北東の
  緯度・経度)

(出力フォーマット)

・独自 XML 形式 (プラグイン内部で利用)
・KML 形式 (Google Earth などで利用可能)

●●アクセス方法●●

  API 本体はプラグインのディレクトリーにある locations.php ファイルです。このフ
ァイルを HTTP で直接呼び出せば OK です。絞り込み条件は GET パラメーターとして付
与します。

  http://example.jp/ がウェブログの URL で、プラグインのディレクトリー名がデフォ
ルトのままとすると、API の URL は
    http://example.jp/wp-content/plugins/lightweight-google-maps/locations.php 
となります。絞り込み条件はその後ろに ? を置いて記述します。

?format=kml&recent=100
    最新100地点を KML で出力
?format=kml&category=2
    カテゴリー ID: 2 の記事に登録された位置情報を KML で出力
?format=kml&date=2007-02-24
    2007年2月24日に投稿された記事の位置情報を KML で出力
?format=kml&bounds=y1,x1,y2,x2
    y1,x1,y2,x2 で示される範囲にある位置情報を KML で出力。

●●KML の使い方●●

  ウェブブラウザーで上記のような URL にアクセスすると、KML ファイルが保存される
はずです (ファイル名はブラウザーによって異なります)。手動で kml という拡張子を補
ったり、ファイル名を適宜変更してください。
  これを Google Earth に読み込ませると、自動的にすべての位置がちょうど入るような
拡大率で閲覧できるでしょう。

  API アクセス用の URL を、KML を解釈するウェブサービスに読み込ませる方法もあり
ます。例えば、Google マップの検索フィールドに API アクセス用 URL を記入してみる
と、左側に場所リストが出て、右側の地図にはマーカーが打たれた画面になるはずです。
ただし、Google マップは最大50件しか位置情報が扱えませんので、ご注意を。

  他にも、KML の楽しい使い方があれば、作者まで連絡をお願いしますです。

●●注意事項●●

・プラグインを停止すると API も停止します。
・API は第三者からのアクセスも受け付けます。すなわち、本プラグイン (のバージョン 
  0.9.8 以降) を設置した場合、自分がウェブログに登録した位置情報に、第三者が簡単
  にアクセスできることを意味します。
・API に対するアクセス制限を設ける機能 (プラグイン内部からのアクセスのみ許容し、
  第三者からのアクセスを拒否する等) は、将来実装することを検討しています。
・とはいえ、本プラグインを設置した時点で、位置情報が全世界に公開されているわけで、
  API だけ制限してもあまり意味がないかもしれません。ウェブサイトのクロールソフト
  を使えば、API を使わなくても位置情報をごっそり取得することは可能ですから。

以上
