alert

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

Jeśli wydarzenie obejmuje więcej niż jedną bieżącą lokalizację w danym czasie, lepiej podzielić wydarzenie na kilka obiektów alert. Jeśli np. pożar lasu obejmuje wiele stanów, możesz podzielić alerty na kilka alertów, po jednym dla każdego stanu. Dzięki temu przekażesz określone informacje alarmowe do każdego stanu, co pozwoli Ci dokładniej aktualizować sytuację w przypadku pożaru.

Jeśli wydarzenie szybko się zmienia, np. huragan przemieszcza się ze wschodu na zachód, zalecamy okresowe aktualizowanie alertu. Nie usuwaj istniejącego alertu z pliku danych. Zamiast tego wygeneruj nowy alert, który odnosi się do poprzedniego alertu.

Atrybuty

Tabela 1 opisuje wartość atrybutu elementu <alert>:

Tabela 1. Atrybut elementu <alert>

Nazwa elementu Opcjonalny Typ Opis
xmlns:cap WYMAGANE string

Atrybut xmlns musi odnosić się do przestrzeni nazw CAP URN.

Przykład:

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

Elementy

Tabela 2 opisuje wartości elementów podrzędnych elementu <alert>:

Tabela 2. <alert> elementu encji

Nazwa elementu Opcjonalny Typ CAP oraz uwagi i wymagania Google
<identifier> WYMAGANE string Podaj identyfikator alertu, który reprezentuje zdarzenie. Wartość elementu <identifier> musi być unikalna we wszystkich zdarzeniach.
<sender> WYMAGANE string Element <sender> określa źródło alertu. Nie może zawierać spacji, przecinków ani znaków objętych ograniczeniami.
<sent> WYMAGANE dateTime

Jeśli lokalizacja wskazana w bloku <area> należy do jednej strefy czasowej, użyj elementu <sent>, aby określić czas w tej strefie. W razie potrzeby uwzględnij limit czasu letniego.

Jeśli treść wiadomości ma zastosowanie do wielu stref czasowych, użyj czasu UTC lepiej niż czas lokalny.
<status> WYMAGANE AlertStatus

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

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

  • Każdy komunikat alertu, który aktualizuje poprzedni alert, używa polecenia UPDATE i ustawia wartości elementu <references> na wszystkie wcześniejsze wiadomości, które nie osiągnęły daty <expires>.
  • Element UPDATE lub CANCEL <msgType> musi być zastosowany dla danego alertu. Oznacza to, że wszystkie powiązane wiadomości i aktualne alerty muszą być wywoływane, gdy UPDATE lub CANCEL <msgType>.

Więcej informacji znajdziesz w artykule Zmiany w czasie trwania wydarzenia i okres jego ważności.
<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> wskazuje zamierzony rozkład alertu.
<restriction> WARUNKOWA string Jeśli wartość elementu <scope> to Restricted, wymagany jest element <restriction>. Ten element opisuje regułę ograniczającą rozpowszechnianie alertu z ograniczonym dostępem.
<addresses> WARUNKOWA string Jeśli wartość elementu <scope> to Private, wymagany jest element <addresses>. Ten element zawiera listę adresatów wiadomości alertu. Możesz podać wiele adresów rozdzielonych spacjami, ale adresy, które zawierają spacje, umieść w cudzysłowach podwójnych.
<code> OPCJONALNE string

Element <code> oznacza specjalną obsługę wiadomości z alertem.
<note> WARUNKOWA string

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

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

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

Gdy Twój system ponownie opublikuje treści dotyczące CAP od innego wydawcy, dołącz cały alert dotyczący CAP. Aby połączyć zmodyfikowaną treść z oryginalnym ź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> łączy wiele wiadomości, które odnoszą się do różnych aspektów tego samego incydentu.
<info>

WYMAGANE*

 info Musi być obecny co najmniej 1 element <info>. Wszystkie bloki <info> muszą mieć te same wartości elementu <category> i <event>.

* Google wymaga elementów oznaczonych pogrubioną i czerwoną wartością REQUIRED, ale są one opcjonalne w standardzie CAP.

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>