情報

<info> エンティティでは、アラートの詳細を指定します。アラートには少なくとも 1 つの <info> ブロックが必要です。複数の言語をサポートする場合は、同じ <alert> エンティティの言語ごとに 1 つの <info> ブロックを使用することをおすすめします。

info 個のエンティティ要素

次の表に、<info> エンティティのサブ要素の値を示します。

要素名 オプション タイプ CAP と Google の注意事項と要件
<language> 任意 language

<language> のコード値には、有効な RFC 3066 を使用することをおすすめします。

<language> 要素が存在しない場合のデフォルト値は en-US です。
<category> 必須かどうか InfoCategory <category> コードは、アラート メッセージの件名イベントのカテゴリを示します。イベントに適したカテゴリについては、OASIS イベント利用規約をご覧ください。適切に分類することで、Google はより正確にユーザーにアラートを表示できます。
<event> 必須かどうか string

<event> 要素は、アラート メッセージの件名イベントのタイプを示します。

<event> 要素の要件は次のとおりです。

  • 半角 35 文字未満にしてください。
  • CSV または Google スプレッドシートで一連の事前定義された <event> タイプを一覧表示します（こちらの Google スプレッドシートの例をご覧ください）。
<responseType> 任意 responseType

適切なオーディエンスに推奨されるアクションのタイプを示すために、該当する場合は、<responseType> 要素と、それに対応する <instruction> 要素の値を指定することを強くおすすめします。
<urgency> 必須かどうか urgency

<urgency> 要素に Unknown という値を使用しないでください。この値が原因で、アラートや相対ランクのインデックス登録が困難になります。

Google は、<urgency> フィールドがどのように設定されているか、誰が知っているかを把握することが重要です。ただし、この情報は正式なプロフィールの範囲外です。

ニュース メディアはケースごとに <urgency> 値を設定し、明確なトリガー ガイドラインに従うことをおすすめします。ただし、<event> 要素が <urgency> 値を修正し、それによりアラート作成者の柔軟性が低下する可能性があります。たとえば、米国の NOAA はイベントタイプに基づいて緊急性を静的に設定しています。
<severity> 必須かどうか severity

<severity> 要素に Unknown という値を使用しないでください。この値が原因で、アラートや相対ランクのインデックス登録が困難になります。

Google は、<severity> フィールドがどのように設定されているか、誰が知っているかを把握することが重要です。ただし、この情報は正式なプロフィールの範囲外です。

ニュース メディアはケースごとに <severity> 値を設定し、明確なトリガー ガイドラインに従うことをおすすめします。ただし、<event> 要素が <severity> 値を修正し、それによりアラート作成者の柔軟性が低下する可能性があります。たとえば、米国の NOAA はイベントタイプに基づいて緊急性を静的に設定しています。
<certainty> 必須かどうか certainty

<certainty> 要素に Unknown という値を使用しないでください。この値が原因で、アラートや相対ランクのインデックス登録が困難になります。

Google にとって、<certainty> フィールドがどのように設定され、誰によって認識されるかは重要です。ただし、この情報は正式なプロフィールの範囲外です。

ニュース メディアはケースごとに <certainty> 値を設定し、明確なトリガー ガイドラインに従うことをおすすめします。ただし、<event> 要素が <certainty> 値を修正し、それによりアラート作成者の柔軟性が低下する可能性があります。たとえば、米国の NOAA はイベントタイプに基づいて緊急性を静的に設定しています。
<audience> 任意 string <audience> 要素の値は、アラート メッセージの対象オーディエンスを説明するテキストです。
<eventCode> 任意 string

<eventCode> 要素には、次の形式のアラート メッセージのイベントタイプを識別するシステム固有のコードが含まれています。

        <eventCode>
          <valueName>valueName</valueName>
          <value>value</value>
        </eventCode>

ここで

  • valueName = コードのドメインを指定する、ユーザーが割り当てた文字列。これらの文字列が頭字語の場合は、すべての大文字でピリオドなしで指定します。たとえば、SAME、FIPS、ZIP などです。
  • value = <eventCode> 要素の値を表す文字列。

<info> ブロック内では、<eventCode> 要素の複数のインスタンスが発生する可能性があります。

