Сущность <info>
определяет детали оповещения. Для оповещения необходим хотя бы один блок <info>
. Если вы поддерживаете несколько языков, мы рекомендуем использовать по одному блоку <info>
для каждого языка для одного и того же объекта <alert>
.
элементы info
сущности
В следующей таблице описаны значения подэлементов объекта <info>
:
Имя элемента | Опциональность | Тип | Примечания и требования CAP и Google |
---|---|---|---|
<language> | НЕОБЯЗАТЕЛЬНЫЙ | language | Для значения кода Если элемент |
<category> | НЕОБХОДИМЫЙ | InfoCategory | Код <category> обозначает категорию предметного события предупреждающего сообщения. Чтобы определить подходящие категории для ваших мероприятий, обратитесь к списку условий проведения мероприятий OASIS . Правильная категоризация может помочь Google более точно отображать оповещения пользователям. |
<event> | НЕОБХОДИМЫЙ | string | Элемент Требования Google к элементу
|
<responseType> | НЕОБЯЗАТЕЛЬНЫЙ | responseType | Чтобы обозначить тип действия, рекомендуемого для правильной аудитории, когда это применимо, мы настоятельно рекомендуем использовать элемент |
<urgency> | НЕОБХОДИМЫЙ | urgency | Не используйте значение Unknown для элемента Google важно знать, как и кем установлено поле Предпочтительно, чтобы издатель задавал значение |
<severity> | НЕОБХОДИМЫЙ | severity | Не используйте значение Unknown для элемента Google важно знать, как и кем установлено поле Предпочтительно, чтобы издатель задавал значение |
<certainty> | НЕОБХОДИМЫЙ | certainty | Не используйте значение Unknown для элемента Google важно знать, как и кем установлено поле Предпочтительно, чтобы издатель устанавливал значение |
<audience> | НЕОБЯЗАТЕЛЬНЫЙ | string | Значением элемента <audience> является текст, описывающий целевую аудиторию предупреждающего сообщения. |
<eventCode> | НЕОБЯЗАТЕЛЬНЫЙ | string | Элемент
где:
В блоке Мы настоятельно рекомендуем вам получить значения элемента
|
<effective> | НЕОБЯЗАТЕЛЬНЫЙ | dateTime | Значение элемента Вы должны включать поля часового пояса во все значения Если содержимое сообщения распространяется на несколько часовых поясов, мы рекомендуем, чтобы создатель сообщения использовал время UTC, а не местное время. Пример: |
<onset> | НЕОБЯЗАТЕЛЬНЫЙ | dateTime | Значение элемента Если местоположение, указанное в блоке Если содержимое сообщения распространяется на несколько часовых поясов, мы рекомендуем, чтобы создатель сообщения использовал время UTC, а не местное время. Пример: |
<expires> | НЕОБХОДИМЫЙ* | dateTime | Значение элемента Если вы не можете установить срок действия для всех своих оповещений, предоставьте Google время истечения срока действия по умолчанию для всех оповещений, у которых нет элемента Вы должны включать поля часового пояса во все значения Если содержимое сообщения распространяется на несколько часовых поясов, мы рекомендуем, чтобы создатель сообщения использовал время UTC, а не местное время. Пример: |
<senderName> | НЕОБЯЗАТЕЛЬНЫЙ | string | Элемент Если у отправителя есть удобочитаемое имя, ссылка |
<headline> | НЕОБЯЗАТЕЛЬНЫЙ | string | Сделайте длину строк элемента Строка Не используйте одинаковые значения для элементов |
<description> | НЕОБХОДИМЫЙ* | string | Значением элемента Мы рекомендуем удобочитаемый и информативный контент, который отвечает на следующие вопросы:
Google использует элемент Вы можете использовать следующие поддерживаемые теги Markdown: |
<instruction> | НЕОБЯЗАТЕЛЬНЫЙ | string | Значением элемента Перечислите действия, которые соответствуют уровню серьезности оповещения и не являются общими. Используйте краткие предложения с учетом регистра и включите советы по безопасности, которые читатели могут использовать, начиная с самых важных советов. Элемент |
<web> | НЕОБХОДИМЫЙ* | string | Свяжите элемент |
<contact> | НЕОБЯЗАТЕЛЬНЫЙ | string | Поле |
<parameter> | НЕОБЯЗАТЕЛЬНЫЙ | string | Элемент
где: В блоке |
<resource> | НЕОБЯЗАТЕЛЬНЫЙ | resource | Элемент |
<area> | НЕОБХОДИМЫЙ* | area | Элемент Мы настоятельно рекомендуем использовать элемент |
* Google требует элементов, отмеченных жирным и красным цветом ОБЯЗАТЕЛЬНАЯ необязательность, но эти элементы являются необязательными в стандарте CAP.
Пример
<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>