dev.jisaku.mosimo.public.bsaf.hazard

BSAF から災害情報への対応BSAF to hazard · 形式

BSAF v1 投稿を転載するときに、Bot 定義が意味を公開しているタグ値から災害情報の共通拡張・種類別拡張と影響範囲を生成する変換規則を定義する。BSAF の語彙を知らないアプリでも、転載された投稿の種類・深刻度・範囲が分かるようにする。

OVERVIEW / 要点07 PUBLIC INFORMATION
  1. 対象は固定リビジョンの JMA Bot と Kikikuru Bot。対応表にない値は変換しない。
  2. 都道府県単位の投稿だけ、全体を覆う Geohash セルを影響範囲とする。
  3. 震源地名・マグニチュード等は、決まった書式の行に全体一致した場合だけ本文から抽出する。

位置づけ

目的

本プロトコルは、BSAF v1 投稿を転載するときに、Bot 定義が意味を公開しているタグ値から災害情報の共通拡張・種類別拡張と影響範囲を生成する変換規則を定義する。目的は、BSAF の語彙を知らないアプリでも、転載された投稿の種類・深刻度・範囲が分かるようにすることである。

本書は変換規則であり、新しい拡張型を定義しない。識別子は変換規則名として public#source の conversion.rule に記録する。本書の版は 1 である。

保証するのは、同じ原投稿に本書の同じ版を適用した変換者が同じ拡張を生成することである。保証しないのは、Bot 自身が原 XML から付けたタグ値の正しさ、共通値が気象庁の公式な対応であること、本文から抽出した値が原 XML の値と一致することである。対応表は本プロトコルの運用者が Bot 定義と Bot の公開ソースから定めたものである。

前提

識別子 文書 依存する理由
dev.jisaku.mosimo.public.bsaf BSAF v1 互換拡張 原タグ・原本文の保持、転載の経路、対象 Bot
dev.jisaku.mosimo.hazard 以下 災害情報 生成する共通拡張・種類別拡張
dev.jisaku.mosimo.geo 地理情報 target: から生成する近似の影響範囲
dev.jisaku.mosimo.public 公的情報の取り込み 出典拡張 source と変換規則の記録

1. 適用の条件

本書の対応表は、次の Bot と固定リビジョンの Bot 定義・投稿生成コードを対象とする。

Bot DID Bot 定義と投稿生成コードの固定リビジョン
JMA Bot(@jma-alert-bot.bsky.social、非公式) did:plc:vwi7zhfyamyvrg5v6ycjgzxi osprey74/bsaf-jma-bot@98071e7
Kikikuru Bot(@bsaf-kikikuru-bot.bsky.social、非公式) did:plc:kxwz5cz7o6g4jlmxh6doyfsm osprey74/bsaf-kikikuru-bot@76ec562
  • 原投稿の著者 DID が上の表にあり、type: と value: の組が §3・§4 の表にある場合に限り、災害情報の拡張を生成する。それ以外の投稿は、従来どおり BSAF 拡張と原本文だけで転載する。対応表にない値を、似た値の行や英語名から推測して変換してはならない。Bot ごとに同じ文字列が別の意味を持ち得るためである(BSAF 拡張 §5.1)。
  • Bot が定義・生成コードを更新し、タグ値の意味や本文の書式が変わった場合は、本書の新しい版で対応表を改める。版を改めずに対応表を変えてはならない。同じ規則名・版の変換結果が変換者によって異なり、配送同値性の判断を誤らせるためである。
  • 原本文・原タグは BSAF 拡張 §5.2.2 に従いそのまま保持する。本書の拡張は追加であり、本文に追記しない。

2. 共通の規則

2.1 生成する拡張

拡張 生成の条件
dev.jisaku.mosimo.hazard §1 の条件を満たすとき常に
種類別拡張 対応表の「種類別拡張」列が空でないとき
dev.jisaku.mosimo.geo#area §2.3 で範囲を解決できたとき
dev.jisaku.mosimo.public#source 災害情報の拡張を生成したとき常に(§2.5)

validity は生成しない。BSAF の time: は原イベントの時刻であり、有効期間ではないためである(BSAF 拡張 §7)。