<eventCode> 要素の値は OASIS イベント規約のリストから取得することを強くおすすめします。OASIS イベント期間のリストを使用する場合は、次の例のように OET:v1.0 を値の名前として使用します。

        <eventCode>
          <valueName>OET:v1.0</valueName>
          <value>OET-003</value>
        </eventCode>
<effective> 任意 dateTime

<effective> 要素の値は、アラート メッセージ内の情報の実効時間です。

すべての dateTime 値にタイムゾーン フィールドを含める必要があります。<area> ブロックで囲まれているロケーションが 1 つのタイムゾーン内にある場合は、<effective> 要素でそのゾーンの時刻を指定することをおすすめします。該当する場合、サマータイムの許容時間を含めます。

メッセージのコンテンツが複数のタイムゾーンに適用される場合、メッセージ プロデューサーは現地時間ではなく UTC 時間を使用することをおすすめします。

例:

2002-05-24T16:49:00-07:00 は、2002 年 5 月 24 日 16:49（太平洋夏時間）を表します。
<onset> 任意 dateTime

<onset> 要素の値は、アラート メッセージの件名イベントが開始されるときに想定される時間です。すべての dateTime 値にタイムゾーン フィールドを含める必要があります。

<area> ブロックで囲まれているロケーションが 1 つのタイムゾーン内にある場合は、<effective> 要素でそのゾーンの時刻を指定することをおすすめします。サマータイムが適用される場合は、時間も含めてください。

メッセージのコンテンツが複数のタイムゾーンに適用される場合、メッセージ プロデューサーは現地時間ではなく UTC 時間を使用することをおすすめします。

例:

2002-05-24T16:49:00-07:00 は、2002 年 5 月 24 日 16:49（太平洋夏時間）を表します。
<expires>

必須*

 dateTime

<expires> 要素の値は、アラート メッセージのサブジェクト イベントの有効期限です。<expires> 要素は、<effective> 要素の後になるように時間的順序で配置する必要があります。

すべてのアラートに有効期限を設定できない場合は、<expires> 要素のないアラートにデフォルトの有効期限を設定してください。たとえば、<expires> 要素がない場合、すべてのアラートの有効期限を 48 時間に設定するよう指定できます。

すべての dateTime 値にタイムゾーン フィールドを含める必要があります。<area> ブロックで囲まれているロケーションが 1 つのタイムゾーン内にある場合は、<effective> 要素でそのゾーンの時刻を指定することをおすすめします。該当する場合、サマータイムの許容時間を含めます。

メッセージのコンテンツが複数のタイムゾーンに適用される場合、メッセージ プロデューサーは現地時間ではなく UTC 時間を使用することをおすすめします。

例:

2002-05-24T16:49:00-07:00 は、2002 年 5 月 24 日 16:49（太平洋夏時間）を表します。
<senderName> 任意 string

<senderName> 要素は省略可能ですが、使用することを強くおすすめします。

送信者が判読可能な名前を持っている場合は、<web> リンクは、ニュース メディアまたは送信者の設定に従って、ユーザー フレンドリーな形式で表示されます。また、<senderName> 要素を使用すると、アラート アグリゲータを複数のオーソリティから公開できます。
<headline> 任意 string

<headline> 要素文字列の長さは 140 文字未満にしてください。

<headline> 文字列は自由テキスト形式にできますが、140 文字未満にすることをおすすめします。（CAP 1.2 では、テキスト メッセージが 160 未満であることが推奨されています）。この文字列の先頭に、アラートの主たる特徴を示す数語を記述します。（例: 「Pontoon ブリッジが...」）。

<headline> 要素と <description> 要素に同じ値を使用しないでください。<description> 要素には、<headline> 要素よりも詳細を指定します。
<description>

必須*

 string

<description> 要素の値は、アラート メッセージのイベントの件名を記述するテキストです。

次の質問に回答するような、人が読める形式の有益なコンテンツをおすすめします。

  • 何が起こっているのか、これから起こるのか
  • どこで起きているか？
  • 悪い点は？

Google は、<description> 要素を使用してページの [メッセージ] セクションにデータを入力し、<instruction> 要素を使用して [推奨される対応] セクションに入力します。どちらのフィールドもユーザーに表示されます。

サポートされている Markdown タグ（<newline>、<b>、<a href>）を使用できます。
<instruction> 任意 string

