I dati degli avvisi devono rispettare la specifica OASIS Common Alerting Protocol v1.2, nonché la specifica Google Public Alert CAP v1.0 e i requisiti aggiuntivi indicati di seguito.
Informazioni su Google CAP
Lo standard CAP stabilisce la struttura di base e gli elementi dei dati per un avviso CAP, ma lascia comunque un notevole margine di incoerenza nel modo e nel quando vengono utilizzati i vari elementi di dati.
Lo scopo della nostra piattaforma è semplificare le procedure per la ricerca di informazioni per le emergenze riunendo all'interno di strumenti online dati pertinenti e di alta qualità che le persone utilizzano già ogni giorno. I requisiti aggiuntivi sono pensati per massimizzare la copertura e l'efficacia degli avvisi sui prodotti Google.
Le differenze specifiche di Google con i requisiti XML di CAP 1.2 sono riassunte nella specifica Google Public Alert CAP v1.0.
L'opzione "CAP" di Google Allerte nello strumento open source Convalida del CAP consente di convalidare i dati in base alle specifiche OASIS e 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 aggiuntivi e consigli per questi tipi di avvisi specifici nella sezione Esempi:
Eseguire test periodici
- Assicurati che il tuo sistema sia in grado di pubblicare avvisi con
<status>
Test</status>
per eseguire test regolari di end-to-end.
Aree di avviso target
- Se ci sono aree non contigue sotto lo stesso livello di avviso e lo stesso tipo, crea messaggi
<alert>
separati anziché<alert>
con aree separate. - Se l'elemento
<area>
contiene elementi<polygon>
, assicurati che i poligoni siano validi senza bordi intersecati e specifica un massimo di 6 punti decimali. - Se l'elemento
<area>
dei tuoi avvisi contiene codici geografici, fornisci il formato dati geografici in shapefile e comunica a Google l'indirizzo google-public-alerts@google.com almeno 30 giorni prima della modifica. - Disegna poligoni basati sull'impatto personalizzati in base alle condizioni attuali e alla natura dell'evento, se possibile, anziché indirizzare gli avvisi ad aree geopolitiche predefinite (ad es. province, distretti).
- Fornisci a Google una breve descrizione (meno di 50 caratteri) dell'area interessata in
<areaDesc>
o in un<parameter>
dedicato dei tuoi avvisi CAP. Questo testo verrà visualizzato nel titolo dell'avviso.
Includere contenuti avanzati
- Includere contenuti avanzati e strategici e leggibili negli elementi
<description>
e<instruction>
. - Descrivi l'evento corrente, gli sviluppi previsti, l'impatto previsto e i suggerimenti, se applicabili.
- Usa l'ortografia, la grammatica e la punteggiatura corrette.
- Utilizza testo normale o markdown per migliorare la leggibilità dei tuoi contenuti anziché i tag HTML.
- Fornisci codici colore RGB o esadecimale corrispondenti a ciascun livello di avviso (che puoi fornire a Google offline).
Aggiornare gli avvisi
Quando un avviso cambia, emetti un nuovo avviso che faccia riferimento all'avviso precedente, anziché modificare o rimuovere l'avviso esistente dal feed. Dopo un determinato periodo di tempo (ad es. 24-48 ore), rimuovi gli avvisi annullati, aggiornati o scaduti dal tuo feed.
L'opzione <msgType>
AGGIORNA o ANNULLA deve includere almeno un elemento <references>
.
Come specificato nello standard CAP, i messaggi di avviso che aggiornano un avviso precedente devono utilizzare <msgType>Update</msgType>
e impostare <references>code</references>
su tutti i messaggi correlati precedenti che non hanno raggiunto la loro data di <expires>
. L'opzione AGGIORNA o ANNULLA deve essere applicata a un avviso non scaduto.
Esistono tre modi per ANNULLARE eventi, in ordine di preferenza:
- Imposta una data e un'ora
<expires>
per ogni evento, con la descrizione del messaggio in cui si prevede che questo avviso terminerà da solo. - Rilascia un nuovo
<alert>
con<msgType>UPDATE
,<responseType>"All Clear"
e<expires>
in breve nel futuro. - Rilascia un nuovo
<alert>
con<msgType>CANCEL
.
Consulta la nostra pagina Esempi di avvisi per aggiornamenti e annullamenti.
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, vedi Più lingue.