2.2 共通拡張の固定値

項目 値
status Actual。BSAF は運用種別を運ばないため、Bot が実情報として投稿したものとして扱う。Kikikuru Bot の固定リビジョンは Control/Status が「通常」以外の電文を投稿しない。JMA Bot の固定リビジョンは運用種別を確認していない(未確定事項)
event 原投稿の type: に対する Bot 定義の表示ラベル(filters[tag=type].options[].label)と lang: "ja"
onset §3 の表で指定した種類だけ、time: の値をそのまま用いる。time: がコア §3.1 の Timestamp として解釈できない場合は省略する
glide 生成しない

2.3 影響範囲

target: が Bot 定義上の都道府県であり、Bot がその都道府県ごとに投稿を分けている場合だけ、prefectures.json の Geohash セルの和集合を approximation: true の geo#area として生成する。

Bot target: の意味 影響範囲
Kikikuru Bot jp-<都道府県>:その都道府県内の発表を集約した投稿 prefectures.json の該当セル
Kikikuru Bot jp:台風等の全国的な情報 生成しない。全国は台風の影響範囲ではないため
JMA Bot 地方名(jp-kanto 等):対象地域のうち最初の地方だけ 生成しない。他の地方を含む情報で最初の地方だけを範囲とすると、範囲外とされた対象地域で配送順位が下がるため(地理情報 §4.3)

prefectures.json は、Natural Earth 1:10m Admin 1(バージョン 5.1.1、パブリックドメイン)の都道府県界を約 5 km 外側へ広げた領域を、Geohash 4 文字(都道府県あたり 64 セルを超える場合は 3 文字)のセルで覆ったものである。Natural Earth で沖縄県に含まれている奄美群島は鹿児島県へ移し、1:10m に含まれない沖ノ鳥島・南鳥島を東京都に加えている。生成手順は appview/bsaf/tools/prefecture_cover.py である。セルの和集合は都道府県より広く、近似に含まれる地点が警報の対象とは限らない。

2.4 本文からの抽出

一部の物理量(震源地名・マグニチュード・火山名・台風の気圧等)はタグになく、本文だけにある。§1 の固定リビジョンの投稿生成コードが決まった書式で出力する行に限り、§5 の正規表現に行全体が一致する場合だけ値を抽出する。一致しない場合はその項目を省略し、投稿の転載は続ける。部分一致や書式の推測で抽出してはならない。書式が変わった本文から誤った値を抽出し、本文と矛盾する構造化値を署名するためである。抽出元の本文は同じ投稿に署名付きで残るため、受信者は照合できる。

本文の行は \n で区切る。全角数字は Kikikuru Bot が半角に正規化しているため、正規表現は半角数字だけを受け付ける。

2.5 出典

{
  $type: "dev.jisaku.mosimo.public#source",
  document: { format: "bsaf-v1", senderId: <Bot の DID>, messageId: <原投稿の at-URI>, sentAt: <原 createdAt> },
  retrievedFrom: <収集に使った Jetstream の URL>,
  retrievedAt: <収集時刻>,
  converter: <転載サーバーの DID>,
  conversion: { rule: "dev.jisaku.mosimo.public.bsaf.hazard", revision: "1" },
}

sentAt は原 createdAt が Timestamp(UTC・末尾 Z)として解釈できる場合だけ、文字列を変えずに置く。

3. JMA Bot の対応表

共通拡張の列は severity / urgency / certainty / responseTypes の順である。「—」は省略を表す。

3.1 地震(type:earthquake)

種類別拡張は hazard.earthquake(kind: "event")、大分類は Geo、onset は time:(発震時刻)とする。

value: 共通拡張 地域スケール
1、2 Minor / Past / Observed / — jp.jma.shindo = 原値、basis: "observed"
3、4 Moderate / Past / Observed / — 同上
5-、5+ Severe / Past / Observed / — 同上
6-、6+、7 Extreme / Past / Observed / — 同上

value: は投稿内の最大観測震度である。Bot は震度速報と震源・震度に関する情報を投稿し、いずれも観測値である。

3.2 津波(type:tsunami)

種類別拡張は hazard.tsunami、大分類は Geo とする。onset は生成しない(time: は発表時刻であるため)。

