Genera avvisi in formato CAP

Oltre allo standard CAP, segui i requisiti specifici di Google per i file CAP per assicurarti che gli avvisi vengano elaborati correttamente.

Hai a disposizione due opzioni per generare avvisi:

  1. Generazione automatica: configura il tuo sistema per formattare in modo dinamico le informazioni del tuo database in un feed CAP e invialo automaticamente a Google.
  2. Creazione manuale: crea e invia manualmente i contenuti dell'avviso in base alle esigenze tramite un'applicazione basata sul Web.

Generazione automatica

Consulta la libreria CAP di Google per iniziare nella lingua di tua scelta. La libreria supporta la creazione, l'analisi e la convalida di feed CAP.

Il team di Google può fornire assistenza durante l'implementazione. Contatta il team di Google o google-public-alerts@google.com.

Creazione manuale

  1. Collabora con il tuo team IT per installare l'applicazione web open source CAPCreatorTM su un server web. In alternativa, puoi creare la tua applicazione web.
  2. Man mano che si verificano eventi, visita l'URL dell'applicazione e utilizza l'interfaccia per creare avvisi in formato CAP.
  3. La tua applicazione pubblica un feed in una posizione sul Web; Google acquisisce quindi queste informazioni dal tuo feed pubblicato.

Elementi di avviso

L'anatomia di un'allerta

Un avviso dovrebbe rispondere alle seguenti domande chiave:

  1. Che cosa sta succedendo?
  2. Quando è previsto?
  3. Cosa devono fare le persone?
  4. Dove vengono inviati gli avvisi?

Di seguito è riportato un semplice esempio di avviso:

    <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>
            <instruction>
                Do not 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>

Assicurati di consultare i nostri Avvisi CAP di esempio per esempi più completi di avvisi di lavoro che potrebbero essere simili ai tuoi.

Evento

La stringa <event> CAP (o talvolta <headline>) viene visualizzata nel titolo dei nostri avvisi. Devono essere brevi (meno di 35 caratteri) e abbastanza descrittivi da poter essere compresi nel pubblico. Per requisiti più dettagliati, vedi <info> ed elementi secondari nella guida di riferimento.

date

I campi del fuso orario devono essere inclusi in tutti i valori di data/ora (ad esempio <effective>, <expires> e <onset>). Se la posizione citata nel blocco <area> rientra in un unico fuso orario, <effective> dovrà specificare l'ora in quel fuso orario, inclusa l'ora legale. Quando i contenuti di un messaggio si applicano a più fusi orari, il producer di messaggi deve utilizzare l'ora UTC rispetto all'ora locale.

Istruzioni per

Il campo <instruction> dell'avviso CAP viene visualizzato nelle pagine dei dettagli dell'avviso come"Azione consigliata". Tieni presente che i contenuti di questo elemento non devono corrispondere a quelli di <description>, che è più adatto a riepilogare la natura e l'intensità dell'avviso e l'area interessata.

area di notifica

L'elemento <area> dell'avviso CAP dovrebbe descrivere l'area geografica da notificare, che potrebbe includere posizioni al di fuori dell'area dell'incidente. Ad esempio, considera l'avviso di incendio boschivo: poiché gli incendi possono diffondersi rapidamente in aree attualmente non bruciate, il <area> dovrebbe coprire l'intera potenziale zona di pericolo, non solo l'origine dell'incendio o l'area di bruciore attuale.

Specificare aree come poligoni

Le aree di avviso sono consigliate meglio come poligoni perché tendono a essere più precisi. Idealmente, il valore dell'elemento <area> è definito come l'area geografica specifica che è interessata dalle condizioni attuali o previste, anziché le aree geopolitiche predeterminate, come distretti o province. In questo modo è possibile garantire che gli utenti che vedono l'avviso lo trovino pertinente alla località in cui si trova. Ad esempio, i temporali o le inondazioni potrebbero incidere solo su una piccola parte di una giurisdizione politica; inoltre, gli avvisi di neve probabilmente si riferiscono solo a utenti che si trovano al di sopra di una certa altitudine. In questi casi, se specifichi un intero distretto o provincia come <area> dell'avviso CAP, verrà sovrastimata l'area interessata e l'avviso sarà meno utile.

In base alla nostra esperienza, è preferibile utilizzare un software o uno strumento di avviso che consenta ai suggerimenti di tracciare un poligono personalizzato nell'area che vogliono avvisare.

Se utilizzi i poligoni, ti consigliamo di non includere più di 5-6 punti decimali con precisione nelle coordinate di latitudine e longitudine. Questo produce una risoluzione maggiore di quella che la maggior parte dei sistemi di avviso dovrebbe avere come target. Assicurati inoltre che i poligoni siano validi; ad esempio, non devono avere bordi che si intersecano.

Specificare aree come codici geografici

Se devi specificare <area> come geocodificato o come insieme di più codici geografici, utilizza le coordinate geografiche al livello più dettagliato possibile e includi i nomi delle città specifiche e così via che potrebbero essere interessate dall'elemento <description>. Dovrai condividere i file di forma sottostanti nel formato di un shapefile.

Supporto di più lingue

Creane uno <alert> contenente più blocchi <info> (un blocco <info> per lingua).

Per i dettagli e un avviso multilingue di esempio, consulta l'esempio di più lingue.

Convalida avvisi CAP

Ti consigliamo di utilizzare lo strumento di convalida CAP di Google open source per convalidare gli avvisi CAP. Puoi anche iscriverti alle email di notifica di errore tramite questo strumento. Lo strumento di convalida offre diversi esempi e opzioni di convalida CAP:

screenshot strumento di convalida

Seleziona Google Public Alert CAP v1.0 per eseguire la convalida in base ai requisiti specifici di Google per i feed CAP.

Per iscriverti alle email di notifica di errore, fai clic su Iscriviti ai risultati di convalida del feed o vai alla pagina http://cap-validate.appspot.com/subscribe. Devi fornire l'URL e l'indirizzo email del feed, selezionare Google Public Alert CAP v1.0 e fare clic su Iscriviti. Riceverai una notifica quando vengono rilevati problemi nel tuo feed CAP.

I publisher degli avvisi possono anche scaricare la versione più recente dello schema di CAP di Google dalla libreria CAP e convalidarli offline.

Passaggio successivo: invia a Google il feed Avvisi