本エントリでは、「ひとくち予報 in Feed」を利用するための設定項目やエスケープキャラクタについて解説します。
目次
設定画面
「ひとくち予報 in Feed」設定画面 |
位置指定の方法
天気情報を参照する地点をどう設定するかを決めます。クリックすると「指定方法リスト」が表示されますので、指定方法をクリックして選んでください。
「指定方法リスト」 |
都市名
都市名リスト |
いずれかの都市名をクリックすると、その地点の天気情報データの取得が即座におこなわれます。また[設定しない]を選択すると、天気情報取得のためのネットワークアクセスが一切おこなわれなくなります。
[緯度と経度]には、選ばれた地点のものが自動的に設定されます。
緯度と経度
緯度と経度による位置指定 |
これは、入力した緯度・経度に最も近い地点を探索して、そこに設定する方法となります。
[都市名]には、探索された地点のものが自動的に設定されます。
更新間隔
何時間ごとに天気情報データの取得をおこなうかを設定します。クリックすると、以下のようなリストが表示されますので、お好みの時間を選んでください。
更新間隔時間リスト |
各時間を選んだ場合の実際の更新時刻は以下のようになります。
- 1時間:毎時0分
- 2時間:0, 2, 4, 6, 8, 10, 12, 14, 16, 18, 20, 22時0分
- 3時間:0, 3, 6, 9, 12, 15, 18, 21時0分
- 6時間:0, 6, 12, 18時0分
天気情報の種類と時間属性
天気情報は、種類(天気概況文、予想最高気温、予想降水確率、...)と時間属性(7日間すべて、今日、明日以降のある日)をもっており、その組み合わせによって、様々な表現が可能となっています(例:7日間全部の予想降水確率、今日の最高気温、明日の天気概況文、...)。
「明日以降のある日」の指定方法
「%I%」のように展開文字を1つだけ記すと『明日(今日の1日後)』、「%II%」2つ続けて記すと『明後日(今日の2日後)』、というように指定します。最大で5つまで続けて記すことが可能で、6つ以上続けて記しても『今日から5日後』を指定したものと解釈されます。
「7日間すべて」という時間属性に関する注意点
「ひとくち予報 in Feed」では、気象庁から発表される天気予報を基にして(基本的に)1日3回(05時・11時・17時から1時間程度のあいだに)データが更新されており、発表当日から始まる7日間の天気情報が含まれています。
例えば、12月11日に提供されるデータには、[12/11, 12/12, 12/13, 12/14, 12/15, 12/16, 12/17]の天気情報が含まれていることになります。
なので、12月11日05時から24時までなら、
- 一番最初(例:12/11)のデータは『今日』
- 二番目(例:12/12)のデータは『明日』
- 三番目(例:12/13)のデータは『明後日』
ところが、深夜24時を過ぎた12月12日00時から05時までのあいだは、前日(12月11日)17時に提供されたデータしかありませんので、
- 一番最初(例:12/11)のデータは『今日』ではなく『昨日』
- 二番目(例:12/12)のデータは『明日』ではなく『今日』
- 三番目(例:12/13)のデータは『明後日』ではなく『明日』
時間属性で「今日」や「明日以降のある日」を対象とする展開文字では、この時間帯によるズレに自動対応しています。しかし「7日間すべて」を対象とする展開文字は、「提供されたデータに含まれるすべての日付」を取り出しているだけですので、先頭が「今日」なのか「昨日」なのかは、現在の時刻を元にユーザー自らが判断する必要があります。
ですので、特段の理由がない限り、「7日間すべて」を対象とする展開文字の使用は控えたほうが懸命でしょう。
エスケープキャラクタと展開文字
天気情報用エスケープキャラクタ「%」で囲まれた文字(展開文字)は、様々な天気情報に展開・表示されます。ここでは、天気情報ソースとして「ひとくち予報 in Feed」を選んだ場合の展開文字について解説します。
「気温」に関する展開文字
h:7日間すべての予想最高気温
7日間すべての予想最高気温が「16,14,18,15,12,14,14」のようにコンマ区切りで表示されます。夕方以降のように、その日の予想最高気温となる時間帯を過ぎてしまった時刻では「--,14,18,15,12,14,14」と先頭が「--」と表示されます。
H:今日の予想最高気温
I:明日以降のある日の予想最高気温
今日および明日以降のある日の予想最高気温が「16」のように表示されます。その日の予想最高気温となる時間帯を過ぎてしまった時刻に「今日の予想最高気温」を展開した場合には「--」と表示されます。
l:7日間すべての予想最低気温
7日間すべての予想最低気温が「9,7,11,8,5,7,7」のようにコンマ区切りで表示されます。明け方以降のように、その日の予想最低気温となる時間帯を過ぎてしまった時刻では「--,7,11,8,5,7,7」と先頭が「--」と表示されます。
L:今日の予想最低気温
M:明日以降のある日の予想最低気温
今日および明日以降のある日の予想最低気温が「9」のように表示されます。その日の予想最低気温となる時間帯を過ぎてしまった時刻に「今日の予想最低気温」を展開した場合には「--」と表示されます。
「降水確率」に関する展開文字
r:7日間すべての全時間帯での予想降水確率
7日間すべての全時間帯での予想降水確率が「--/--/--/10,10/20/40/30, ...」のようにコンマ区切りで表示されます。コンマで区切られた「10/20/40/30」が一日を4等分した各時間帯での予想降水確率になります。現時刻で過ぎてしまった時間帯は「--」と表示されます。
R:現在の時間帯での予想降水確率
今日の現時刻を含む時間帯の予想降水確率が「10」のように表示されます。
S:明日以降のある日の予想降水確率
明日以降のある日の予想降水確率が「20」のように表示されます。一日の4つの時間帯で異なる降水確率が予想されていた場合には、そのうちの最も高い値に代表されます。例えば、ある日の予想降水確率が「10/20/40/30」と予想されていた場合、その日の「%S%」は「40」と表示されます。
「天気概況」に関する展開文字
t:7日間すべての予想天気概況文
7日間すべての予想天気概況文がコンマ区切りで表示されます。これは「ロケール」によって以下のように表示が異なります。また、ロケールが英語の場合、天気概況文にコンマが元々含まれていた場合、それは「_(アンダースコア)」に置換されてから、7日間分がコンマでつながれます。
- 日本語 : 晴時々曇,晴一時雨,...
- 英語 : fine partly cloudy,fine partly rain,...
T:今日の予想天気概況文
X:明日以降のある日の予想天気概況文
今日および明日以降のある日の天気概況文が、「ロケール」が日本語なら「晴時々曇」、英語なら「fine partly cloudy」のように表示されます。
b:7日間すべての予想天気概況番号
B:今日の予想天気概況番号
A:明日以降のある日の予想天気概況番号
今日および明日以降のある日の予想天気概況番号が表示されます。「%b%」では7日間すべての予想天気概況番号がコンマ区切りで表示されます。
天気概況番号は、各天気概況に割り当てられている3桁の番号で、「100」から「450」までの間に121種類あります。番号と概況文の対応は「天気概況文と番号の一覧」を参照してください。
c:7日間すべての予想天気カテゴリ
C:今日の予想天気カテゴリ
D:明日以降のある日の予想天気カテゴリ
今日および明日以降のある日の予想天気カテゴリが表示されます。「%b%」では7日間すべての予想天気カテゴリがコンマ区切りで表示されます。
天気カテゴリは、天気の種類とその関連性を3桁の番号に割り当てたもので、全部で35種類あります。
天気カテゴリの構造は、3桁の番号が
[前部天気分類]+[接続分類]+[後部天気分類]
と対応するようになっています。
[天気分類]は以下の通りです(※ ただし「雷」は後部天気分類にのみ現れる)。
- 0 : なし
- 1 : 晴
- 2 : 曇
- 3 : 雨
- 4 : 雪
- 5 : 雷
[接続分類]は前部と後部の天気の関連性をあらわすもので、以下の種類があります。
- 0 : 接続なし(後部天気は必ず「0」)
- 1 : 「時々」「一時」「伴う」のように、前部天気と後部天気は同時に発生する
- 2 : 「のち」「から」のように、前部天気の後に後部天気に変化する
番号と概況文の具体的な対応は「天気概況文と番号の一覧」を参照してください。
その他の展開文字
p:参照している地点の都市名
P:参照している地点の都道府県名
参照している地点の都市名および都道府県名を表示します。「ロケール」が日本語なら日本語で、英語ならローマ字表記で表示します。
d:7日間すべての日付
天気データ7日間分すべての日付を「yyyyMMdd」という形式で、コンマ区切りで並べたものを表示します。
U:天気データの更新日時
現在持っている天気データが提供された日時を「yyyyMMddHHmm」形式で表示します。
天気概況文と番号の一覧
以下のテーブルに、「ひとくち予報 in Feed」で現れる天気概況番号(%B%)・概況文(%T%)・カテゴリ(%C%)の一覧を記す。
天気概況番号 %B% | 天気カテゴリ %C% | 概況文 %T% | |
---|---|---|---|
日本語 | 英語 | ||
100 | 100 | 晴 | fine |
101 | 112 | 晴時々曇 | fine partly cloudy |
102 | 113 | 晴一時雨 | fine partly rain |
103 | 113 | 晴時々雨 | fine partly rain |
104 | 114 | 晴一時雪 | fine partly snow |
105 | 114 | 晴時々雪 | fine partly snow |
106 | 113 | 晴一時雨か雪 | fine partly rain or snow |
107 | 113 | 晴時々雨か雪 | fine partly rain or snow |
108 | 115 | 晴一時雨か雷雨 | fine partly rain or thunderstorm |
110 | 122 | 晴のち時々曇 | fine, later, partly cloudy |
111 | 122 | 晴のち曇 | cloudy after fine |
112 | 123 | 晴のち一時雨 | fine, later, partly rain |
113 | 123 | 晴のち時々雨 | fine, later, partly rain |
114 | 123 | 晴のち雨 | rain after fine |
115 | 124 | 晴のち一時雪 | fine, later, partly snow |
116 | 124 | 晴のち時々雪 | fine, later, partly snow |
117 | 124 | 晴のち雪 | snow after fine |
118 | 123 | 晴のち雨か雪 | rain or snow after fine |
119 | 125 | 晴のち雨か雷雨 | rain or thunderstorm after fine |
120 | 113 | 晴朝夕一時雨 | fine partly rain on morning and evening |
121 | 113 | 晴朝のうち一時雨 | fine partly rain in morning |
122 | 113 | 晴夕方一時雨 | fine partly rain on evening |
123 | 115 | 晴山沿い雷雨 | fine partly thunderstorm at mountains |
124 | 114 | 晴山沿い雪 | fine partly snow at mountains |
125 | 125 | 晴午後は雷雨 | fine, thunderstorm in pm |
126 | 123 | 晴昼頃から雨 | fine, rain in pm |
127 | 123 | 晴夕方から雨 | fine, later rain from evening |
128 | 123 | 晴夜は雨 | fine, later rain in night |
129 | 123 | 晴夜半から雨 | fine, later rain from midnight |
130 | 100 | 朝のうち霧のち晴 | fine after fog in morning |
131 | 100 | 朝明け方霧 | fine partly fog in morning |
132 | 112 | 晴朝夕曇 | fine partly fog on morning and evening |
140 | 115 | 晴時々雨で雷を伴う | fine partly thunderstorm |
160 | 114 | 晴一時雪か雨 | fine partly snow or rain |
170 | 114 | 晴時々雪か雨 | fine partly snow or rain |
181 | 124 | 晴のち雪か雨 | snow or rain after fine |
200 | 200 | 曇 | cloudy |
201 | 211 | 曇時々晴 | cloudy partly fine |
202 | 213 | 曇一時雨 | cloudy partly rain |
203 | 213 | 曇時々雨 | cloudy partly rain |
204 | 214 | 曇一時雪 | cloudy partly snow |
205 | 214 | 曇時々雪 | cloudy partly snow |
206 | 213 | 曇一時雨か雪 | cloudy partly rain or snow |
207 | 213 | 曇時々雨か雪 | cloudy partly rain or snow |
208 | 215 | 曇一時雨か雷雨 | cloudy partly rain or thunderstorm |
209 | 200 | 霧 | fog |
210 | 221 | 曇のち時々晴 | cloudy, later, partly fine |
211 | 221 | 曇のち晴 | fine after cloudy |
212 | 223 | 曇のち一時雨 | cloudy, later, partly rain |
213 | 223 | 曇のち時々雨 | cloudy, later, partly rain |
214 | 223 | 曇のち雨 | rain after cloudy |
215 | 224 | 曇のち一時雪 | cloudy, later, partly snow |
216 | 224 | 曇のち時々雪 | cloudy, later, partly snow |
217 | 224 | 曇のち雪 | snow after cloudy |
218 | 223 | 曇のち雨か雪 | rain or snow after cloudy |
219 | 225 | 曇のち雨か雷雨 | rain or thunderstorm after cloudy |
220 | 213 | 曇朝夕一時雨 | cloudy partly rain on morning and evening |
221 | 213 | 曇朝のうち一時雨 | cloudy partly rain in morning |
222 | 213 | 曇夕方一時雨 | cloudy partly rain on evening |
223 | 211 | 曇日中時々晴 | cloudy partly fine |
224 | 223 | 曇昼頃から雨 | cloudy, rain in pm |
225 | 223 | 曇夕方から雨 | cloudy, later rain from evening |
226 | 223 | 曇夜は雨 | cloudy, later rain in night |
227 | 223 | 曇夜半から雨 | cloudy, later rain in midnight |
228 | 224 | 曇昼頃から雪 | cloudy, snow in pm |
229 | 224 | 曇夕方から雪 | cloudy, later snow from evening |
230 | 224 | 曇夜は雪 | cloudy, later snow in night |
231 | 200 | 曇海上海岸は霧か霧雨 | cloudy partly fog at shore |
240 | 215 | 曇時々雨で雷を伴う | cloudy partly thunderstorm |
250 | 215 | 曇時々雪で雷を伴う | cloudy partly snowstorm |
260 | 214 | 曇一時雪か雨 | cloudy partly snow or rain |
270 | 214 | 曇時々雪か雨 | cloudy partly snow or rain |
281 | 224 | 曇のち雪か雨 | snow or rain after cloudy |
300 | 300 | 雨 | rain |
301 | 311 | 雨時々晴 | rain partly fine |
302 | 312 | 雨時々止む | rain partly cloudy |
303 | 314 | 雨時々雪 | rain partly snow |
304 | 300 | 雨か雪 | rain or snow |
306 | 300 | 大雨 | heavy rain |
308 | 300 | 雨で暴風を伴う | rainstorm |
309 | 314 | 雨一時雪 | rain partly snow |
311 | 321 | 雨のち晴 | fine after rain |
313 | 322 | 雨のち曇 | cloudy after rain |
314 | 324 | 雨のち時々雪 | rain, later, partly snow |
315 | 324 | 雨のち雪 | snow after rain |
316 | 321 | 雨か雪のち晴 | fine after rain or snow |
317 | 322 | 雨か雪のち曇 | cloudy after rain or snow |
320 | 321 | 朝のうち雨のち晴 | fine after rain in morning |
321 | 322 | 朝のうち雨のち曇 | cloudy after rain in morning |
322 | 314 | 雨朝晩一時雪 | rain partly snow on morning and evening |
323 | 321 | 雨昼頃から晴 | rain, fine in pm |
324 | 321 | 雨夕方から晴 | rain, later fine from evening |
325 | 321 | 雨夜は晴 | rain, later fine in night |
326 | 324 | 雨夕方から雪 | rain, later snow from evening |
327 | 324 | 雨夜は雪 | rain, later snow in night |
328 | 300 | 雨一時強く降る | rain partly storm |
329 | 300 | 雨一時みぞれ | rain party sleet |
340 | 400 | 雪か雨 | snow or rain |
350 | 315 | 雨で雷を伴う | thunderstorm |
361 | 421 | 雪か雨のち晴 | fine after snow or rain |
371 | 422 | 雪か雨のち曇 | cloudy after snow or rain |
400 | 400 | 雪 | snow |
401 | 411 | 雪時々晴 | snow partly fine |
402 | 412 | 雪時々止む | snow partly cloudy |
403 | 413 | 雪時々雨 | snow partly rain |
405 | 400 | 大雪 | heavy snow |
406 | 400 | 風雪強い | snowstorm |
407 | 400 | 暴風雪 | snowstorm |
409 | 413 | 雪一時雨 | snow partly rain |
411 | 421 | 雪のち晴 | fine after snow |
413 | 422 | 雪のち曇 | cloudy after snow |
414 | 423 | 雪のち雨 | rain after snow |
420 | 421 | 朝のうち雪のち晴 | fine after snow in morning |
421 | 422 | 朝のうち雪のち曇 | cloudy after snow in morning |
422 | 423 | 雪昼頃から雨 | snow, rain in pm |
423 | 423 | 雪夕方から雨 | snow, later rain from evening |
424 | 423 | 雪夜半から雨 | snow, later rain in night |
425 | 400 | 雪一時強く降る | snow partly storm |
426 | 400 | 雪のちみぞれ | sleety after snow |
427 | 400 | 雪一時みぞれ | snow partly sleety |
450 | 415 | 雪で雷を伴う | snowstorm |
以上
0 件のコメント:
コメントを投稿