value: 共通拡張 地域スケール
special-warning Extreme / Immediate / Likely / Evacuate jp.jma.tsunami = major-warning
warning Severe / Immediate / Likely / Evacuate jp.jma.tsunami = warning
advisory Moderate / Expected / Likely / Avoid jp.jma.tsunami = advisory
info Minor / Unknown / Unknown / — —

info には津波予報のほか、Bot が種類コードを判別できなかった電文も含まれるため、地域スケールを生成しない。

3.3 噴火(type:eruption)

種類別拡張は hazard.volcano(phenomenon: "eruption")、大分類は Geo とする。

value: 共通拡張
special-warning Extreme / Immediate / Likely / Evacuate
warning Severe / Expected / Likely / Avoid
advisory Moderate / Future / Possible / Avoid

本文の 1 行目が噴火速報(§5.1)である場合は、certainty を Observed、urgency を Immediate とする。噴火速報は噴火の発生を伝えるためである。噴火警戒レベルは本文から抽出できた場合だけ jp.jma.volcanic-alert-level に置く。value: から噴火警戒レベルを逆算してはならない。Bot はレベル 4 と 5 を同じ special-warning にしているためである。

3.4 降灰(type:ashfall)

種類別拡張は hazard.volcano(phenomenon: "ashfall")、大分類は Geo とする。

value: 共通拡張
advisory Moderate / Expected / Likely / Avoid
info Minor / Future / Possible / —

3.5 南海トラフ地震臨時情報(type:nankai-trough)

種類別拡張は hazard.earthquake(kind: "assessment")、大分類は Geo とする。

value: 共通拡張 地域スケール
special-warning Extreme / Future / Possible / Prepare jp.jma.nankai-trough = alert
warning Severe / Future / Possible / Prepare jp.jma.nankai-trough = caution
advisory Moderate / Future / Possible / Monitor —

advisory は調査中と、Bot がキーワードを判別できなかった電文(調査終了を含む)の両方に使われるため、地域スケールを生成しない。

4. Kikikuru Bot の対応表

4.1 情報種別

type: 大分類 種類別拡張
heavy-rain-warning、heavy-rain、linear-rainband-warning Met hazard.weather、phenomena: ["rain"]
flood-warning Met hazard.weather、["flood"]
landslide-warning Geo hazard.weather、["landslide"]
storm-surge-warning Met hazard.weather、["storm-surge"]
wind-warning Met hazard.weather、["wind"]
wave-warning Met hazard.weather、["wave"]
snow-warning、significant-snowfall-warning Met hazard.weather、["snow"]
tornado-warning Met hazard.weather、["tornado"]
thunderstorm-warning Met hazard.weather、["thunderstorm"]
melting-snow-warning Met hazard.weather、["snowmelt"]
dense-fog-warning Met hazard.weather、["fog"]
dry-air-warning Met hazard.weather、["dry-air"]
avalanche-warning Geo hazard.weather、["avalanche"]
low-temperature-warning Met hazard.weather、["cold"]
frost-warning Met hazard.weather、["frost"]
icing-warning Met hazard.weather、["icing"]
snow-accretion-warning Met hazard.weather、["snow-accretion"]
weather-info Met hazard.weather、[]
typhoon Met hazard.cyclone
other-warning Met なし

wind-warning は暴風・暴風雪・強風をまとめた種別である。暴風雪かどうかはタグから分からないため snow を加えない。

4.2 値

value: 共通拡張 地域スケール
level2 Moderate / Expected / Likely / Prepare jp.jma.warning-level = 2
level3 Severe / Expected / Likely / Prepare jp.jma.warning-level = 3
level4 Extreme / Expected / Likely / Evacuate jp.jma.warning-level = 4
level5 Extreme / Immediate / Likely / Shelter jp.jma.warning-level = 5
advisory Moderate / Expected / Likely / — jp.jma.warning-class = advisory
warning Severe / Expected / Likely / — jp.jma.warning-class = warning
special-warning Extreme / Expected / Likely / — jp.jma.warning-class = special-warning
cancelled Minor / Past / Observed / AllClear —
violent Extreme / Expected / Observed / — jp.jma.typhoon-intensity = violent
very-strong Extreme / Expected / Observed / — jp.jma.typhoon-intensity = very-strong
strong Severe / Expected / Observed / — jp.jma.typhoon-intensity = strong
tropical-storm Moderate / Expected / Observed / — jp.jma.typhoon-intensity = none
info Minor / Unknown / Unknown / — —

