ピコツイ!

ピコツイステータス フォーマット仕様書

Version 0.91 2010-08-29

ピコツイステータス

ピコツイから送られるTweet(picotwi)には、Tweetの内容をウィジェット等で利用することができる様に、 「ピコツイステータス」が付けられています。
Tweetの最後に、"[ST:xxx GH:xxxxxx ...]"の様な形で付けられた文字列が、ピコツイステータスです。
このピコツイステータスを、取得して処理することによって、自分のブログに、自分が今、起きているか寝ているかを表示するウィジェットを張り付けたり、自分がつぶやいた場所を地図上に表示するウィジェットを作成したりすることができる様になっています。

ラベル

ピコツイステータスは、「ラベル」とその値が1つ以上集まったものです。ラベルと値は':'で区切られ、ラベルと値の組は' '(スペース)で区切られます。
付けられるラベルは、Tweetの内容によって異なりますが、「ST」というステータスの種類を表すラベルは、全てのpicotwiに必ず付いています。
以下に、ラベルの一覧を示します。ラベルは順次、追加されていきます。
ピコツイステータス ラベル一覧表
ラベル 内容 対応するピコツイ 備考
ST ステータス 全て ピコツイの内容ごと割り当てられたコード
GH GeoHash 位置情報が付いたピコツイ 位置情報をGeoHash形式にしたもの
GF 位置情報取得後経過秒数 位置情報が付いたピコツイ 位置情報が「新鮮」な時、取得後の経過秒数
SL 睡眠時間 GDMNG 睡眠時間(hour)
WU 活動時間 GDNGT 活動時間(hour)
TS タイムスタンプ (未使用) 時刻を表現するのに使用する予定
KR おみくじの結果 おみくじ おみくじの種類ごとに定めた結果コード
PP ピコツイポイント 全て これまでのピコツイによって蓄積された経験値

ステータスの種類

現在、以下の様なステータスが定義されています。
ピコツイステータス コード一覧表
分類 ステータスコード 説明
イベントと記念日 FIRST ピコツイをはじめたことを知らせるTweetです。ピコツイへのリンクが入ります。
イベントと記念日 EV001 精霊流しスペシャル「精霊流し」のTweetです。
イベントと記念日 EV002 精霊流しスペシャル「爆竹」のTweetです。
イベントと記念日 EV003 精霊流しスペシャル「夜火矢」のTweetです。
イベントと記念日 BRTDY 自分の誕生日を祝うTweetです。
天気・天候 WTFNE 天気「晴れ」
天気・天候 WTCLD 天気「くもり」
天気・天候 WTRAI 天気「雨」
天気・天候 WTHRA 天気「大雨」
天気・天候 WTSNW 天気「雪」
天気・天候 WTTND 天気「雷」
天気・天候 WEHOT 暑さを訴えたい時のTweetです。
天気・天候 WEVHT すごい暑さを訴えたい時のTweetです。
あいさつ GRHDY お元気ですかという問いかけのTweet。
あいさつ GRYRH よるほーのあいさつです。
あいさつ GOOUT おでかけのあいさつTweetです。
あいさつ CBHME 家に帰ってきた時のTweetです。
食事 HNGRY おなかがすいた時用のTweetです。
食事 ETBFT 朝食を食べるときのTweetです。
食事 ETLNC 昼食を食べるときのTweetです。
食事 ETDNR 夕食を食べるときのTweetです。
食事 ETNFD 夜食を食べるときのTweetです。
食事 ETALC お酒を飲んでいるとき用のTweetです。
身体と健康 GDMNG おはようのTweetです。睡眠時間が表示されます。
身体と健康 GDNGT おやすみのTweetです。活動時間が表示されます。
身体と健康 NGSLP 眠れない時のTweetです。
身体と健康 NGWUP 眠い時のTweetです。
運勢や今日のラッキーカラーなど KJ002 今日の運勢をTweetします。
運勢や今日のラッキーカラーなど KJ001 今日のラッキーカラーをTweetします。
位置情報付きツイート GPNOW 現在地を知らせるTweetです。
位置情報付きツイート GPALV 現在地に到着したことを知らせるTweetです。

ピコツイステータスの抽出

ピコツイステータスを得るには、Twitter APIでタイムラインを取得し、Tweetのsourceが、'<a href="http://picotwi.com/'から始まるものを選択します。
この方法によって、ピコツイステータスの様に見える、他の文字列を取り込んでしまうことを簡単に避けることができ、 ラベルやステータスが追加された際にもプログラムに手を加えることなく、取り込みが可能になるでしょう。

JavaScript用ピコツイライブラリ

ピコツイステータスを取得するためのライブラリが用意されています。
libPicotwi.jsを使ってください。
使い方は以下の様になります。
<script type="text/javascript" src="/s/js/lib/0/libPicotwi.js" charset="utf-8"></script>
<script type="text/javascript">
var lib = com.picotwi.libPicotwi.constructor();
lib.getUserTimeline({ screen_name: 'TwitterScreeName', callback: function(objTweets) {
    var objPicotwi = lib.selectPicotwis(objTweets);
    ...do anything...
}});
</script>
詳しくは、libPicotwi.jsをお読みいただくか、 ウィジェットの紹介にあるウィジェットのソースを参考にして下さい。
トップへ
ウィジェットの紹介 ライブラリを使用したウィジェットやアプリを紹介しています。