informacje

Element <info> określa szczegóły alertu. Wymagany jest co najmniej 1 blok <info> do alertu. Jeśli obsługujesz wiele języków, zalecamy użycie po 1 bloku <info> dla każdego języka w przypadku tego samego elementu <alert>.

Elementy info

W tabeli poniżej przedstawiono wartości podelementów dla elementu <info>:

Nazwa elementu Opcjonalność Typ Wskazówki i wymagania dotyczące Google i CAP
<language> OPCJONALNE language

W przypadku wartości kodu <language> zalecamy użycie prawidłowego kodu RFC 3066.

Jeśli element <language> jest nieobecny, domyślną wartością jest en-US.
<category> WYMAGANE InfoCategory Kod <category> oznacza kategorię zdarzenia będącego tematem wiadomości z alertem. Aby określić odpowiednie kategorie zdarzeń, zapoznaj się z listą terminów OASIS. Właściwa kategoryzacja może pomóc Google w dostarczanie użytkownikom bardziej dokładnych alertów.
<event> WYMAGANE string

Element <event> wskazuje typ zdarzenia będącego tematem wiadomości alertu.

Wymagania Google dotyczące elementu <event>:

  • Musi zawierać mniej niż 35 znaków.
  • Wymień zbiór zdefiniowanych wstępnie typów <event> w pliku CSV lub arkuszu kalkulacyjnym Google (patrz przykład arkusza Google).
<responseType> OPCJONALNE responseType

Aby wskazać rodzaj działania zalecanego dla odpowiedniej grupy odbiorców, zalecamy użycie elementu <responseType> oraz odpowiadającej mu wartości elementu <instruction>.
<urgency> WYMAGANE urgency

Nie używaj wartości Nieznana dla elementu <urgency>, ponieważ utrudnia to indeksowanie alertów i względnych pozycji.

Ważne jest, aby Google wiedziało, jak i przez kogo zostało ustawione pole <urgency>. Te informacje wykraczają jednak poza zakres formalnego profilu.

Najlepiej, jeśli wydawca ustawia wartość <urgency> w każdej sytuacji zgodnie z jasnymi wytycznymi dotyczącymi wyzwalaczy. Element <event> może jednak ustalić wartość <urgency>, co ogranicza elastyczność autorów alertów. Na przykład amerykańska NOAA ustawia pilność statyczną w zależności od typu zdarzenia.
<severity> WYMAGANE severity

Nie używaj wartości Nieznana dla elementu <severity>, ponieważ utrudnia to indeksowanie alertów i względnych pozycji.

Ważne jest, aby Google wiedziało, jak i przez kogo zostało ustawione pole <severity>. Te informacje wykraczają jednak poza zakres formalnego profilu.

Najlepiej, jeśli wydawca ustawia wartość <severity> w każdej sytuacji zgodnie z jasnymi wytycznymi dotyczącymi wyzwalaczy. Element <event> może jednak ustalić wartość <severity>, co ogranicza elastyczność autorów alertów. Na przykład amerykańska NOAA ustawia pilność statyczną w zależności od typu zdarzenia.
<certainty> WYMAGANE certainty

Nie używaj wartości Nieznana dla elementu <certainty>, ponieważ utrudnia to indeksowanie alertów i względnych pozycji.

Ważne jest, aby Google wiedziało, jak i przez kogo zostało ustawione pole <certainty>. Te informacje wykraczają jednak poza zakres formalnego profilu.

Najlepiej, jeśli wydawca ustawia wartość <certainty> w każdej sytuacji zgodnie z jasnymi wytycznymi dotyczącymi wyzwalaczy. Element <event> może jednak ustalić wartość <certainty>, co ogranicza elastyczność autorów alertów. Na przykład amerykańska NOAA ustawia pilność statyczną w zależności od typu zdarzenia.
<audience> OPCJONALNE string Wartością elementu <audience> jest tekst opisujący docelowych odbiorców wiadomości alertu.
<eventCode> OPCJONALNE string

Element <eventCode> zawiera kod specyficzny dla systemu, który identyfikuje typ zdarzenia wiadomości o ostrzeżeniu w podanej formie.

        <eventCode>
          <valueName>valueName</valueName>
          <value>value</value>
        </eventCode>

gdzie:

  • valueName = ciąg znaków przypisany przez użytkownika, który wyznacza domenę kodu. Jeśli ciągi znaków są akronimami, zapisz je wielkimi literami bez kropek. Przykłady to SAME, FIPS i ZIP.
  • value = ciąg znaków oznaczający wartość elementu <eventCode>.

W bloku <info> może wystąpić wiele wystąpień elementów <eventCode>.

