Anforderungen für Google CAP

Ihre Benachrichtigungsdaten sollten der Spezifikation des Common Benachrichtigung Protocol v1.2 von OASIS, der Spezifikation Google-Benachrichtigungen für CAP v1.0 und zusätzlichen unten aufgeführten Anforderungen entsprechen.

Über Google CAP

Der CAP-Standard definiert die Grundstruktur und die Datenelemente für eine CAP-Benachrichtigung, lässt jedoch erheblichen Raum für Inkonsistenzen bei der Verwendung der verschiedenen Datenelemente.

Unser Ziel ist es, die Suche nach Notfallinformationen zu vereinfachen. Dazu werden hochwertige, relevante Daten in Online-Tools zusammengeführt, die von Nutzern bereits täglich genutzt werden. Die zusätzlichen Anforderungen sollen die Reichweite und Wirksamkeit Ihrer Warnungen in Google-Produkten maximieren.

Die Google-spezifischen Unterschiede zu den CAP 1.2-XML-Anforderungen sind in der Spezifikation Google Public Alerts CAP v1.0 zusammengefasst.

Mit der Option „Google Warnungen“ CAP im Open-Source-CAP-Validator können Sie Ihre Daten anhand der OASIS-Spezifikation und der zusätzlichen Anforderungen von Google validieren.

Die folgenden Richtlinien gelten für alle Arten von Warnungen und Gefahren. Im Abschnitt Beispiele haben wir einige zusätzliche Anforderungen und Empfehlungen für die jeweiligen Benachrichtigungstypen zusammengestellt:

Regelmäßige Tests durchführen

  • Mit <status>Tests</status> kann dein System Benachrichtigungen veröffentlichen, um regelmäßige End-to-End-Systemtests durchzuführen.

Ziel-Benachrichtigungsbereiche

  • Wenn sich nicht zusammenhängende Bereiche unter derselben Benachrichtigungsstufe und desselben Typs befinden, erstellen Sie separate <alert>-Nachrichten anstelle einer einzelnen <alert> mit getrennten Bereichen.
  • Wenn das <area>-Element <polygon>-Elemente enthält, achten Sie darauf, dass es gültige Polygone ohne einander überschneidende Kanten enthält, und legen Sie eine Genauigkeit von maximal 6 Dezimalstellen fest.
  • Wenn das <area>-Element deiner Benachrichtigungen Geocodes enthält, gib die Geodaten im Format shapefile an und informiere Google mindestens 30 Tage vor der Änderung von Shapefile-Dateien unter google-public-alerts@google.com.
  • Zeichnen Sie nach Möglichkeit wirkungsbasierte Polygone, die an die aktuellen Bedingungen und die Natur des Ereignisses angepasst sind, anstatt Benachrichtigungen auf vordefinierte geopolitische Gebiete (z.B. Provinzen, Bezirke) auszurichten.
  • Geben Sie Google eine kurze Beschreibung (weniger als 50 Zeichen) des betroffenen Bereichs in <areaDesc> oder in einer separaten speziellen <parameter> Ihrer CAP-Benachrichtigungen an. Dieser Text wird im Titel der Benachrichtigung angezeigt.

Rich Content einschließen

  • Fügen Sie den Elementen <description> und <instruction> umfassende, umsetzbare und für Menschen lesbare Inhalte hinzu.
  • Beschreiben Sie das aktuelle Ereignis, die voraussichtlichen Entwicklungen, die voraussichtlichen Auswirkungen und die Empfehlungen.
  • Achten Sie auf korrekte Rechtschreibung, Grammatik und Zeichensetzung.
  • Verwende reinen Text oder Markdown zur besseren Lesbarkeit von Inhalten anstelle von HTML-Tags.
  • Geben Sie RGB- oder Hex-Farbcodes entsprechend der Benachrichtigungsstufe an. Sie können auch offline an Google gesendet werden.

Benachrichtigungen aktualisieren

Wenn sich eine Benachrichtigung ändert, erstellen Sie eine neue Benachrichtigung, die auf die vorherige Benachrichtigung verweist, anstatt die vorhandene Benachrichtigung aus Ihrem Feed zu ändern oder zu entfernen. Entfernen Sie innerhalb eines angemessenen Zeitraums (z.B. 24–48 Stunden) stornierte, aktualisierte oder abgelaufene Benachrichtigungen aus Ihrem Feed.

<msgType> UPDATE oder CANCEL muss mindestens ein <references>-Element enthalten. Gemäß CAP-Standard müssen alle Benachrichtigungen, mit denen eine vorherige Benachrichtigung aktualisiert wird, <msgType>Update</msgType> verwenden und <references>code</references> auf alle vorherigen ähnlichen Nachrichten festlegen, deren <expires>-Datum noch nicht erreicht wurde. Für eine nicht abgelaufene Benachrichtigung muss UPDATE oder CANCEL gelten.

Es gibt drei Möglichkeiten, Termine in der Reihenfolge ihrer Termine abzusagen:

  1. Legen Sie für jedes Ereignis ein Datum und eine Uhrzeit (<expires>) fest. Legen Sie in der Nachrichtenbeschreibung fest, dass diese Benachrichtigung automatisch beendet wird.
  2. Du kannst demnächst eine neue <alert> mit <msgType>UPDATE, <responseType>"All Clear" und <expires> ausstellen.
  3. Geben Sie ein neues <alert> mit <msgType>CANCEL aus.

Beispiele finden Sie in unseren Beispielbenachrichtigungen für Updates und Kündigungen.

Unterstützung mehrerer Sprachen

Erstellen Sie einen <alert> mit mehreren <info>-Blöcken (ein <info>-Block pro Sprache).

Weitere Informationen und ein Beispiel für eine mehrsprachige Benachrichtigung finden Sie unter Mehrere Sprachen.