アラート

現在のイベントに関する基本情報を定義するには、<alert> エンティティを使用します。

イベントが複数の進行中の場所を同時に占有する場合は、イベントを複数の alert オブジェクトに分割することをおすすめします。たとえば、山火事が複数の州にまたがっている場合は、アラートを州ごとに複数のアラートに分割できます。これにより、各州に具体的な緊急情報を提供でき、火災の状況をより正確に更新できます。

ハリケーンが東から西に移動するなど、イベントが急速に変化する場合は、アラートを定期的に更新することをおすすめします。既存のアラートをフィードから削除しないでください。代わりに、以前のアラートを参照する新しいアラートを発行します。

属性

表 1 に、<alert> エンティティの属性値を示します。

表 1. <alert> エンティティ属性

要素名 選択性 タイプ 説明
xmlns:cap REQUIRED string

xmlns 属性は、CAP URN を名前空間として参照する必要があります。

例:

<cap:alert xmlns:cap="urn:oasis:names:tc:emergency:cap:1.2"/>

要素

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

表 2. <alert> エンティティ要素

要素名 選択性 タイプ CAP と Google に関する注意事項と要件
<identifier> REQUIRED string イベントを表すアラートの ID を指定します。<identifier> 要素の値は、すべてのイベントで一意である必要があります。
<sender> REQUIRED string <sender> 要素は、アラートの送信元を識別します。スペース、カンマ、制限付き文字は使用できません。
<sent> REQUIRED dateTime

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

メッセージの内容が複数のタイムゾーンに適用される場合は、ローカル時間ではなく UTC 時間を使用してください。
<status> REQUIRED AlertStatus

Google は、<status> 要素の値が Actual の一般公開アラートのみ公開します。
<msgType> REQUIRED AlertMsgType

UPDATE または CANCEL <msgType> には、少なくとも 1 つの <references> 要素を含める必要があります。CAP 標準では、次のことが規定されています。

  • 以前のアラートを更新するアラート メッセージは UPDATE を使用し、<expires> 日付に達していない以前のすべてのメッセージに <references> 要素値を設定します。
  • UPDATE または CANCEL <msgType> 要素は、期限切れでないアラートに適用する必要があります。したがって、UPDATE または CANCEL <msgType> が発行されたときに、関連するすべてのメッセージと期限切れでないアラートを参照する必要があります。

詳細については、イベントの変更または有効期限の切れ目をご覧ください。
<source> 任意 string <source> 要素は、アラートの特定のソースを表します。たとえば、オペレーターや特定のデバイスなどです。
<scope> REQUIRED AlertScope

<scope> 要素は、アラート メッセージの対象となる配信先を表します。
<restriction> 条件付き string <scope> 要素の値が Restricted の場合、<restriction> 要素が必要です。この要素には、制限付きアラート メッセージの配信を制限するルールを記述します。
<addresses> 条件付き string <scope> 要素の値が Private の場合、<addresses> 要素が必要です。この要素には、アラート メッセージの宛先受信者を指定します。複数のアドレスをスペースで区切って指定できますが、空白文字を含むアドレスは二重引用符で囲む必要があります。
<code> 任意 string

<code> 要素は、アラート メッセージの特別な処理を表します。
<note> 条件付き string

アラートに次のいずれかの要素値が含まれている場合は、<note> 要素が必要です。

  • <status>Exercise></status>
  • <msgType>Error></msgType>
<references> 条件付き string

<msgType> 要素の値が UPDATE または CANCEL の場合、<references> 要素が必要です。

システムが別のパブリッシャーの CAP コンテンツを再公開する場合は、完全な CAP アラートを含めます。編集したコンテンツを元のソースにリンクするには、<references> タグを使用します。

複数のメッセージを参照する場合は、空白を区切り文字として使用します。
<incidents> 任意 string <incidents> 要素は、同じインシデントのさまざまな側面を参照する複数のメッセージを収集します。
<info>

必須*

 info 少なくとも 1 つの <info> 要素が必要です。複数の <info> ブロックには、すべて同じ <category> 要素値と <event> 要素値が必要です。

* 太字で赤色の必須のオプションが設定されている要素は Google で必須ですが、CAP 標準では省略可能です。

例

<alert xmlns="urn:oasis:names:tc:emergency:cap:1.1">
    <identifier>AL20110412020900TornadoWarning</identifier>
    <sender>w-nws.webmaster@noaa.gov</sender>
    <sent>2011-04-11T21:18:07-05:00</sent>
    <status>Actual</status>
    <msgType>Alert</msgType>
    <scope>Public</scope>
    <info>
        <language>en-US</language>
        <category>Met</category>
        <event>Tornado Warning</event>
        <urgency>Immediate</urgency>
        <severity>Extreme</severity>
        <certainty>Observed</certainty>
        <effective>2011-04-11T21:09:00-05:00</effective>
        <expires>2011-04-11T21:30:00-05:00</expires>
        <headline>Tornado Warning issued April 11 at
        9:30PM CDT by NWS Birmingham</headline>
        <description>Tornado is observed near Cleburne.</description>
        <instruction>
          Don't wait to see or hear the tornado.
          For your protection, move to an interior room on the lowest floor
          of your home or business.</instruction>
        <area>
            <areaDesc>Cleburne</areaDesc>
            <polygon>33.61,-85.58 33.65,-85.58 33.72,-85.58
            33.81,-85.36 33.7,-85.34 33.7,-85.33 33.68,-85.33
            33.61,-85.58</polygon>
        </area>
    </info>
</alert>