Zdecydowanie zalecamy pobranie wartości elementów <eventCode> z listy warunków dotyczących zdarzeń OASIS. Jeśli używasz listy terminów zdarzeń OASIS, jako nazwy wartości użyj wartości OET:v1.2, jak w tym przykładzie:

        <eventCode>
          <valueName>OET:v1.2</valueName>
          <value>OET-003</value>
        </eventCode>
<effective> OPCJONALNE dateTime

Wartość elementu <effective> to czas obowiązywania informacji w komunikacie ostrzegawczym.

W przypadku wszystkich wartości dateTime musisz uwzględnić pola strefy czasowej. Jeśli lokalizacja podana w bloku <area> znajduje się w jednej strefie czasowej, zalecamy, aby element <effective> określał czas w tej strefie. W razie potrzeby uwzględnij czas letni.

Jeśli treść wiadomości dotyczy wielu stref czasowych, zalecamy, aby producent wiadomości używał czasu UTC zamiast czasu lokalnego.

Przykład:

2002-05-24T16:49:00-07:00 to 24 maja 2002 r., 16:49 PDT.
<onset> OPCJONALNE dateTime

Wartość elementu <onset> to przewidywany czas rozpoczęcia zdarzenia będącego tematem wiadomości z alertem. W przypadku wszystkich wartości dateTime musisz uwzględnić pola strefy czasowej.

Jeśli lokalizacja podana w bloku <area> znajduje się w jednej strefie czasowej, zalecamy, aby element <effective> określał czas w tej strefie. W razie potrzeby uwzględnij czas letni.

Jeśli treść wiadomości dotyczy wielu stref czasowych, zalecamy, aby producent wiadomości używał czasu UTC zamiast czasu lokalnego.

Przykład:

2002-05-24T16:49:00-07:00 to 24 maja 2002 r., 16:49 PDT.
<expires>

WYMAGANE*

 dateTime

Wartość elementu <expires> to czas wygaśnięcia zdarzenia będącego tematem wiadomości ostrzeżenia. Element <expires> musi być umieszczony po elemencie <effective> w porządku chronologicznym.

Jeśli nie możesz ustawić czasu ważności dla wszystkich alertów, podaj Google domyślny czas ważności dla alertów, które nie mają elementu <expires>. Możesz na przykład określić, że domyślnie wszystkie alerty wygasają po 48 godzinach, jeśli nie ma elementu <expires>.

W przypadku wszystkich wartości dateTime musisz uwzględnić pola strefy czasowej. Jeśli lokalizacja podana w bloku <area> znajduje się w jednej strefie czasowej, zalecamy, aby element <effective> określał czas w tej strefie. W razie potrzeby uwzględnij czas letni.

Jeśli treść wiadomości dotyczy wielu stref czasowych, zalecamy, aby producent wiadomości używał czasu UTC zamiast czasu lokalnego.

Przykład:

2002-05-24T16:49:00-07:00 to 24 maja 2002 r., 16:49 PDT.
<senderName> OPCJONALNE string

Element <senderName> jest opcjonalny, ale zdecydowanie zalecany.

Jeśli nadawca ma czytelną nazwę, link <web>może być wyświetlany w przyjazny dla użytkownika sposób zgodnie z ustawieniami wydawcy lub nadawcy. Dodatkowo element <senderName>umożliwia agregatorom alertów publikowanie informacji z różnych instytucji.
<headline> OPCJONALNE string

Długość ciągów znaków elementów <headline> musi być mniejsza niż 140 znaków.

Ciąg znaków <headline> może być tekstem otwartym, ale zalecamy, aby zawierał mniej niż 140 znaków. (CAP 1.2 sugeruje, że w przypadku wiadomości tekstowych należy użyć mniej niż 160 znaków). Zacznij od kilku słów opisowych, które opisują istotę alertu. Przykład: „Pontoon bridge closure...”.

Nie używaj tych samych wartości w elementach <headline> i <description>. W elemencie <description> podaj więcej szczegółów niż w elemencie <headline>.
<description>

WYMAGANE*

 string

Wartością elementu <description> jest tekst opisujący temat zdarzenia, które spowodowało wysłanie wiadomości z alertem.

Zalecamy treści przystępne dla człowieka i zawierające informacje, które odpowiadają na te pytania:

  • Co się dzieje lub ma wydarzyć?
  • Gdzie to się dzieje?
  • Jak bardzo jest źle?

Google używa elementu <description> do wypełniania sekcji Wiadomość na stronie, a elementu <instruction> do wypełniania sekcji Zalecane działania. Oba pola są widoczne dla użytkowników.

Możesz używać tych obsługiwanych tagów Markdown:<newline>, <b> i <a href>.
<instruction> OPCJONALNE string

