Benachrichtigung

Wenn Sie grundlegende Informationen zu einem aktuellen Ereignis definieren möchten, verwenden Sie die Entität <alert>.

Wenn ein Ereignis an mehreren Orten gleichzeitig stattfindet, empfiehlt es sich, es in mehrere alert-Objekte aufzuteilen. Wenn sich ein Waldbrand beispielsweise über mehrere Bundesstaaten erstreckt, können Sie die Benachrichtigungen in mehrere Warnungen aufteilen. Eine davon für jeden Bundesstaat. Auf diese Weise geben Sie dem jeweiligen Bundesstaat bestimmte Notfallinformationen an und aktualisieren die Feuersituation noch genauer.

Wenn sich ein Ereignis schnell ändert, z. B. ein Hurrikan von Ost nach West, empfehlen wir, die Benachrichtigung regelmäßig zu aktualisieren. Entfernen Sie die vorhandene Benachrichtigung nicht aus Ihrem Feed. Senden Sie stattdessen eine neue Benachrichtigung, die auf die vorherige Benachrichtigung verweist.

Attribute

Tabelle 1 beschreibt den Attributwert für die <alert>-Entität:

Tabelle 1. <alert>-Entitätsattribut

Elementname Optionalität Typ Beschreibung
xmlns:cap ERFORDERLICH string

Das Attribut xmlns muss auf die CAP-URN als Namespace verweisen.

Beispiel:

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

Elemente

Tabelle 2 beschreibt die Unterelementwerte für die <alert>-Entität:

Tabelle 2 <alert>-Entitätselemente

Elementname Optionalität Typ CAP und Google-Notizen und -Anforderungen
<identifier> ERFORDERLICH string Geben Sie die ID der Benachrichtigung an, die das Ereignis darstellt. Der Wert des <identifier>-Elements muss für alle Ereignisse eindeutig sein.
<sender> ERFORDERLICH string Das <sender>-Element gibt den Ursprung der Benachrichtigung an. Er darf keine Leerzeichen, Kommas oder Zeichen enthalten.
<sent> ERFORDERLICH dateTime

Wenn sich der in dem Block <area> angegebene Standort innerhalb einer einzelnen Zeitzone befindet, verwenden Sie das <sent>-Element, um die Zeit in dieser Zone anzugeben. Geben Sie ggf. einen Zulassungszeitraum für die Sommerzeit an.

Wenn der Inhalt einer Nachricht in mehreren Zeitzonen angewendet wird, sollten Sie statt der Ortszeit die UTC-Zeit verwenden.
<status> ERFORDERLICH AlertStatus

Google veröffentlicht nur öffentlich verfügbare Benachrichtigungen mit dem <status>-Elementwert Actual.
<msgType> ERFORDERLICH AlertMsgType

Ein UPDATE oder CANCEL <msgType> muss mindestens ein <references>-Element enthalten. Im CAP-Standard wird Folgendes angegeben:

  • Jede Benachrichtigung, die eine vorherige Benachrichtigung aktualisiert, verwendet UPDATE und legt <references>-Elementwerte auf alle vorherigen Nachrichten fest, die das <expires>-Datum noch nicht erreicht haben.
  • Das Element UPDATE oder CANCEL muss auf eine nicht abgelaufene Benachrichtigung angewendet werden.<msgType> Daher muss auf alle zugehörigen Nachrichten und abgelaufenen Benachrichtigungen verwiesen werden, wenn UPDATE oder CANCEL <msgType> ausgestellt wird.

Weitere Informationen finden Sie unter Ereignisänderungen oder -ablauf.
<source> OPTIONAL string Das Element <source> gibt die jeweilige Quelle der Benachrichtigung an. Ein Beispiel ist ein Operator oder ein bestimmtes Gerät.
<scope> ERFORDERLICH AlertScope

Das Element <scope> gibt die vorgesehene Verteilung der Benachrichtigung an.
<restriction> ZUSTAND string Wenn der Wert des <scope>-Elements Restricted ist, ist das Element <restriction> erforderlich. Dieses Element beschreibt die Regel zur Begrenzung der Verteilung der eingeschränkten Benachrichtigung.
<addresses> ZUSTAND string Wenn der <scope>-Elementwert Private ist, ist das Element <addresses> erforderlich. Mit diesem Element wird der vorgesehene Empfänger der Benachrichtigung aufgelistet. Sie können mehrere durch Leerzeichen getrennte Adressen verwenden. Adressen, die Leerzeichen enthalten, müssen jedoch in doppelte Anführungszeichen gesetzt werden.
<code> OPTIONAL string

Das Element <code> gibt eine spezielle Behandlung der Benachrichtigung an.
<note> ZUSTAND string

Wenn die Benachrichtigung einen der folgenden Elementwerte enthält, ist das Element <note> erforderlich:

  • <status>Exercise></status>
  • <msgType>Error></msgType>
<references> ZUSTAND string

Wenn der Wert des <msgType>-Elements entweder UPDATE oder CANCEL ist, ist das Element <references> erforderlich.

Wenn Ihr System CAP-Inhalte von einem anderen Publisher neu veröffentlicht, fügen Sie die vollständige CAP-Benachrichtigung ein. Verwende das Tag <references>, um bearbeitete Inhalte mit der ursprünglichen Quelle zu verknüpfen.

Wenn Sie auf mehrere Nachrichten verweisen, verwenden Sie Leerzeichen als Trennzeichen.
<incidents> OPTIONAL string Das <incidents>-Element enthält mehrere Meldungen, die sich auf verschiedene Aspekte desselben Vorfalls beziehen.
<info>

ERFORDERLICH*

 info Es muss mindestens ein <info>-Element vorhanden sein. Mehrere <info>-Blöcke müssen dieselben Elementwerte für <category> und <event> haben.

* Google verlangt Elemente mit der Fett- und Rotoption ERFORDERLICH, die im CAP-Standard optional sind.

Beispiel

<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>