avviso

Per definire le informazioni di base su un evento in corso, utilizza l'entità <alert>.

Se un evento occupa più di una posizione in corso contemporaneamente, è meglio suddividerlo in più oggetti alert. Ad esempio, se un incendio boschivo si estende su più stati, puoi suddividere gli avvisi in più avvisi, uno per ogni stato. In questo modo, fornisci informazioni di emergenza specifiche per ogni stato e aggiorni la situazione dell'incendio in modo più accurato.

Se un evento cambia rapidamente, ad esempio un uragano che si sposta da est a ovest, ti consigliamo di aggiornare periodicamente l'avviso. Non rimuovere l'alert esistente dal tuo feed. Emetti invece un nuovo avviso che rimandi all'avviso precedente.

Attributi

La tabella 1 descrive il valore dell'attributo per l'entità <alert>:

Tabella 1. Attributo dell'entità <alert>

Nome elemento Facoltatività Tipo Descrizione
xmlns:cap OBBLIGATORIO string

L'attributo xmlns deve fare riferimento all'ARN CAP come allo spazio dei nomi.

Esempio:

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

Elementi

La tabella 2 descrive i valori degli elementi secondari per l'entità <alert>:

Tabella 2. Elementi dell'entità <alert>

Nome elemento Facoltatività Tipo Note e requisiti di CAP e Google
<identifier> OBBLIGATORIO string Fornisci l'ID dell'avviso che rappresenta l'evento. Il valore dell'elemento <identifier> deve essere univoco per tutti gli eventi.
<sender> OBBLIGATORIO string L'elemento <sender> identifica l'autore dell'avviso. Non può includere spazi, virgole o caratteri con limitazioni.
<sent> OBBLIGATORIO dateTime

Se la località indicata nel blocco <area> rientra in un unico fuso orario, utilizza l'elemento <sent> per specificare l'ora in quel fuso orario. Se applicabile, includi un'indennità per l'ora legale.

Quando i contenuti di un messaggio si applicano a più fusi orari, utilizza l'ora UTC anziché quella locale.
<status> OBBLIGATORIO AlertStatus

Google pubblica solo gli avvisi disponibili pubblicamente il cui valore dell'elemento <status> è Actual.
<msgType> OBBLIGATORIO AlertMsgType

Un elemento UPDATE o CANCEL <msgType> deve includere almeno un elemento <references>. Lo standard CAP specifica quanto segue:

  • Qualsiasi messaggio di avviso che aggiorna un avviso precedente utilizza UPDATE e imposta i valori dell'elemento <references> su tutti i messaggi precedenti che non hanno raggiunto la data <expires>.
  • L'elemento UPDATE o CANCEL <msgType> deve essere applicato a un avviso non scaduto. Pertanto, quando viene emesso un UPDATE o un CANCEL <msgType>, deve essere fatto riferimento a tutti i messaggi correlati e agli avvisi non scaduti.

Per ulteriori informazioni, vedi Modifiche o scadenza degli eventi.
<source> FACOLTATIVO string L'elemento <source> indica la sorgente specifica dell'avviso. Un esempio è un operatore o un dispositivo specifico.
<scope> OBBLIGATORIO AlertScope

L'elemento <scope> indica la distribuzione prevista del messaggio di avviso.
<restriction> CONDIZIONALE string Se il valore dell'elemento <scope> è Restricted, l'elemento <restriction> è obbligatorio. Questo elemento descrive la regola per limitare la distribuzione del messaggio di avviso con limitazioni.
<addresses> CONDIZIONALE string Se il valore dell'elemento <scope> è Private, l'elemento <addresses> è obbligatorio. Questo elemento elenca il destinatario previsto del messaggio di avviso. Puoi includere più indirizzi separati da spazi, ma devi racchiudere tra virgolette doppie gli indirizzi che includono spazi.
<code> FACOLTATIVO string

L'elemento <code> indica la gestione speciale del messaggio di avviso.
<note> CONDIZIONALE string

Se l'avviso contiene uno dei seguenti valori dell'elemento, l'elemento <note> è obbligatorio:

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

Se il valore dell'elemento <msgType> è UPDATE o CANCEL, l'elemento <references> è obbligatorio.

Quando il tuo sistema ripubblica contenuti CAP di un altro editore, includere l'avviso CAP completo. Per collegare i contenuti modificati alla fonte originale, utilizza il tag <references>.

Se fai riferimento a più messaggi, utilizza gli spazi come delimitatore.
<incidents> FACOLTATIVO string L'elemento <incidents> raccoglie più messaggi che fanno riferimento a diversi aspetti dello stesso incidente.
<info>

OBBLIGATORIO*

 info Deve essere presente almeno un elemento <info>. Più blocchi <info> devono avere tutti gli stessi valori degli elementi <category> e <event>.

* Google richiede elementi con un'opzione OBBLIGATORIA in grassetto e rosso, ma questi elementi sono facoltativi nello standard CAP.

Esempio

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