気象庁XMLを使い倒そうチュートリアル〜気象庁XMLとは〜

平成26年3月20日（木）気象庁予報部情報通信課 山鹿 康平

【目標】
 気象庁XMLの構造を理解しよう。
 XMLの構成と共通部分について説明します。

 気象庁XML情報提供ページの資料の使い方を理解しよう。
 困ったときはどの資料を見ればいいのか説明します。

2

導入編
 先ずは仕様書を見てみましょう。
http://xml.kishou.go.jp/specifications.html



気象庁XMLの基礎資料は３点
 気象庁防災情報XML
フォーマット仕様
 辞書
 スキーマ3

導入編
 辞書とスキーマは１対１対応です。
 辞書

 スキーマ

１対１

辞書の読み方さえマスターしてしまえば、気象庁XMLの読み方はどれも同じ。
4

基本構造
（電文例）
<?xml version="1.0" encoding="UTF-8" standalone="no"?><Report xmlns="http://xml.kishou.go.jp/jmaxml1/"
xmlns:jmx="http://xml.kishou.go.jp/jmaxml1/"
xmlns:jmx_add="http://xml.kishou.go.jp/jmaxml1/addition1/"><Control><Title>府県天気概況</Title><DateTime>2014-03-17T11:10:23Z</DateTime><Status>通常</Status><EditorialOffice>静岡地方気象台</EditorialOffice><PublishingOffice>静岡地方気象台</PublishingOffice></Control><Headxmlns="http://xml.kishou.go.jp/jmaxml1/informationBasis1/"><Title>天気概況</Title><ReportDateTime>2014-0317T20:10:00+09:00</ReportDateTime><TargetDateTime>2014-0317T20:10:00+09:00</TargetDateTime><EventID/><InfoType>発表</InfoType><Serial/><InfoKind>平文情報</InfoKind><InfoKindVersion>1.0_0</InfoKindVersion><Headline><Text>静岡県では、１８日朝は霜に対する農作物の管理に注意してください。</Text></Headline></Head><Body
xmlns="http://xml.kishou.go.jp/jmaxml1/body/meteorology1/"><TargetArea codeType="気象情報／府県予報区・細分区域等"><Name>静岡県</Name><Code>220000</Code></TargetArea><Notice/><Comment><Text type="本文"> 日本付近は移動性の高気圧に覆われています。
静岡県は、晴れています。
今夜は、高気圧に覆われて晴れるでしょう。
明日は、はじめ晴れますが、日本海を東へ進む低気圧からのびる前線の影
響により曇りとなり、昼過ぎから時々雨となるでしょう。</Text></Comment></Body></Report>

基本は３部構成<Report><Control>・・・管理部・・・ </Control><Head>・・・・ヘッダ部・・・・ </Head><Body>・・・・・内容部・・・・・ </Body></Report>

管理部【電文共通】


ヘッダ部【電文共通】

処理系、及び配信系に対して制御情報を与えると共に、電文の基本的な情報を提供。

防災気象情報の基本項目を提供。
標題、有効時間（いつ）、事項種別（何が）、対象地域（どこに）など共通項目を統一的に処理が可能。

内容部【電文固有】


量的予想など、ヘッダ部で共通化できない内容。

5

辞書と名前空間
接頭辞

共通
辞書

個別辞書
（内容部で指定）

名前空間

全体構造と管理部 jmxの定義

http://xml.kishou.go.jp/jmaxml1/

ヘッダ部の定義

jmx_ibhttp://xml.kishou.go.jp/jmaxml1/body/informationBasis1/

基本要素や部品の定義

jmx_ebhttp://xml.kishou.go.jp/jmaxml1/elementBasis1/（気温、風向、風速、マグニチュードなど。）

追加要素
（未利用）

jmx_add

http://xml.kishou.go.jp/jmaxml1/addition1/（XMLスキーマにおける any”を利用した拡張用。）

気象分野

jmx_mete http://xml.kishou.go.jp/jmaxml1/body/meteorology1/

地震・津波分野

jmx_seis

http://xml.kishou.go.jp/jmaxml1/body/seismology1/

火山分野

jmx_volc

http://xml.kishou.go.jp/jmaxml1/body/volcanology1/
6

