область

Мы настоятельно рекомендуем, чтобы объект <area> определял географическую область, подлежащую уведомлению, а не зону происшествия.

В случае тропического шторма мы рекомендуем, чтобы объект <area> содержал элементы <polygon> или <geocode> , которые обозначают места, где вы ожидаете воздействия сильного ветра, сильного дождя или других угроз шторма. Если шторм все еще находится вдали от берега, не устанавливайте объект <area> вашего оповещения CAP в текущее местоположение шторма.

Аналогичным образом, в случае лесного пожара мы рекомендуем, чтобы данные объекта <area> также включали города или места, где вы ожидаете воздействия дыма или других угроз от пожара.

Подэлементы объекта area

Имя элемента Опциональность Тип Примечания и требования CAP и Google
<areaDesc> НЕОБХОДИМЫЙ string

Чтобы создать текстовую строку местоположения, используемую в заголовке или заголовке оповещения, Google может использовать элемент <areaDesc> . Значение <areaDesc> должно быть коротким (менее 50 символов).

<polygon> НЕОБЯЗАТЕЛЬНЫЙ string

Парные точки значений в элементе <polygon> определяют многоугольник, очерчивающий область для оповещения в предупреждающем сообщении. Мы рекомендуем представлять элемент <polygon> в виде списка пар координат WGS84 , разделенных пробелами.

Полигоны должны отвечать следующим требованиям:

  • Они должны быть закрыты.
  • Они не могут пересекаться.
  • Отверстия (например, в многоугольниках в форме бублика) и пересечения не поддерживаются.
  • Требуется минимум четыре пары координат. Первая и последняя пары координат должны быть одинаковыми.
<circle> НЕОБЯЗАТЕЛЬНЫЙ string

Элемент <circle> состоит из парных значений точки и радиуса, которые очерчивают область оповещения в форме предупреждающего сообщения. Мы рекомендуем представлять элемент <circle> центральной точкой: парой координат WGS84, за которой следует пробел и значение радиуса в километрах.

Примечание. Если вы укажете круг с нулевым или очень маленьким радиусом, Google не сможет показать предупреждение нашим пользователям.

<geocode> НЕОБЯЗАТЕЛЬНЫЙ string

Определите элемент <geocode> со значениями из доступного и открытого набора данных полигонов. Например, в США эти значения взяты из следующих источников данных:

  • ФИПС6
  • Пользовательский код
  • ТАКОЙ ЖЕ
  • Почтовый индекс США

Если вы используете геокоды, предоставьте Google фиксированный список карт геокодирования в полигоны и шейп-файлов. Чтобы публиковать уведомления об обновлениях в этом списке, используйте отдельный канал, предпочтительно RSS или оповещения по электронной почте. Например, НОАА США публично публикует свои обновления геокодирования .

<altitude> НЕОБЯЗАТЕЛЬНЫЙ float

Значение элемента <altitude> — это конкретная или минимальная высота зоны, на которую попадает предупреждающее сообщение. Укажите это измерение в футах над средним уровнем моря в соответствии с датумом WGS84.

<ceiling> УСЛОВНЫЙ float

Используйте элемент <ceiling> только в том случае, если объект <alert> содержит элемент <altitude> . Значение элемента <ceiling> — это максимальная высота зоны, на которую попадает предупреждающее сообщение. Укажите это измерение в футах над средним уровнем моря в соответствии с датумом WGS84.

Пример 

<area>
    <areaDesc>Cavite</areaDesc>
    <polygon>14.473860833486,120.9718174024 14.347454023196,121.01386683476
     14.142014336735,121.03024107602 14.063075455227,120.85558468426
     14.221664765773,120.59001887699 14.473860833486,
     120.9718174024</polygon>
    <geocode>
        <valueName>SAME</valueName>
        <value>042100000</value>
    </geocode>
</area>

<area>
    <areaDesc>107 km SouthWest DENPASAR-BALI</areaDesc>
    <circle>-9.63,115.12 300.0</circle>
</area>