STUDIO KINGDOM

前回の「Windows + Xampp環境にAkelosのscaffoldを構築してみる(2)」からの続きです。
ちなみにこの記事はAkelos公式サイトの解説動画を参考にしています。

1).エラー判定を実装

scaffoldを作って一通りのCRUDを確認しましたが、もう少し実用的にするためにTitle項目に必須エラー判定を実装します。app/models/post/post.phpにvalidate関数を実装します。

<?php
class Post extends ActiveRecord
{
	function validate()
	{
    	$this->validatesPresenceOf('title');
	}
}
?>

画面を開き、Titleを空にして登録、または更新をしてみましょう。次のようにエラーメッセージが表示され、処理が中断されます。

2).ViewファイルのRails形式とPHP形式について

AkelosではViewファイルをRails形式に書くこともできるようです。次のコマンドをscriptフォルダからコマンドプロンプトで実行してください。

php generate scaffold Post Blog --force --sintags

Viewファイルが書き換えられます。例として変更前と後のソースを下記に載せておきます。

書換前

<td class="operation"><?php  echo  $blog_helper->link_to_show($post)?></td>
<td class="operation"><?php  echo  $blog_helper->link_to_edit($post)?></td>
<td class="operation"><?php  echo  $blog_helper->link_to_destroy($post)?></td>

書換後

<td class="operation"><%= link_to_show post %></td>
<td class="operation"><%= link_to_edit post %></td>
<td class="operation"><%= link_to_destroy post %></td>

公式の解説動画ではRails形式で解説を続けていますが、このブログではphp形式で解説を進めてみます。
もう一度次のコマンドを実行して、Viewファイルをphp形式に直します。

php generate scaffold Post Blog --force

3). viewファイルをブログ風に書き直していく

app/views/blog/listing.tplをブログ風になるように次のように書き換えます。

<div id="sidebar">
	<h1>_{Tasks}:</h1>
	<ul>
		<li><?php  echo  $url_helper->link_to($text_helper->translate('Create new Post'), array('action' => 'add'))?></li>
	</ul>
</div>

<div id="content">
	<h1>_{The Akelos Blog}</h1>
	{?posts}
		{loop posts}
		<hr />
		<h2><?php echo $url_helper->link_to($post->title, array('action'=>'show', 'id'=>$post->id)); ?></h2>
		<p>{post.body}</p>
		<p><small></small>{post.posted_at}<?php echo $blog_helper->link_to_edit($post); ?></p>
		{end}
	{end}
</div>

ページを開くと次のように変更されているのが、確認できると思います。

更にapp/views/blog/show.tplを次のように書き換えてみます。

<div id="sidebar">
<h1>_{Tasks}:</h1>
<ul>
	<li><?php  echo  $url_helper->link_to($text_helper->translate('Edit this Post'), array('action' => 'edit', 'id'=>$post->getId()))?></li>
	<li><?php  echo  $url_helper->link_to($text_helper->translate('Back to overview'), array('action' => 'listing'))?></li>
</ul>
</div>

<div id="content">
	<h1>_{Posts}</h1>
	<div class="show">
	<hr />
	<h2><?php echo $url_helper->link_to($post->title, array('action'=>'show', 'id'=>$post->id)); ?></h2>
	<p><?php echo $text_helper->textilize($post->body); ?></p>
	<p><small>{post.posted_at}<?php echo $blog_helper->link_to_edit($post); ?></small></p>
</div>

text_helperのtextilizeを使うことで、Wikiのように強調や斜体で文字を飾りつけることができるようになります。下記の例のように入力を行い、show画面で確認してみてください。（ただし、日本語には対応できていないようです。）

次回に続きます。

最近の携帯電話には、GPS機能がついていますが、この機能とGoogle MapのAPIを使って現在の地点を地図上で知ることが出来るサービスを作ることができます。

Google MapのAPIは以前は対象をPCのみとしていたようですが、2008年の2月に携帯にも対応したAPIを発表したようです。使い方はいたってシンプルで、imgタグのsrc要素に指定されたURLと経度・緯度・APIキーなどの情報をGET形式で指定するだけです。詳しくはke-tai.orgさんのサイトをご覧ください。

ke-tai.org > Blog Archive > 「Google Static Maps API」を使って携帯でGoogleマップを表示する

ただし、Googleに渡すデータの経度・緯度情報は世界標準の形式で無ければいけないのに対し、日本の携帯のGPSは日本独自の形式で経度・緯度情報を出力するため、これを世界標準の形式に変換する作業が必要になります。具体的には、下記の作業が必要になります。

1. (日本)60進法 ⇒ (世界)10進法
2. (日本)日本測地系 ⇒ (世界)世界測地系

これらの変換作業について説明する前に、まずは経度と緯度について詳しく知っておくと良いでしょう。何故、経度や緯度は角度で表現されるのかご存知ですか？管理人は恥ずかしながら今まで知りもしなかったし、何故角度で表すのか疑問に思うこともありませんでした。やはり、何事にも「何故？」と疑問を持って検証するって大切ですね。下記の企業様のサイトが非常に分かりやすいです。

経度緯度とは？

緯度経度とは？ | GIS用語集 | GIS用語集と使い方 | 株式会社パスコ

