info

Die <info>-Entität gibt die Details der Benachrichtigung an. Für eine Benachrichtigung ist mindestens ein <info>-Block erforderlich. Wenn du mehrere Sprachen unterstützt, empfehlen wir, pro Sprache einen <info>-Block für dieselbe <alert>-Entität zu verwenden.

info-Entitätselemente

In der folgenden Tabelle werden die Werte der Unterelemente für die Entität <info> beschrieben:

Elementname Optionalität Typ CAP und Google-Notizen und -Anforderungen
<language> OPTIONAL language

Für den Codewert <language> empfehlen wir die Verwendung eines gültigen RFC 3066-Codes.

Wenn das Element <language> nicht vorhanden ist, ist der Standardwert en-US.
<category> ERFORDERLICH InfoCategory Der Code <category> gibt die Kategorie des Betreffereignisses der Meldung an. Die richtigen Kategorien für Ihre Ereignisse finden Sie in der Liste der Nutzungsbedingungen für OASIS. Durch die ordnungsgemäße Kategorisierung kann Google die Benachrichtigung genauer darstellen.
<event> ERFORDERLICH string

Das Element <event> gibt den Typ des Betreffereignisses der Benachrichtigung an.

Die Google-Anforderungen für das <event>-Element lauten folgendermaßen:

  • Die Länge sollte weniger als 35 Zeichen betragen.
  • Listen Sie vordefinierte <event>-Typen in einer CSV- oder Google-Tabelle auf (siehe Google Tabellen-Beispiel).
<responseType> OPTIONAL responseType

Um die für die richtige Zielgruppe empfohlene Aktion anzugeben, empfehlen wir dringend, ein <responseType>-Element und den entsprechenden <instruction>-Elementwert anzugeben.
<urgency> ERFORDERLICH urgency

Verwenden Sie für das Element <urgency> nicht den Wert „Unbekannt“, da dies die Indexierung von Benachrichtigungen und relativen Rängen erschwert.

Für Google ist es wichtig zu wissen, wie und von wem das Feld <urgency> festgelegt wird. Diese Informationen werden jedoch nicht vom formalen Profil abgedeckt.

Vorzugsweise legt der Publisher den Wert <urgency> von Fall zu Fall fest und folgt klaren Trigger-Richtlinien. Ein <event>-Element kann jedoch den Wert von <urgency> korrigieren und damit die Flexibilität der Benachrichtigungsautoren reduzieren. In den USA legt die NOAA beispielsweise die Dringlichkeit je nach Ereignistyp statisch fest.
<severity> ERFORDERLICH severity

Verwenden Sie für das Element <severity> nicht den Wert „Unbekannt“, da dies die Indexierung von Benachrichtigungen und relativen Rängen erschwert.

Für Google ist es wichtig zu wissen, wie und von wem das Feld <severity> festgelegt wird. Diese Informationen werden jedoch nicht vom formalen Profil abgedeckt.

Vorzugsweise legt der Publisher den Wert <severity> von Fall zu Fall fest und folgt klaren Trigger-Richtlinien. Ein <event>-Element kann jedoch den Wert von <severity> korrigieren und damit die Flexibilität der Benachrichtigungsautoren reduzieren. In den USA legt die NOAA beispielsweise die Dringlichkeit je nach Ereignistyp statisch fest.
<certainty> ERFORDERLICH certainty

Verwenden Sie für das Element <certainty> nicht den Wert „Unbekannt“, da dies die Indexierung von Benachrichtigungen und relativen Rängen erschwert.

Für Google ist es wichtig zu wissen, wie und von wem das Feld <certainty> festgelegt wird. Diese Informationen werden jedoch nicht vom formalen Profil abgedeckt.

Vorzugsweise legt der Publisher den Wert <certainty> von Fall zu Fall fest und folgt klaren Trigger-Richtlinien. Ein <event>-Element kann jedoch den Wert von <certainty> korrigieren und damit die Flexibilität der Benachrichtigungsautoren reduzieren. In den USA legt die NOAA beispielsweise die Dringlichkeit je nach Ereignistyp statisch fest.
<audience> OPTIONAL string Der Wert des Elements <audience> ist Text, der die Zielgruppe der Benachrichtigung beschreibt.
<eventCode> OPTIONAL string