気象庁XML資料の見方・使い方<?xml version="1.0" encoding="UTF-8" standalone="no"?><Report
xmlns="http://xml.kishou.go.jp/jmaxml1/"
xmlns:jmx="http://xml.kishou.go.jp/jmaxml1/"><Control>：・</Control><Head xmlns="http://xml.kishou.go.jp/jmaxml1/informationBasis1/"><Title>震度速報</Title><ReportDateTime>2014-03-17T18:05:00+09:00</ReportDateTime><TargetDateTime>2014-03-17T18:03:00+09:00</TargetDateTime><EventID>20140317180350</EventID><InfoType>発表</InfoType><Serial/><InfoKind>震度速報</InfoKind><InfoKindVersion>1.0_1</InfoKindVersion><Headline><Text>１７日１８時０３分ころ、地震による強い揺れを感じました。震度３以上が観測された地域をお知らせします。</Text><Information type="震度速報"><Item><Kind><Name>震度３</Name></Kind><Areas codeType="地震情報／細分区域"><Area><Name>福島県浜通り</Name><Code>251</Code></Area><Area><Name>茨城県北部</Name><Code>300</Code></Area></Areas></Item></Information></Headline></Head><Body xmlns="http://xml.kishou.go.jp/jmaxml1/body/seismology1/"
xmlns:jmx_eb="http://xml.kishou.go.jp/jmaxml1/elementBasis1/">：・</Body></Report> 全情報共通のヘッダ部の利用 jmx_ib:Head/jmx_ib:Headlineに重要な情報は全部まとめてある。（中身がない場合もある）
 Textに見出し（テロップ）
 Information要素単位で警報的事項を種類別にとりまとめ Item単位で
 Kindが警報的事項

 Nameが要素名
 Areasが地域
 Area/Nameが地域の名称

基本構造が変わらないので分野横断的に統一した処理が可能。

7

気象庁XML資料の見方・使い方（共通部分）
 管理部jmx:Titleとヘッダ部のjmx_ib:Title
 jmx:Title：処理配信制御のキーとしての利用 jmx_ib:Title:表示用の表題としての利用 管理部jmx:EditorialOfficeとjmx:PublishingOffice jmx:EditorialOffice：作成した機関（制御のキー） jmx:PublishingOffice：電文に責任を持つ機関（複数列挙） （表示用）

 管理部jmx:DateTimeとヘッダ部jmx_ib:ReportDateTimeと

jmx_ib:TargetDateTime
 jmx:DateTime：システムによるタイムスタンプとしての位置づけ。
 jmx_ib:ReportDateTime：公式な発表時刻
 jmx_ib:TargetDateTime：基点時刻（予報対象時刻など）

その他に時刻要素として、jmx_ib:TargetDTDubious（基点時刻精度のあいまいさ）やjmx_ib:ValidDateTime(無効となる時刻)、
jmx_ib:TargetDuration（対象の時間幅）が追加される場合がります。
8

【資料の置き場】
 「気象庁防災情報XMLフォーマット仕様ver.1.1」

9

辞書・スキーマ
 辞書
 良く見るので、必要に応じてダウンロードしてご利用ください。

 スキーマファイル
 システム利用で必要に応じて。

10

コード表と解説資料
 コード管理表・個別コード表
 Codeに何の値をとるか、Codeが何を表すの？

 電文ごとの解説資料
 個々の情報がどのように運用されているの？

（情報種別ごと）

11

サンプルデータと全内容出力スタイルシート
 サンプルデータ
 どのような情報のXMLが出るの？

 スタイルシート（XSLT）
 情報に含まれる内容がよくわからないけど？

※見本としてご利用願います。

12

気象庁防災情報XMLフォーマット運用指針
 運用指針 バージョンアップは？、気象業務法との関係は？

 別紙１：辞書・スキーマバージョン管理表
 各電文に対応した最新の辞書・スキーマのバージョンは？

 別紙２：運用整理表
 管理部やヘッダ部の○○の要素には実際に何が入るの？

13

個別の気象庁XMLの利用イメージは、この後に続くプレゼンをご覧ください。

気象庁XML策定過程について
リンク集（http://xml.kishou.go.jp/link.html）「気象庁 測候時報第79巻（2012年度） 気象庁防災情報XMLフォーマットの詳細と策定経緯 」

14