avviso

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

Se un evento occupa più di un luogo in corso contemporaneamente, è meglio dividerlo in più oggetti alert. Ad esempio, se un incendio boschivo attraversa più stati, puoi suddividerli in più avvisi, uno per ogni stato. In questo modo fornisci informazioni di emergenza specifiche a ogni stato e aggiorni la situazione di 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'avviso esistente dal feed. Crea invece un nuovo avviso che faccia riferimento all'avviso precedente.

Attributi

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

Tabella 1. Attributo entità <alert>

Nome elemento Facoltativo Tipo Descrizione
xmlns:cap OBBLIGATORIA string

L'attributo xmlns deve fare riferimento a CAP URN come 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 dell'entità <alert>:

Tabella 2. <alert> elementi entità

Nome elemento Facoltativo Tipo Note e requisiti di CAP e Google
<identifier> OBBLIGATORIA string Indica l'ID dell'avviso che rappresenta l'evento. Il valore dell'elemento <identifier> deve essere univoco in tutti gli eventi.
<sender> OBBLIGATORIA string L'elemento <sender> identifica l'origine dell'avviso. Non può contenere spazi, virgole o caratteri non consentiti.
<sent> OBBLIGATORIA 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 margine per l'ora legale.

Quando i contenuti di un messaggio si applicano a più fusi orari, utilizza gli orari UTC anziché a quelli locali.
<status> OBBLIGATORIA AlertStatus

Google pubblica solo avvisi disponibili pubblicamente che hanno un valore elemento <status> di Actual.
<msgType> OBBLIGATORIA AlertMsgType

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

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

Per maggiori 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> OBBLIGATORIA AlertScope

L'elemento <scope> indica la distribuzione prevista del messaggio di avviso.
<restriction> CONDIZIONATO 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 limitato.
<addresses> CONDIZIONATO 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 delimitati da spazi, ma devi racchiudere gli indirizzi che includono spazi vuoti tra virgolette doppie.
<code> FACOLTATIVO string

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

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

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

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

Quando il tuo sistema pubblica di nuovo i contenuti CAP di un altro editore, includi l'avviso CAP completo. Per collegare i contenuti modificati all'origine originale, utilizza il tag <references>.

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

REQUIRED*

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

* Google richiede elementi con un'impostazione di tipo REQUIRED 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>