Das Element <eventCode> enthält einen systemspezifischen Code, der den Ereignistyp der Meldung im folgenden Formular identifiziert.

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

wobei

  • valueName = ein vom Nutzer zugewiesener String, der die Domain des Codes angibt Wenn diese Strings Akronyme sind, müssen Sie sie in Großbuchstaben und ohne Punkte darstellen. Beispiele sind SAME, FIPS und ZIP.
  • value = Ein String, der den Wert des Elements <eventCode> angibt.

Innerhalb eines <info>-Blocks können mehrere Instanzen von <eventCode>-Elementen auftreten.

Wir empfehlen dir dringend, die <eventCode>-Elementwerte aus der Liste der Nutzungsbedingungen für OASIS abzurufen. Wenn Sie die OASIS-Ereignisbegriffsliste verwenden, verwenden Sie OET:v1.0 als Wertnamen, wie in diesem Beispiel gezeigt:

        <eventCode>
          <valueName>OET:v1.0</valueName>
          <value>OET-003</value>
        </eventCode>
<effective> OPTIONAL dateTime

Der Wert des Elements <effective> ist der effektive Zeitpunkt der Informationen in der Benachrichtigung.

In alle dateTime-Werte müssen Zeitzonenfelder angegeben werden. Wenn der mit dem <area>-Block angegebene Standort innerhalb einer einzelnen Zeitzone liegt, empfehlen wir, das <effective>-Element die Zeit in dieser Zone anzugeben. Geben Sie ggf. einen Zulassungszeitraum für die Sommerzeit an.

Wenn der Inhalt einer Nachricht in mehreren Zeitzonen angewendet wird, empfehlen wir, dass der Ersteller der Nachricht UTC-Zeiten und keine lokalen Zeiten berücksichtigt.

Example:

2002-05-24T16:49:00-07:00 steht für den 24. Mai 2002 um 16:49 Uhr (PDT).
<onset> OPTIONAL dateTime

Der Wert des Elements <onset> ist die erwartete Zeit, zu der das Subjektereignis der Benachrichtigung beginnt. In alle dateTime-Werte müssen Zeitzonenfelder angegeben werden.

Wenn der mit dem <area>-Block angegebene Standort innerhalb einer einzelnen Zeitzone liegt, empfiehlt es sich, das <effective>-Element die Zeit in dieser Zone anzugeben. Geben Sie gegebenenfalls einen Zeitraum für die Sommerzeit an.

Wenn der Inhalt einer Nachricht in mehreren Zeitzonen angewendet wird, empfehlen wir, dass der Ersteller der Nachricht UTC-Zeiten und keine lokalen Zeiten berücksichtigt.

Example:

2002-05-24T16:49:00-07:00 steht für den 24. Mai 2002 um 16:49 Uhr (PDT).
<expires>

ERFORDERLICH*

 dateTime

Der Wert des Elements <expires> ist die Ablaufzeit des Betreffereignisses der Benachrichtigung. Ein <expires>-Element muss in zeitlicher Reihenfolge nach einem <effective>-Element eingefügt werden.

Wenn Sie keine Ablaufzeit für alle Benachrichtigungen festlegen können, geben Sie Google eine Standardablaufzeit für Benachrichtigungen an, die kein <expires>-Element haben. Sie können beispielsweise festlegen, dass alle Ihre Benachrichtigungen standardmäßig nach 48 Stunden ablaufen, wenn kein <expires>-Element vorhanden ist.

In alle dateTime-Werte müssen Zeitzonenfelder angegeben werden. Wenn der mit dem <area>-Block angegebene Standort innerhalb einer einzelnen Zeitzone liegt, empfehlen wir, das <effective>-Element die Zeit in dieser Zone anzugeben. Geben Sie ggf. einen Zulassungszeitraum für die Sommerzeit an.

Wenn der Inhalt einer Nachricht in mehreren Zeitzonen angewendet wird, empfehlen wir, dass der Ersteller der Nachricht UTC-Zeiten und keine lokalen Zeiten berücksichtigt.

Example:

2002-05-24T16:49:00-07:00 steht für den 24. Mai 2002 um 16:49 Uhr (PDT).
<senderName> OPTIONAL string

Ein <senderName>-Element ist optional, wird aber dringend empfohlen.

