alert

Aby zdefiniować podstawowe informacje o bieżącym zdarzeniu, użyj elementu <alert>.

Jeśli zdarzenie zajmuje więcej niż 1 bieżącą lokalizację w tym samym czasie, lepiej podzielić je na kilka obiektów alert. Jeśli na przykład pożar lasu obejmuje kilka stanów, możesz podzielić alerty na kilka alertów, po jednym dla każdego stanu. Dzięki temu możesz udostępniać konkretne informacje o zdarzeniach nadzwyczajnych dotyczące każdego stanu i bardziej dokładnie informować o sytuacji.

Jeśli zdarzenie zmienia się szybko, np. huragan przemieszcza się z wschodu na zachód, zalecamy okresowe aktualizowanie alertu. Nie usuwaj istniejącego alertu z pliku danych. Zamiast tego wyślij nowy alert, który odwołuje się do poprzedniego.

Atrybuty

Tabela 1 zawiera opis wartości atrybutu dla elementu <alert>:

Tabela 1. Atrybut encji <alert>

Nazwa elementu Opcjonalność Typ Opis
xmlns:cap WYMAGANE string

Atrybut xmlns musi odwoływać się do URN CAP jako przestrzeni nazw.

Przykład:

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

Elementy

Tabela 2 zawiera opis wartości podelementów w przypadku elementu <alert>:

Tabela 2. Elementy <alert>

Nazwa elementu Opcjonalność Typ Wskazówki i wymagania dotyczące Google i CAP
<identifier> WYMAGANE string Podaj identyfikator alertu, który reprezentuje zdarzenie. Wartość elementu <identifier> musi być niepowtarzalna w przypadku wszystkich zdarzeń.
<sender> WYMAGANE string Element <sender> identyfikuje nadawcę alertu. Nie może zawierać spacji, przecinków ani znaków specjalnych.
<sent> WYMAGANE dateTime

Jeśli lokalizacja podana w bloku <area> znajduje się w jednej strefie czasowej, użyj elementu <sent>, aby określić czas w tej strefie. W razie potrzeby uwzględnij czas letni.

Jeśli treść wiadomości dotyczy wielu stref czasowych, użyj czasu UTC zamiast czasu lokalnego.
<status> WYMAGANE AlertStatus

Google publikuje tylko alerty dostępne publicznie, których wartość elementu <status> to Actual.
<msgType> WYMAGANE AlertMsgType

Element UPDATE lub CANCEL <msgType> musi zawierać co najmniej jeden element <references>. Standard CAP określa:

  • Każda wiadomość o ostrzeżeniu, która aktualizuje poprzednie ostrzeżenie, używa elementu UPDATE i ustawia wartości elementu <references> dla wszystkich poprzednich wiadomości, które nie osiągnęły daty <expires>.
  • Element UPDATE lub CANCEL <msgType> musi dotyczyć alertu, którego ważność nie wygasła. Dlatego wszystkie powiązane wiadomości i niewygasłe alerty muszą być uwzględnione w przypadku wydania UPDATE lub CANCEL <msgType>.

Więcej informacji znajdziesz w artykule Zmiany i wygaśnięcie wydarzenia.
<source> OPCJONALNE string Element <source> wskazuje konkretne źródło alertu. Przykładem może być operator lub konkretne urządzenie.
<scope> WYMAGANE AlertScope

Element <scope> oznacza docelową dystrybucję komunikatu ostrzegawczego.
<restriction> WARUNKOWY string Jeśli wartość elementu <scope> to Restricted, wymagany jest element <restriction>. Ten element opisuje regułę ograniczającą rozpowszechnianie wiadomości z ostrzeżeniem z ograniczonym dostępem.
<addresses> WARUNKOWY string Jeśli wartość elementu <scope> to Private, wymagany jest element <addresses>. Ten element zawiera listę adresatów wiadomości z alertem. Możesz podać wiele adresów oddzielonych spacjami, ale adresy zawierające spacje musisz ująć w cudzysłowie.
<code> OPCJONALNE string

Element <code> oznacza szczególne przetwarzanie wiadomości alertu.
<note> WARUNKOWY string

Jeśli alert zawiera jedną z tych wartości elementu, wymagany jest element <note>:

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

Jeśli wartość elementu <msgType> to UPDATE lub CANCEL, wymagany jest element <references>.

Jeśli Twój system ponownie publikuje treści z CAP innego wydawcy, uwzględnij pełny alert CAP. Aby połączyć edytowane treści z pierwotnym źródłem, użyj tagu <references>.

Jeśli odwołujesz się do wielu wiadomości, użyj spacji jako separatora.
<incidents> OPCJONALNE string Element <incidents> gromadzi wiele wiadomości odnoszących się do różnych aspektów tego samego incydentu.
<info>

WYMAGANE*

 info Musisz mieć co najmniej 1 element <info>. Wiele bloków <info> musi mieć te same wartości elementów <category> i <event>.

* Google wymaga elementów oznaczonych pogrubioną i czerwoną czcionką jako wymagane, ale w standardzie CAP są one opcjonalne.

Przykład

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