Wartością elementu <instruction> jest tekst opisujący zalecane działania dla odbiorców wiadomości z alertem. Zalecamy, aby treści były zrozumiałe dla ludzi i zawierały przydatne informacje.

Wymień działania, które pasują do poziomu wagi alertu i nie są ogólne. Używaj zwięzłych zdań z uwzględnieniem wielkości liter i podawaj wskazówki dotyczące bezpieczeństwa, z których czytelnicy mogą skorzystać. Najważniejsza wskazówka powinna być podana jako pierwsza.

Element <instruction> jest opcjonalny, ale zdecydowanie zalecamy jego użycie. Komunikaty alarmowe Google używają pola <instruction> do wypełniania sekcji Zalecane działania na stronach ze szczegółami alertów. Wartości pól <instruction> i <description> powinny być różne, ponieważ służą do różnych celów.
<web>

OPCJONALNE

 string

Połącz element <web> z działającym adresem URL, który zawiera więcej informacji o alertach.
<contact> OPCJONALNE string

Pole <contact> jest opcjonalne, ale zdecydowanie zalecamy jego wypełnienie, ponieważ umożliwia użytkownikom przesyłanie opinii i reagowanie na alert. Na przykład: „W nagłych wypadkach zadzwoń pod numer 911”.
<parameter> OPCJONALNE string

Element <parameter> zawiera dane dotyczące systemu w tym formacie:

        <parameter>
          <valueName>valueName</valueName>
          <value>value</value>
        </parameter>

gdzie:

valueName = ciąg znaków przypisany przez użytkownika, który wyznacza domenę kodu.

value = wartość ciągu znaków.

W bloku <info> może wystąpić wiele wystąpień elementu <parameter>.
<resource> OPCJONALNE resource

Element <resource> zawiera dodatkowe informacje dotyczące elementu nadrzędnego <info>. W bloku <info> może wystąpić wiele wystąpień elementu <resource>.
<area>

WYMAGANE*

 area

Element <area> zawiera informacje o obszarze alertu zdarzenia, a nie obszarze incydentu. Bloki <area> muszą zawierać co najmniej jeden element z tych: <circle>, <polygon> lub <geocode>.

Zdecydowanie zalecamy używanie elementu <polygon> lub <circle> zamiast elementu <geocode>.

* Google wymaga elementów oznaczonych pogrubioną i czerwoną czcionką jako wymagane, ale w standardzie CAP są one opcjonalne.

Przykład

<info>
    <language>en-CA</language>
    <category>Met</category>
    <event>blowing snow</event>
    <responseType>Monitor</responseType>
    <urgency>Future</urgency>
    <severity>Moderate</severity>
    <certainty>Possible</certainty>
    <audience>general public</audience>
    <eventCode>
        <valueName>profile:CAP-CP:Event:0.4</valueName>
        <value>blowingSnow</value>
    </eventCode>
    <effective>2023-04-13T23:16:53-00:00</effective>
    <expires>2023-04-14T15:11:38-00:00</expires>
    <senderName>Environment Canada</senderName>
    <headline>blowing snow advisory in effect</headline>
    <description>
    Periods of poor visibility in blowing snow.

    When: Tonight through this weekend.

    Impacts: Poor visibility due to blowing snow.

    Remarks: Strong easterly winds are expected to continue through the
    Richardson Mountains through at least this weekend. Gusty northeasterly
    winds are also possible near the Ogilvie Mountains during the same
    timeframe. These strong winds will likely generate periods of blowing
    snow through the mountain passes and visibility will at times be
    significantly reduced.
    </description>
    <instruction>Be prepared to adjust your driving with changing road
    conditions.</instruction>
    <web>http://weather.gc.ca/warnings/index_e.html?prov=yt</web>
    <area>
        <areaDesc>Dempster</areaDesc>
        <polygon>65.4581,-137.8443 64.3417,-137.8311 64.3385,
        -137.911 64.3497,-138.0022 64.415,-138.4948 64.5198,-138.9891 65.53,
        -139.0095 66.6721,-137.1316 67.0102,-136.6048 67.1424,
        -136.3737 67.2766,-136.136 67.2657,-135.9251 67.1757,-136.0889 67.0,
        -136.012 67.0,-135.9999 67.0133,-135.4962 67.0,-134.9833 65.4581,
        -137.8443</polygon>
        <geocode>
            <valueName>layer:EC-MSC-SMC:1.0:CLC</valueName>
            <value>093100</value>
        </geocode>
        <geocode>
            <valueName>profile:CAP-CP:Location:0.3</valueName>
            <value>6001045</value>
        </geocode>
    </area>
</info>