Twitter天気予報BOTマニュアル
概要
Twitterで動く天気予報BOTです。
まずはこの「お天気BOT」をフォローしましょう。
そして「いつ」の「どこ」の天気が知りたいか@発言で問い合わせると
その日の天気と、わかる場合には最高／最低気温を教えてくれます。
（つぶやきを非公開に設定している場合は使用できません。）
使い方
今日の東京都の天気が知りたい場合は、以下のように問い合わせて見ましょう。
@otenki_bot 今日の東京の天気は？
しばらく待つと、以下のようにリプライが返るでしょう。
@NonStopK 東京都 東京 - 今日 - 5月25日（火）の天気は曇時々晴、最高気温は22℃ 最低気温は15℃だー。
上記は文章で問い合わせていますが、「今日東京」だけでも同じ結果が得られます。
また、「いつ」にあたる文字列が未指定の場合は「今日」が予報対象日になるので
「東京」だけでも上記同様の結果が得られます。
[2010/06/27 追加]
日付を指定しても予報できるようになりました。
以下のように問い合わせて見ましょう。
@otenki_bot 27日のさいたまの天気は？
しばらく待つと、以下のようにリプライが返るでしょう。
@NonStopK 埼玉県 さいたま - あさって - 5月27日（木）の天気は曇時々雨、最高気温は22℃ 最低気温は16℃でございます。
予報可能日は、地域にもよりますが2〜7日後程度となります。
月を指定する必要はありません。
指定日が予報可能日の範囲内かどうかのみチェックしています。
もし範囲外ならば、お天気BOTが予報可能な日数を教えてくれるでしょう。
仕様詳細は以下をご参照下さい。
仕様
約1分に1度、自分に対する発言のチェックを行い、問い合わせがあれば順番にリプライします。
- 「いつ」を判別する文字列について
【今日を示す文字列】
今日、きょう、こんにち、本日、ほんじつ
【明日を示す文字列】
明日、あした、あす、みょうにち
【明後日を示す文字列】
明後日、あさって、みょうごにち
[2010/06/27 追加]
【しあさってを示す文字列】
しあさって、明々後日
【やのあさってを示す文字列】
やのあさって、やなあさって、弥の明後日、弥明後日
【日にちを示す文字列】
1日 2日 ... 31日（数字は全角、半角どちらでもOKです。）
- 「どこ」を判別する文字列について
天気予報機能はLivedoor Weather Web Serviceを利用していますので
予報可能な場所については、上記サービスの仕様に準じます。
以下の「全国の地点定義表」リンクを開き、ページのソースを表示させて下さい。
ソース内のcityタグのtitleに書かれた文字列が判別可能な文字列です。
全国の地点定義表
http://weather.livedoor.com/forecast/rss/forecastmap.xml
[2010/06/27 追加]
天気予報RSSフィードから情報を取得するよう変更したので、
最大で7日先の情報を取得することが可能になりました。
予報可能な場所は、下記ページの「今日・明日の天気」項目で
RSSフィードが提供されている地域となります。
Weather Hacks RSSフィード一覧
http://weather.livedoor.com/weather_hacks/rss_feed_list.html
また、各都道府県名を指定すると、都道府県庁所在地の予報を行います。
以下はその一例です。
@NonStopK 愛媛県 松山 - 明日 - 5月26日（水）の天気は曇時々晴、最高気温は24℃ 最低気温は18℃みたいな。
また、少しずつではありますが、主要駅や地名などでも
その地域の予報ができるように対応を進めております。
はじめは予報が上手くいかなくても、根気よく問い合わせていると
それを見たid:NonStopKがその情熱に負けて
思わず対応させてしまうかもしれません。
[2010/06/27 追加]
【非公式RT、QTの扱い】
「@otenki_bot」文字列を含む非公式RT、QTについて、
お天気BOTが反応しないよう変更しました。
ただ、反応してほしいケース、してほしくないケース、どちらもあると思います。
よい反応の仕方があればそのように修正したいとは思っていますが、
仕様がまとまるまではとりあえず無反応とさせて頂きます。
- ちょっとしたオマケ
お天気BOTに予報してもらったらお礼を言ってみましょう。
もしかしたら何らかの反応があるかもしれません。
思いがけない言葉に反応することも！？
- リプライできない場合
問い合わせに対してリプライできない場合があります。
【保留問い合わせが21件以上存在する場合】
短時間で多くの問い合わせを頂き、保留問い合わせが21件以上になってしまった場合
古い問い合わせから順に取りこぼしてしまいます。
最大保留件数は20件までですので、問い合わせが集中しそうな場合は
少し時間をずらしてからお問い合わせ下さい。[2010/06/27 追加]
過去の未取得発言を最大200件まで取得できるよう修正しましたので、
現状の稼動率から考えると取りこぼしは発生しないはずです。
ただし、プログラムにバグがあった場合はこの限りではありません。
このBOTはTwitter APIを使用しています。
通常はAPI制限を越えないように調整してはいますが
何らかの原因でAPI制限に引っ掛かかることがあるかもしれません。
この場合、少し時間をずらしてから問い合わせしてみて下さい。
[2010/06/27 追加]
API制限が解消された時点で
それまでに発生した問い合わせを順番に取得、リプライ処理します。
そのため大幅なリプライ遅延、問い合わせの取りこぼしが発生する場合があります。
【問い合わせ結果が、最近の問い合わせ結果と同じ場合】
Twitterの仕様上、短時間に同じ発言を連続することができません。
お天気BOTが同一ユーザに対して最近のリプライ発言と同じメッセージを生成してしまった場合
リプライできませんのでご了承下さい。
【サーバーエラーレスポンスの場合】
問い合わせ取得、及びリプライ時にサーバーがエラーレスポンスを返す場合があり
この場合はリプライすることができません。
[2010/06/27 追加]
お天気BOTはリプライに成功するまで一定間隔でリトライを行うので、
上記の状態に陥った場合は、状態が解消された瞬間からリプライを再開します。
そのため大幅なリプライ遅延が発生する場合があります。
【つぶやきを非公開に設定している場合】
つぶやきを非公開に設定している場合は、
お天気BOTが問い合わせを取得できないのでリプライすることができません。
[2010/06/27 追加]
potenki_botに関しては現在フォロー返しする余裕がない状況で、
皆様には大変ご迷惑をおかけしております。
[2010/06/27 追加]
【その他の理由】
サーバメンテ、プログラム不具合、停電などさまざまな理由により
お天気BOTの稼働を一時的に停止する場合があります。
（自宅マシンのため、特にハード障害時は再開に時間がかかるかもしれません。）
その際はお天気BOTのつぶやきにて通知させて頂きます。
作成者
このBOTの基本機能の発案、Twitterアイコン、このページトップのイメージ画像作成はid:MameMameです。
オマケ機能の発案、仕様決定、プログラミングはid:NonStopKがJavaで行いました。
[2010/06/27 追加]
TwitterのBASIC認証廃止に伴い、お天気BOTのOAuth認証対応を行いました。
その際に、全てのソースコードを新規で書き直しております。
（理由は単に従来のソースが気に入らなかっただけです。）
なので、一見いつも通りのお天気BOTのように見えますが
もしかしたら突然動かなくなったり意図しない返しをする可能性があります。
その時はごめんなさい。
不具合に気づいたら、できるだけ早く修正するようにします。
最後に
皆様のお役に立てるかどうかわかりませんが、
自分が使ってみて便利だったのでどんどん使っていこうと思っています。
ですが、やはり皆様にも是非使って頂きたく、宜しくお願い申し上げます。
ご意見ご感想はtwitter、もしくは以下の宛先までメールでもOKです。
otenki.bot@gmail.com
nonstopk@gmail.com
