Twoje dane powinny być zgodne ze specyfikacją OASIS Common Alerting Protocol v1.2 oraz specyfikacją Google Public Alert CAP 1.0 oraz dodatkowymi wymaganiami opisanymi poniżej.
Google CAP – informacje
Standard CAP określa podstawową strukturę i elementy danych dla alertu CAP, ale pozostawia znaczną ilość niespójności w sposobie stosowania i czasie stosowania różnych elementów danych.
Nasza platforma ma na celu uproszczenie procesu wyszukiwania informacji alarmowych dzięki gromadzeniu informacji o wysokiej jakości i trafności w narzędziach online, z których użytkownicy korzystają już codziennie. Dodatkowe wymagania mają na celu maksymalizację zasięgu i skuteczności alertów w usługach Google.
Różnice między wymaganiami Google w zakresie XML 1.2 zostały opisane w specyfikacji Google Public Alertów CAP 1.0.
Opcja &CAP Alertów publicznych Google dostępna w modelu open source CAP Walidator pozwoli Ci zweryfikować dane w sposób zgodny ze specyfikacją OASIS i dodatkowymi wymaganiami Google'.
Poniższe wskazówki dotyczą wszystkich typów alertów i zagrożeń. W sekcji Przykłady dodaliśmy kilka dodatkowych wymagań i zaleceń dotyczących tych typów alertów:
Przeprowadzaj okresowe testy
- Aby umożliwić kompleksowe przeprowadzanie testów systemowych, upewnij się, że Twój system może publikować alerty
<status>Test</status>.
Kierowanie na alerty
- Jeśli na tym samym poziomie alertu i rodzaju są obszary, które nie sąsiadują ze sobą, utwórz oddzielne wiadomości
<alert>zamiast jednego typu<alert>z oddzielonymi obszarami. - Jeśli element
<area>zawiera elementy<polygon>, upewnij się, że są one wielokątami prawidłowymi bez przecinających się krawędzi. Możesz też określić maksymalnie 6 miejsc po przecinku. - Jeśli element
<area>alertów zawiera dane geograficzne, prześlij dane geograficzne w formacie shapefile i powiadom Google o adresie google-public-alerts@google.com co najmniej 30 dni przed zmianą pliku kształtu. - Narysuj wielokąty oparte na wpływach, które są dostosowane do bieżących warunków i natury wydarzenia, jeśli jest to możliwe, zamiast kierować alerty na wstępnie zdefiniowane obszary geopolityczne (np. prowincje, okręgi).
- Udostępnij Google krótki (poniżej 50 znaków) opis obszaru, którego dotyczy problem, w
<areaDesc>lub w oddzielnych<parameter>alertach CAP. Ten tekst będzie wyświetlany w tytule alertu.
Uwzględnij treści rozszerzone
- W elementach
<description>i<instruction>uwzględnij obszerną, możliwą do odczytania przez człowieka treść. - Opisz aktualne wydarzenie, przewidywane zmiany, oczekiwany wpływ i rekomendacje.
- Popraw pisownię, gramatykę i interpunkcję.
- Użyj zwykłego tekstu lub znacznika, aby poprawić czytelność treści, a nie tagów HTML.
- Podaj kody RGB lub szesnastkowe odpowiadające poszczególnym poziomom alertów (możesz je przekazać do Google offline).
Aktualizowanie alertów
Gdy zmieni się alert, wygeneruj nowy alert, który będzie odnosił się do poprzedniego, zamiast zmieniać lub usuwać istniejący alert z pliku danych. Po odpowiednim czasie (np. 24–48 godzin) usuń anulowane, zaktualizowane lub wygasłe alerty z pliku danych.
<msgType> ZAKTUALIZUJ lub ANULUJ musi zawierać co najmniej 1 element <references>.
Zgodnie ze standardem CAP każda wiadomość, która wymaga zaktualizowania poprzedniego alertu, powinna używać wartości <msgType>Update</msgType> i ustawić w polu <references>code</references> wszystkie wcześniejsze wiadomości, które nie osiągnęły daty <expires>. Link „AKTUALIZUJ” lub „ANULUJ” musi dotyczyć alertu, którego ważność nie wygasła.
Wydarzenia możesz anulować na 3 sposoby:
- Ustaw sygnaturę czasową
<expires>dla każdego wydarzenia z opisem komunikatu, który zakłada, że ten alert wygaśnie. - Wywołaj nowe
<alert>z:<msgType>UPDATE,<responseType>"All Clear"i<expires>, za chwilę. - Wyemituj nowy znaczek
<alert>(<msgType>CANCEL).
Przykłady znajdziesz w przykładowych alertach dotyczących anulowania i anulowania.
Obsługa wielu języków
Utwórz jeden element <alert> zawierający wiele bloków <info> (jeden blok <info> na język).
Więcej informacji i przykładowy alert w wielu językach znajdziesz w artykule Wiele języków.