Wenn der Absender einen für Menschen lesbaren Namen hat, kann der <web>-Link gemäß den Einstellungen des Publishers oder Absenders nutzerfreundlich angezeigt werden. Darüber hinaus können Benachrichtigungsaggregatoren mithilfe des Elements <senderName> von mehreren Behörden veröffentlichen.
<headline> OPTIONAL string

Die Länge der <headline>-Elementstrings muss unter 140 Zeichen liegen.

Ein <headline>-String kann offener Text sein, wir empfehlen jedoch, dass er weniger als 140 Zeichen umfasst. Bei SMS 1.2 sind es maximal 160. Beginnen Sie diesen String mit einigen beschreibenden Wörtern, die den Kern der Benachrichtigung erklären. Ein Beispiel ist "Brückenbrücke schließen".

Verwenden Sie für die Elemente <headline> und <description> nicht dieselben Werte. Gib mehr Details im <description>-Element an als im <headline>-Element.
<description>

ERFORDERLICH*

 string

Der Wert des Elements <description> ist Text, der den Betreff des Ereignisses in der Benachrichtigung beschreibt.

Wir empfehlen, für Menschen lesbare und informative Inhalte zu folgenden Themen zu beantworten:

  • Was bedeutet das?
  • Wo ist die Veranstaltung?
  • Wie schlimm ist es?

Google verwendet das Element <description>, um den Bereich Nachricht auf unserer Seite auszufüllen, und das Element <instruction>, um den Bereich Empfohlene Aktionen zu füllen. Beide Felder sind für Nutzer sichtbar.

Du kannst diese unterstützten Markdown-Tags verwenden: <newline>, <b> und <a href>.
<instruction> OPTIONAL string

Der Wert des Elements <instruction> ist Text, der die empfohlenen Aktionen für die Empfänger der Benachrichtigung beschreibt. Wir empfehlen, für Menschen lesbare und informative Inhalte zu verwenden.

Listen Sie Aktionen auf, die dem Schweregrad der Benachrichtigung entsprechen und nicht allgemein sind. Verwende prägnante Sätze, bei denen die Groß-/Kleinschreibung beachtet werden muss, und füge Sicherheitstipps hinzu, mit denen Leser aktiv handeln können. Der wichtigste Tipp ist zuerst.

Das <instruction>-Element ist optional, wird aber dringend empfohlen. Für Google Warnungen wird das Feld <instruction> verwendet, um den Bereich Empfohlene Aktionen auf den Detailseiten von Benachrichtigungen auszufüllen. Die Feldwerte <instruction> und <description> sollten sich unterscheiden, weil sie unterschiedlichen Zwecken dienen.
<web>

ERFORDERLICH*

 string

Verknüpfe das <web>-Element mit einer Kopie der ursprünglichen Benachrichtigung, die auf deinem Webserver zugänglich ist.
<contact> OPTIONAL string

Das Feld <contact> ist optional. Wir empfehlen jedoch dringend, es anzugeben, damit Nutzer Feedback geben und auf die Benachrichtigung reagieren können. Beispiel: „Bei Notrufen wählen Sie den Notruf.“
<parameter> OPTIONAL string

Das Element <parameter> enthält systemspezifische Daten in der folgenden Form:

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

wobei

valueName = ein vom Nutzer zugewiesener String, der die Domain des Codes angibt

value = Ein Stringwert.

Innerhalb eines <info>-Blocks können mehrere Instanzen eines <parameter>-Elements auftreten.
<resource> OPTIONAL resource

Das <resource>-Element stellt zusätzliche ergänzende Informationen zum übergeordneten <info>-Element bereit. Innerhalb eines <info>-Blocks können mehrere Instanzen eines <resource>-Elements auftreten.
<area>

ERFORDERLICH*

 area

Das <area>-Element enthält Informationen zum Benachrichtigungsbereich des Ereignisses, nicht zum Ereignisbereich. <area>-Blöcke müssen mindestens ein <circle>-, <polygon>- oder <geocode>-Element enthalten.

Wir empfehlen dringend, statt eines <geocode>-Elements ein <polygon>- oder <circle>-Element zu verwenden.

* Google verlangt Elemente mit der Fett- und Rotoption ERFORDERLICH, die im CAP-Standard optional sind.

Beispiel

<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>