Dane alertów powinny być zgodne ze specyfikacją Common Alerting Protocol (CAP) w wersji 1.2 OASIS oraz specyfikacją Google Public Alerts CAP w wersji 1.0 oraz dodatkowymi wymaganiami opisanymi poniżej.
Informacje o Google CAP
Standard CAP określa podstawową strukturę i elementy danych alertu CAP, ale nadal pozostawia znaczne pole do niespójności w sposobie i czasie stosowania różnych elementów danych.
Nasze rozwiązanie ma na celu uproszczenie procesu znajdowania informacji o zdarzeniach nadzwyczajnych poprzez łączenie wysokiej jakości, trafnych danych w narzędziach internetowych, z których ludzie korzystają na co dzień. Dodatkowe wymagania mają na celu maksymalizację zasięgu i skuteczności alertów w usługach Google.
Różnice między wymaganiami XML CAP 1.2 a wymaganiami specyficznymi dla Google są opisane w specyfikacji Google Public Alerts CAP w wersji 1.0.
Opcja „Google Public Alerts CAP” w otwartym narzędziu CAPValidator umożliwia sprawdzanie danych pod kątem zgodności ze specyfikacją OASIS i dodatkowymi wymaganiami Google.
Poniższe wytyczne dotyczą wszystkich rodzajów alertów i zagrożeń. W sekcji Przykłady znajdziesz też kilka dodatkowych wymagań i zaleceń dotyczących tych typów alertów:
Przeprowadzaj okresowe testy
- Upewnij się, że Twój system jest w stanie publikować alerty z opcją
<status>Test</status>, aby regularnie przeprowadzać kompleksowe testy systemu.
Docelowe obszary alertów
- Jeśli w ramach tego samego poziomu i typu alertu występują obszary niesąsiadujące, utwórz osobne wiadomości
<alert>zamiast jednej wiadomości<alert>z obszarami niesąsiadującymi. - Jeśli element
<area>zawiera elementy<polygon>, sprawdź, czy są to prawidłowe wielokąty bez krawędzi przecinających się na siebie lub nachodzących na siebie, i określ dokładność do maksymalnie 6 cyfr po przecinku. - Jeśli element
<area>w Twoich alertach zawiera geokody, podaj dane geoprzestrzenne w formacie shapefile i poinformuj Google na adres google-public-alerts@google.com co najmniej 30 dni przed wprowadzeniem zmian w pliku shapefile. - Rysuj wielokąty oparte na wpływie, które są dostosowane do bieżących warunków i charakteru zdarzenia, zamiast kierować alerty do wstępnie zdefiniowanych obszarów geopolitycznych (np. województw czy okręgów).
- Podaj Google krótki (mniej niż 50 znaków) opis obszaru dotkniętego przez problem w polu
<areaDesc>lub w oddzielnym polu<parameter>w alertach CAP. Ten tekst będzie wyświetlany w tytule alertu.
Dołącz szczegółowe treści
- W elementach
<description>i<instruction>umieść treści, które są zrozumiałe dla człowieka i umożliwiają działanie. - Opisz bieżące zdarzenie, przewidywane zmiany, spodziewane skutki i zalecenia (w stosownych przypadkach).
- Tekst musi być poprawny pod względem ortograficznym, gramatycznym i interpunkcyjnym.
- Aby poprawić czytelność treści, zamiast tagów HTML używaj zwykłego tekstu.
- Podaj kody kolorów RGB lub szesnastkowych odpowiadające poszczególnym poziomom alertów (można je podać Google w trybie offline).
Aktualizowanie alertów
Gdy zmieni się alert, opublikuj nowy alert, który odnosi się do poprzedniego, zamiast zmieniać lub usuwać istniejący alert z kanału. Po odpowiednim czasie (do 2 tygodni) usuń nieaktualne alerty z pliku danych.
<msgType> UPDATE lub CANCEL musi zawierać co najmniej 1 element <references>.
Zgodnie ze standardem CAP każda wiadomość o ostrzeżeniu, która aktualizuje poprzednie ostrzeżenie, powinna używać wartości <msgType>Update</msgType> i ustawić wartość <references>code</references> dla wszystkich wcześniejszych powiązanych wiadomości, których data nie została jeszcze osiągnięta.<expires>
Opcja AKTUALIZUJ lub ANULOWAJ musi dotyczyć alertu, którego termin ważności nie upłynął.
Aby anulować zdarzenie, możesz wybrać jedną z 3 metod:
- Ustaw dla każdego zdarzenia datę i godzinę
<expires>, a w opisie wiadomości określ, kiedy alert ma się automatycznie wyłączyć. - W najbliższym czasie opublikujemy nową wersję
<alert>z uwzględnieniem<msgType>UPDATE,<responseType>"All Clear"i<expires>. - Wyślij nowe zgłoszenie
<alert>do<msgType>CANCEL.
Przykłady znajdziesz w przykładowych alertach o aktualizacjach i anulowaniach.
Obsługa wielu języków
Utwórz 1 element <alert> zawierający wiele bloków <info> (po 1 bloku <info> na język).
Więcej informacji i przykładowy alert wielojęzyczny znajdziesz w sekcji Wiele języków.