ざっくり説明すると、緯度は赤道と地球(球体)の中心を通る面を0度、北極・南極と地球の中心を通る面を90度とし、これらを基準にして対象となる場所が何度になるかということですね。経度は旧グリニッジ天文台跡（ロンドン）を通る南北の線、初子午線が基準になるようですね。簡単に日本を表してみました。

60進法と10進法

日本は角度の小数点以下を60進法で表します。何故なんでしょう・・・。Google APIに渡す値は10進法にしなければならいので、60進法に変換します。変換の計算式はF.Ko-Jiさんのブログが参考になります。

経度・緯度を60進法から10進法へ変換 – F.Ko-Jiの「一秒後は未来」

日本測地系と世界測地系

日本の携帯は日本測地系を基準にしているのに対し、Google APIは世界測地系を基準としています。日本測地系のまま、値を渡してしまうと国内で400mほどの誤差が生じてしまうようです。詳しくは下記サイトをご覧ください

日本測地系と世界測地系

GPSにとって400mは結構な誤差なので、これも変換する必要があります。三角関数を使用しない簡単な方法が下記サイトにて紹介されています。

02 DATUM 測地系の変換方法

各キャリアの違い

最後にキャリアの違いについて。これは、PHPプロ！さんのサイトに詳しい情報が載せられています。どのキャリアも特定のリンクにアクセスさせた後、GET値にてGPS情報を提供してくれるようです。auとDoCoMoは経度と緯度をそれぞれ「lat」「lon」で、softbankとWillcomは「pos」に「N**.**.**.**E***.**.**.**」形式で、返してくれるようです。

PHPプロ！TIPS+ 携帯電話でGPSデータを取得してみよう

まとめ

携帯電話のGPS機能とGoogle Map APIを組み合わせて、携帯画面に現在地点の地図を表示するまでの手順を下記にまとめます。

1. 各キャリア別にGPS取得のリンクを表示させて、そのリンクにアクセスさせる。
2. リンクにアクセスするとGET変数でGPS情報の値を取得できるので、経度、緯度の2つの情報をそれぞれ変数に格納する。
3. 60進法を10進法に変換する。
4. 日本測地系を世界測地系に変換する。
5. 経度・緯度の情報をAPIキーと一緒に、Google Map APIに渡して、地図画像を表示する。(centerに経度・緯度情報を指定しますが、markerもcenterと同じ値を指定すればよいでしょう。）

前回の「Windows + Xampp環境にAkelosのscaffoldを構築してみる(1)」からの続きです。
ちなみにこの記事はAkelos公式サイトの解説動画を参考にしています。

1). モデルを自動生成

前回、コントローラーを生成したのと同じようにscriptフォルダから下記のコマンドを実行してModelを生成します。(上手くいかない場合は、最後に–forceを付けて実行してください。)

php generate model Post

下記のようにファイルが作成されます。

2). インストーラーを実行して、テーブルを作成

先ほどの作業で生成されたpost_installer.phpを使ってテーブルを作成します。
/app/installers/post_installer.phpを下記のように書き換えてください。

<?php
class PostInstaller extends AkInstaller
{
    function up_1()
    {
        $this->createTable('posts', "
            id,
            title
        ");
    }

    function down_1()
    {
        $this->dropTable('posts');
    }
}
?>

次に下記のコマンドを実行します。

php migrate post install

SQLが実行され、postsテーブルが作成されます。

3). scaffoldを実行

ここでようやくscaffoldの出番です。下記のコマンドを実行してください。

php generate scaffold Post Blog --force

ここでも自動的にファイルが生成され、scaffoldが構築されます。早速、ブラウザで確認してみましょう。
URLに「http://localhost/blog/」と打ち込んでアクセスすると、下記のような画面が表示されると思います。

「Create new Post」のリンクをクリックすると編集画面が表示されます。

また、「Back to overview」で戻れば、登録した情報が一覧表示され、参照／編集／削除も自由に行うことができます。

3). カラムを追加する

postsテーブルにカラムを追加します。/app/installers/post_installer.phpを開いて、up_1ファンクションの下に下記のup_2ファンクションを追加してください。

    function up_2()
    {
        $this->addColumn('posts', 'body text');
        $this->addColumn('posts', 'posted_at');
    }

先ほどと同じようにinstallコマンドを実行します。

php migrate post install

テーブルに新たにbodyカラムとposted_atカラムが追加されたことを確認してください。ちなみにカラム名に_atをつけるとDate型扱いになるようです。

続いて、scaffoldも再度実行します。

php generate scaffold Post Blog --force

「http://localhost/blog/」をリロードすると、新しい項目が増えていることが確認できると思います。

公式サイトの解説動画では、Mysqlのツールを使ってpostsテーブルのposted_atカラムをbodyカラムの前に移動することで、画面に表示される順番も変更されることが説明されています。phpmyadminで、同じことが出来ないか調べてみましたが、どうやらそのような機能は無いようです。

また、テーブルのカラムの順序を変更する方法は、既存のテーブルを順序を変更した状態でコピーし、古いテーブルを削除、コピーしたテーブルを元の名前にリネームといった手順を踏まなければならないようです。（MySQL :: MySQL 4.1 リファレンスマニュアル :: A.7.2 テーブルのカラム順序を変更する方法を参照。）

このブログでのakelosのscaffoldの説明は以上ですが、解説動画では更にコメント機能をつけるなどしてブログを構築していきます。気が向いたら、続きを書こうと思います。