I dati di avviso devono rispettare la specifica Common Alerting Protocol v1.2 di OASIS, oltre alla specifica CAP v1.0 di Google Public Alerts e ai requisiti aggiuntivi indicati di seguito.
Informazioni su Google CAP
Lo standard CAP stabilisce la struttura di base e gli elementi di dati per un avviso CAP, ma lascia ancora molto spazio a incoerenze su come e quando vengono utilizzati i vari elementi di dati.
La nostra piattaforma ha lo scopo di semplificare la ricerca di informazioni di emergenza riuniendo dati pertinenti e di alta qualità all'interno di strumenti online che le persone già utilizzano ogni giorno. I requisiti aggiuntivi hanno lo scopo di massimizzare la copertura e l'efficacia degli avvisi sui prodotti Google.
Le differenze specifiche di Google rispetto ai requisiti XML del CAP 1.2 sono riassunte nella specifica Google Public Alerts CAP v1.0.
L'opzione"Google Public Alerts CAP" nel strumento di convalida CAP open source ti consente di convalidare i tuoi dati sia in base alle specifiche OASIS sia ai requisiti aggiuntivi di Google.
Le linee guida riportate di seguito si applicano a tutti i tipi di avvisi e pericoli. Abbiamo anche raccolto alcuni requisiti e consigli aggiuntivi per questi tipi di avvisi specifici nella sezione Samples:
Esegui test periodici
- Assicurati che il sistema sia in grado di pubblicare avvisi con
<status>Test</status>per eseguire regolarmente test di sistema end-to-end.
Aree di avviso target
- Se sono presenti aree non contigue con lo stesso livello e tipo di avviso, crea messaggi
<alert>separati anziché un singolo<alert>con aree sconnesse. - Se l'elemento
<area>contiene elementi<polygon>, assicurati che siano poligoni validi senza spigoli autointersecati o poligoni sovrapposti e specifica un massimo di 6 cifre decimali di precisione. - Se l'elemento
<area>degli avvisi contiene codici geografici, fornisci i dati geografici in formato shapefile e informa Google all'indirizzo google-public-alerts@google.com almeno 30 giorni prima di eventuali modifiche al shapefile. - Disegna poligoni basati sull'impatto personalizzati in base alle condizioni attuali e alla natura dell'evento, ove possibile, anziché scegliere come target degli avvisi aree geopolitiche predefinite (ad es. province, distretti).
- Fornisci a Google una breve descrizione (meno di 50 caratteri) dell'area interessata nel
<areaDesc>o in un<parameter>dedicato separato dei tuoi avvisi CAP. Questo testo verrà visualizzato nel titolo dell'avviso.
Includi contenuti avanzati
- Includi contenuti utili, leggibili e dettagliati negli elementi
<description>e<instruction>. - Descrivi l'evento attuale, gli sviluppi previsti, l'impatto previsto e i consigli, se applicabili.
- Usa l'ortografia, la grammatica e la punteggiatura corrette.
- Utilizza il testo normale per migliorare la leggibilità dei contenuti anziché i tag HTML.
- Fornisci i codici colore RGB o esadecimali corrispondenti a ogni livello di avviso (possono essere forniti a Google offline).
Aggiornare gli avvisi
Quando un avviso cambia, pubblica un nuovo avviso che fa riferimento all'avviso precedente, anziché modificare o rimuovere quello esistente dal feed. Dopo un periodo di tempo appropriato (fino a due settimane), rimuovi gli avvisi CAP obsoleti dal tuo feed.
<msgType> UPDATE o CANCEL deve includere almeno un elemento <references>.
Come specificato nello standard CAP, qualsiasi messaggio di avviso che aggiorna un avviso precedente deve utilizzare <msgType>Update</msgType> e impostare <references>code</references> su tutti i messaggi correlati precedenti che non hanno raggiunto la data <expires>.
L'aggiornamento o l'annullamento deve essere applicato a un avviso non scaduto.
Esistono tre modi per ANNULLARE gli eventi, in ordine di preferenza:
- Imposta una data e un'ora
<expires>per ogni evento, con la descrizione del messaggio che indica che questo avviso terminerà autonomamente. - Emetti un nuovo
<alert>con<msgType>UPDATE,<responseType>"All Clear"e<expires>a breve. - Emettere un nuovo
<alert>con<msgType>CANCEL.
Per esempi, consulta la pagina Avvisi di esempio per aggiornamenti e cancellazioni.
Supporto di più lingue
Crea un <alert> contenente più blocchi <info> (un blocco <info> per lingua).
Per ulteriori dettagli e un esempio di avviso multilingue, consulta Più lingue.