アラートデータは、OASIS の Common Alerting Protocol v1.2 の仕様に加え、Google Public Alerts CAP v1.0 の仕様と下記の追加要件に準拠している必要があります。
Google CAP について
CAP 標準では、CAP アラートの基本構造とデータ要素を定めていますが、さまざまなデータ要素をどのように、いつ使用するかについて、十分な不十分な余地が残されています。
Google のプラットフォームは、すでに日常的に使われているオンライン ツール内に、関連性の高い高品質のデータを集約することで、緊急情報を見つけるプロセスを簡素化することを目指しています。この追加要件は、Google サービスのアラートのリーチと効果を最大限に高めることを目的としています。
CAP 1.2 XML 要件に対する Google 固有の違いについては、Google Public Alerts CAP v1.0 の仕様をご覧ください。
オープンソースの CAP Validator の Google Public Alerts CAP" オプションを使用すると、OASIS の仕様と Google の追加要件の両方に基づいてデータを検証できます。
以下のガイドラインは、すべての種類のアラートと危険に適用されます。サンプル セクションには、アラートタイプごとに追加の要件と推奨事項をまとめています。
定期的なテストの実施
- 定期的にエンドツーエンドのシステムテストを行うために、
<status>
Test</status>
を使用してアラートをパブリッシュできることを確認してください。
アラートエリアをターゲットに設定する
- 同じアラートレベルとタイプの連続していない領域がある場合は、別々の
<alert>
を作成するのではなく、個別の<alert>
メッセージを作成します。 <area>
要素に<polygon>
要素が含まれている場合は、エッジが交差せずに有効なポリゴンであることを確認し、小数点以下 6 桁までの精度を指定してください。- アラートの
<area>
要素にジオコードが含まれている場合は、shapefile 形式で地理データを提供し、shapefile が変更される少なくとも 30 日前に Google(google-public-alerts@google.com)に通知してください。 - 事前定義の地政学的領域(州や地区など)へのアラートをターゲットにするのではなく、可能な限り現在の状況と出来事の性質に合わせてカスタマイズされた、影響ベースのポリゴンを描画します。
<areaDesc>
、または CAP アラート専用の<parameter>
で、対象地域の簡単な説明(50 文字未満)を Google に提供します。このテキストはアラートのタイトルに表示されます。
リッチ コンテンツを含める
<description>
要素と<instruction>
要素には、人間が読める形式のリッチなコンテンツを含めます。- 現在のイベント、予想される開発、予想される影響、推奨事項を記入します(該当する場合)。
- 正しいスペル、文法、句読点を使用してください。
- コンテンツの読みやすさを改善するには、HTML タグではなく、書式なしテキストまたはマークダウンを使用してください。
- 各アラートレベルに対応する RGB または 16 進数のカラーコードを指定します(Google にオフラインで提供できます)。
アラートの更新
アラートが変わった場合は、フィードから既存のアラートを変更または削除するのではなく、以前のアラートを参照する新しいアラートを発行します。適切な期間(24 ~ 48 時間など)が経過したら、フィードから、キャンセル済み、更新済み、期限切れのアラートを削除します。
<msgType>
UPDATE または CANCEL には、少なくとも 1 つの <references>
要素を含める必要があります。
CAP 標準で指定されているとおり、以前のアラートを更新するアラート メッセージでは、<msgType>Update</msgType>
を使用し、<references>code</references>
を、<expires>
の日付に到達していない過去のすべての関連メッセージに設定します。UPDATE または CANCEL は、有効期限のないアラートに適用する必要があります。
イベントをキャンセルする方法は、優先順に 3 通りあります。
- 各イベントの
<expires>
日時を設定し、メッセージの説明で、このアラートが単独で終了することを期待します。 - 今後、
<msgType>UPDATE
、<responseType>"All Clear"
、<expires>
を使用して、新しい<alert>
を発行します。 <msgType>CANCEL
で新しい<alert>
を発行します。
例については、更新とキャンセルに関するアラートのサンプルをご覧ください。
複数の言語のサポート
複数の <info>
ブロック(言語ごとに 1 つの <info>
ブロック)を含む <alert>
を 1 つ作成してください。
詳細と多言語アラートのサンプルについては、複数の言語をご覧ください。