<instruction> 要素の値は、アラート メッセージの受信者に推奨される対応を説明するテキストです。人が読める形式の有益なコンテンツをおすすめします。

アラートの重大度レベルに該当し、一般的ではないアクションを一覧表示します。簡潔で大文字と小文字を区別した文を使用し、行動を起こすための安全に関する情報を含めます。最も重要なヒントを最初に記載します。

<instruction> 要素は省略可能ですが、使用することを強くおすすめします。Google 災害情報では <instruction> フィールドを使用して、アラートの詳細ページの [推奨される対応] セクションにデータを入力します。<instruction> と <description> は用途が異なるため、項目の値を変えてください。
<web>

必須*

 string

ウェブサーバーでアクセス可能な元のアラートのコピーに <web> 要素へのリンクを設定します。
<contact> 任意 string

<contact> フィールドは省略可能ですが、ユーザーがフィードバックを返したりアラートに応答したりできるようにするため、このフィールドを指定することを強くおすすめします。たとえば、「緊急時には 911 に発信してください。」
<parameter> 任意 string

<parameter> 要素には、次の形式のシステム固有のデータが含まれます。

        <parameter>
          <valueName>valueName</valueName>
          <value>value</value>
        </parameter>

ここで

valueName = コードのドメインを指定する、ユーザーが割り当てた文字列。

value = 文字列値。

<info> ブロック内では、<parameter> 要素の複数のインスタンスが発生する可能性があります。
<resource> 任意 resource

<resource> 要素では、親 <info> 要素に関連する補足情報を提供します。<info> ブロック内では、<resource> 要素の複数のインスタンスが発生する可能性があります。
<area>

必須*

 area

<area> 要素には、インシデント領域ではなく、イベントのアラート領域に関する情報が含まれます。<area> ブロックには、少なくとも 1 つの <circle>、<polygon>、または <geocode> 要素を含める必要があります。

<geocode> 要素ではなく、<polygon> 要素または <circle> 要素を使用することを強くおすすめします。

* 太字と赤色の REQUIRED オプションがある要素は必須ですが、CAP 標準ではこれらの要素はオプションです。

例

<info>
    <language>en-CA</language>
    <category>Met</category>
    <event>blowing snow</event>
    <responseType>Monitor</responseType>
    <urgency>Future</urgency>
    <severity>Moderate</severity>
    <certainty>Possible</certainty>
    <audience>general public</audience>
    <eventCode>
        <valueName>profile:CAP-CP:Event:0.4</valueName>
        <value>blowingSnow</value>
    </eventCode>
    <effective>2023-04-13T23:16:53-00:00</effective>
    <expires>2023-04-14T15:11:38-00:00</expires>
    <senderName>Environment Canada</senderName>
    <headline>blowing snow advisory in effect</headline>
    <description>
    Periods of poor visibility in blowing snow.

    When: Tonight through this weekend.

    Impacts: Poor visibility due to blowing snow.

    Remarks: Strong easterly winds are expected to continue through the
    Richardson Mountains through at least this weekend. Gusty northeasterly
    winds are also possible near the Ogilvie Mountains during the same
    timeframe. These strong winds will likely generate periods of blowing
    snow through the mountain passes and visibility will at times be
    significantly reduced.
    </description>
    <instruction>Be prepared to adjust your driving with changing road
    conditions.</instruction>
    <web>http://weather.gc.ca/warnings/index_e.html?prov=yt</web>
    <area>
        <areaDesc>Dempster</areaDesc>
        <polygon>65.4581,-137.8443 64.3417,-137.8311 64.3385,
        -137.911 64.3497,-138.0022 64.415,-138.4948 64.5198,-138.9891 65.53,
        -139.0095 66.6721,-137.1316 67.0102,-136.6048 67.1424,
        -136.3737 67.2766,-136.136 67.2657,-135.9251 67.1757,-136.0889 67.0,
        -136.012 67.0,-135.9999 67.0133,-135.4962 67.0,-134.9833 65.4581,
        -137.8443</polygon>
        <geocode>
            <valueName>layer:EC-MSC-SMC:1.0:CLC</valueName>
            <value>093100</value>
        </geocode>
        <geocode>
            <valueName>profile:CAP-CP:Location:0.3</valueName>
            <value>6001045</value>
        </geocode>
    </area>
</info>