cancelled は警報・注意報の解除であり、気象庁 XML の取消ではない(BSAF 拡張 §5.2.3)。解除の投稿は旧投稿の拡散停止の根拠にならない。

4.3 種別による上書き

次の組では §4.2 の値の一部を上書きする。

type: と value: 上書き 理由
tornado-warning と warning urgency: Immediate、responseTypes: ["Shelter"] 竜巻注意情報は発表から約 1 時間を対象とし、屋内の安全確保を求める
heavy-rain と warning urgency: Immediate、certainty: Observed 記録的短時間大雨情報は観測・解析された大雨を伝える
linear-rainband-warning と level5 certainty: Observed 線状降水帯の発生(直前予測は level4)を伝える

5. 本文から抽出する項目

5.1 JMA Bot

種別 行の正規表現 生成する項目
earthquake ^\d{1,2}日\d{1,2}時\d{2}分ころ、(.{1,64})で地震$ hypocenter.name = 1 番目の捕獲(lang: "ja")
earthquake ^マグニチュード:(\d{1,2}(?:\.\d)?)((?:深さ約(\d{1,3})km|深さ不明))$ 1 番目の捕獲が 0 より大きければ magnitude.value = 10 倍の整数。2 番目の捕獲が 0 より大きければ hypocenter.depth = km × 1,000,000
tsunami ^予想される最大高さ:(.{1,32})$ maxHeight.text(lang: "ja")、basis: "forecast"。捕獲が ^(\d{1,2}(?:\.\d)?)m$ に一致すれば maxHeight.value = m × 1,000
eruption(2 行目) ^(.{1,32})で噴火が発生$ volcano.name。1 行目が ^\S+ 噴火速報$ に一致する場合に限る(噴火速報)
eruption(2 行目) ^(.{1,32})(噴火警戒レベル([1-5]))$ volcano.name、jp.jma.volcanic-alert-level = 2 番目の捕獲

マグニチュード 0 は Bot が不明を表す値である(固定リビジョンの解析処理が数値化できない値を 0 にする)。深さ 0 も Bot は「深さ不明」と出力するため、いずれも省略する。マグニチュードの種類(Mj 等)は本文にないため置かない。

5.2 Kikikuru Bot

種別 行の正規表現 生成する項目
typhoon(1 行目) ^🌀 台風第\d{1,2}号((.{1,32}))$ name(lang: "ja-Kana")
typhoon ^中心気圧:(\d{3,4})hPa$ pressure = hPa × 100
typhoon ^最大風速:(\d{1,3})m/s(?:(最大瞬間\d{1,3}m/s))?$ maxWind = m/s × 1,000

台風番号は本文に年がなく一意にならないため、designation は生成しない。

6. 例

Kikikuru Bot の竜巻注意情報(type:tornado-warning、value:warning、target:jp-chiba)から生成する拡張である。原本文、BSAF 拡張、出典は省略し、regions は prefectures.json の jp-chiba の 24 セルのうち先頭 3 セルだけを示す。

[
  {
    "$type": "dev.jisaku.mosimo.hazard",
    "status": "Actual",
    "category": ["Met"],
    "severity": "Severe",
    "urgency": "Immediate",
    "certainty": "Likely",
    "responseTypes": ["Shelter"],
    "event": { "text": "竜巻注意情報", "lang": "ja" },
    "scales": [{ "scheme": "jp.jma.warning-class", "value": "warning" }]
  },
  { "$type": "dev.jisaku.mosimo.hazard.weather", "phenomena": ["tornado"] },
  {
    "$type": "dev.jisaku.mosimo.geo#area",
    "regions": [
      { "shape": "geohash", "hash": "xn5q" },
      { "shape": "geohash", "hash": "xn5r" },
      { "shape": "geohash", "hash": "xn5w" }
    ],
    "approximation": true
  }
]

参照