情報

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

info エンティティ要素

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

要素名 選択性 タイプ CAP と Google に関する注意事項と要件
<language> 任意 language

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

<language> 要素が存在しない場合、デフォルト値は en-US です。
<category> REQUIRED InfoCategory <category> コードは、アラート メッセージの対象イベントのカテゴリを示します。イベントに適したカテゴリを特定するには、OASIS イベント用語リストを参照してください。適切に分類することで、Google がアラートをより正確にユーザーに表示できるようになります。
<event> REQUIRED string

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

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

  • 長さを 35 文字未満にしてください。
  • 事前定義された <event> タイプのセットを CSV または Google スプレッドシートにリストします（Google スプレッドシートの例をご覧ください）。
<responseType> 任意 responseType

適切なオーディエンスに推奨されるアクションの種類を示すには、該当する場合は、<responseType> 要素と、それに対応する <instruction> 要素の値を強くおすすめします。
<urgency> REQUIRED urgency

<urgency> 要素に「不明」の値を使用しないでください。この値を使用すると、アラートや相対ランクのインデックス作成が難しくなります。

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

パブリッシャーは、<urgency> 値をケースごとに設定し、明確なトリガー ガイドラインに従うことをおすすめします。ただし、<event> 要素は <urgency> 値を固定するため、アラート作成者の柔軟性が低下する可能性があります。たとえば、米国の NOAA は、イベントタイプに基づいて緊急度を静的に設定します。
<severity> REQUIRED severity

<severity> 要素に「不明」の値を使用しないでください。この値を使用すると、アラートや相対ランクのインデックス作成が難しくなります。

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

パブリッシャーは、<severity> 値をケースごとに設定し、明確なトリガー ガイドラインに従うことをおすすめします。ただし、<event> 要素は <severity> 値を固定するため、アラート作成者の柔軟性が低下する可能性があります。たとえば、米国の NOAA は、イベントタイプに基づいて緊急度を静的に設定します。
<certainty> REQUIRED certainty

<certainty> 要素に「不明」の値を使用しないでください。この値を使用すると、アラートや相対ランクのインデックス作成が難しくなります。

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

パブリッシャーは、<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.2 を使用します。

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

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

すべての dateTime 値にタイムゾーン フィールドを含める必要があります。<area> ブロックで指定された場所が単一のタイムゾーン内にある場合は、<effective> 要素でそのゾーンの時刻を指定することをおすすめします。該当する場合は、サマータイムの手当を含めます。

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

例:

2002-05-24T16:49:00-07:00 は 2002 年 5 月 24 日午後 4 時 49 分（太平洋標準時）を表します。
<onset> 任意 dateTime

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

<area> ブロックで指定された場所が単一のタイムゾーン内にある場合は、<effective> 要素でそのゾーンの時刻を指定することをおすすめします。該当する場合は、サマータイムの調整額を含めます。

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

例:

2002-05-24T16:49:00-07:00 は 2002 年 5 月 24 日午後 4 時 49 分（太平洋標準時）を表します。
<expires>

必須*

 dateTime

<expires> 要素の値は、アラート メッセージの対象イベントの有効期限です。<expires> 要素は、時間順で <effective> 要素の後に配置する必要があります。

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

すべての dateTime 値にタイムゾーン フィールドを含める必要があります。<area> ブロックで指定された場所が単一のタイムゾーン内にある場合は、<effective> 要素でそのゾーンの時刻を指定することをおすすめします。該当する場合は、サマータイムの手当を含めます。

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

例:

2002-05-24T16:49:00-07:00 は 2002 年 5 月 24 日午後 4 時 49 分（太平洋標準時）を表します。
<senderName> 任意 string

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

送信者に人が読める名前が設定されている場合、<web> リンクは、パブリッシャーまたは送信者の設定に応じて、ユーザー フレンドリーな方法で表示できます。また、<senderName> 要素を使用すると、アラート アグリゲータは複数のオーソリティから公開できます。
<headline> 任意 string

<headline> 要素の文字列の長さを 140 文字未満にします。

<headline> 文字列は自由形式のテキストにできますが、半角 140 文字未満にすることをおすすめします。（CAP 1.2 では、テキスト メッセージの場合は 160 文字未満が推奨されています）。この文字列は、アラートのコアについて説明する記述的な単語で始めます。例: 「Pontoon bridge closure....」

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

必須*

 string

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

以下の質問に答える、人が読める有益なコンテンツをおすすめします。

  • 何が起きているのか、または起きようとしているのか
  • どこで発生していますか？
  • どの程度深刻な問題でしょうか？

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

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

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

アラートの重大度のレベルに適合し、一般的なアクションではないアクションを一覧表示します。簡潔で大文字と小文字を区別した文章を使用し、読者が実践できる安全上のヒントを記載します。最も重要なヒントを先頭に記載します。

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

任意

 string

<web> 要素を、アラートに関する詳細情報を提供する有効な URL にリンクします。
<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> ブロックには、<circle>、<polygon>、または <geocode> の要素を 1 つ以上含める必要があります。

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

* 太字で赤色の必須のオプションが設定されている要素は Google で必須ですが、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>