アラート

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

イベントが同時に複数の場所で開催される場合、イベントは複数の alert オブジェクトに分割することをおすすめします。たとえば、森林火災が複数の州にまたがっている場合、アラートを州ごとに複数のアラートに分割できます。そうすることで、各州に特定の緊急情報を提供し、火災の状況をより正確に把握できます。

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

属性

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

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

要素名 オプション タイプ 説明
xmlns:cap 必須かどうか string

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

例:

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

要素

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

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

要素名 オプション タイプ CAP と Google の注意事項と要件
<identifier> 必須かどうか string イベントを表すアラートの ID を指定します。<identifier> 要素の値は、すべてのイベントで一意である必要があります。
<sender> 必須かどうか string <sender> 要素は、アラートの生成元を識別します。スペース、カンマ、制限文字を含めることはできません。
<sent> 必須かどうか dateTime

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

メッセージのコンテンツが複数のタイムゾーンに適用される場合は、現地時間ではなく UTC 時刻を使用します。
<status> 必須かどうか AlertStatus

Google が公開しているアラートは、<status> 要素の値が Actual のものだけです。
<msgType> 必須かどうか AlertMsgType

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

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

詳細については、イベントの変更または有効期限をご覧ください。
<source> 任意 string <source> 要素は、アラートの特定のソースを示します。たとえば、オペレーターや特定のデバイスなどです。
<scope> 必須かどうか 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 <info> 要素が 1 つ以上必要です。複数の <info> ブロックの <category> 要素と <event> 要素の値は、すべて同じでなければなりません。

* 太字と赤色の REQUIRED オプションがある要素は必須ですが、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>