Процессор GeoTagger

Процессор GeoTagger используется для обогащения записи события именем области интереса, также называемой геозоной, с которой геометрия записи события имеет заданное пространственное отношение. Процессор уникален тем, что он выполняет обогащение событий и пространственную фильтрацию. Например, вы можете настроить процессор, чтобы он добавлял имена любых геозон, внутри которых находится геометрия записи события. Записи событий, обработанные Процессором GeoTagger, будут иметь добавленное поле, содержащее имена всех геозон, в которых будет найдена его геометрия.

Примеры

Ниже приведены примеры использования GeoTagger Processor:

• Процессор может использоваться для постоянного отслеживания того, какие городские кварталы патрулировались сотрудниками парковки в режиме реального времени. Поскольку офицеры патрулируют разные городские кварталы в течение смены, можно вести учет того, какие блоки были посещены и каким офицером.
• Процессор можно использовать для геотегирования участков именами активных лесных пожаров, влияющих на них. По мере того как на поверхности земли растет лесной пожар, на затронутые участки можно нанести геотеги с указанием имени лесного пожара, который в настоящее время воздействует на них.
• Может использоваться процессор для мониторинга урагана на предмет его воздействия на пострадавшие округа. Поскольку ураган пересекает округа, запись о событиях урагана может быть дополнена списком пострадавших округов с геотегами.

Примечания по использованию

При работе с GeoTagger Processor имейте в виду следующее:

• Процессор GeoTagger использует геометрию записи о событии и одну или несколько геометрий, зарегистрированных в качестве геозон. Регулярное выражение можно использовать для указания нескольких различных геозон и добавления в запись о событии названий геозон, внутри которых находится геометрия записи о событии или которые она пересекает.
• Необходимо импортировать в GeoEvent Server геозоны из сервиса объектов перед настройкой процессора GeoTagger. Для более подробной информации о работе с геозонами в GeoEvent Server см. раздел Управление геозонами.
• При настройке процессора GeoTagger необходимо выбрать пространственный оператор для задания отношения, которое должно выполняться для того, чтобы этот процессор добавил тег в запись события. Например, вы, возможно, захотите обогатить записи событий, помечая их именами геозон, которые пересекает полигон записи события.
• Процессор будет выдавать запись события для каждой записи события, которую он получает. Когда геометрия записи события удовлетворяет пространственным отношениям, которые оценивает процессор, имена соответствующих геозон записываются в указанное целевое поле. Если геометрия записи события не удовлетворяет пространственным отношениям, которые процессор оценивает для любой идентифицированной геозоны, к значению поля GeoTag будет добавлено значение null.
• Процессор GeoTagger поддерживает ряд пространственных операторов, включая Содержит любой, Перекрещивается с любым, Раздельные любым, Входит в любой, Равно любому, Выходит из любого, Внутри любого, Пересекает любой, За пределами любого, Перекрывает любой, Касается любого и Внутри любого. Этими операторами предполагается, что любая рассматриваемая геозона, которая отвечает заданному оператором пространственному отношению, является достаточной для запуска процессора GeoTagger и обогащения обрабатываемого события GeoEvent. Например, если выбран пространственный оператор Пересекает любой и рассматривается несколько десятков непересекающихся областей интереса, то имя любой геозоны, область которой пересекает геометрию GeoEvent, будет добавлено к этому обрабатываемому событию GeoEvent.
• При указании имени поля, содержащего геометрию данных событий, процессор GeoTagger будет принимать или имя поля события, или тег (как правило, тег GEOMETRY), который был применен к полю в определении GeoEvent.
• Процессор изменяет схему записи события, для которой необходимо, чтобы GeoEvent Server создал новое определение GeoEvent. Новое определение GeoEvent будет управляться GeoEvent Server и будет удалено, если изменения вносятся в процессор или в сервис GeoEvent, в котором используется процессор.
• У процессора есть три варианта форматирования обогащенных значений. Значение с разделителями указывает, что имена геозон должны быть записаны в виде простого списка названий, разделенных запятыми. Другие два варианта форматирования обогащенных значений - Группа и Список - представляют собой группу JSON или список JSON.
• Параметр Поле Geometry будет отображать имена всех полей всех определений GeoEvent, в которых содержится тип геометрии. При выборе поля геометрии по имени выберите имя корректного поля геометрии, которое соответствовало бы определению записи события GeoEvent.

Параметры

Ниже приведены параметры GeoTagger Processor:

Параметр	Описание
Имя	Описательное имя процессора, используемое для справочной информации в GeoEvent Manager.
Процессор	Указывает выбранный процессор.
Геозоны	Категория и название геозоны, зарегистрированной в GeoEvent Server. Геозоны оцениваются на предмет их пространственной связи с данными входящих событий. Процессор поддерживает регулярные выражения, позволяя задавать несколько геозон в категории или несколько категорий геозон. Требуемый формат: category/name, заданные в виде пары образцов регулярных выражений, например: WestCampus/Building_A FlightZones/Zone_A Примечание: Для категорий и для названий используются регулярные выражения. К примеру, выражение Campus/.* используется для включения всех геозон в категории Campus для геотегирования. Выражение .*/.* включает все геозоны. Процессор Geotagger поддерживает динамическую замену. Например, запись о событии с атрибутом target_area может быть использована в таком выражении, как Campus/${target_area}, для присвоения имени области. Помните, что совпадения с шаблоном регулярных выражений чувствительны к регистру. Примечание: Несколько выражений геозоны category/name не могут быть объединены в список при помощи запятых. Например, задание Countries/France, Countries/Germany не может использоваться для указания геозон France или Germany. Примечание: Для категорий и для названий используются регулярные выражения. Выражение .*/.* включает все геозоны во всех категориях. Помните, что совпадения с шаблоном регулярных выражений чувствительны к регистру.
Пространственный оператор	Пространственный оператор для использования в GeoTagging. Пространственный оператор определяет, как пространственные оценки геозон оцениваются по отношению данным события. По умолчанию это отношение Содержит любой. Доступны следующие пространственные операторы: Содержит любой Пересекает любой Раздельные любым Входит в любой Равно любому Выходит из любого Внутри любого Пересекает любой За пределами любого Перекрывает любой Касается любым Внутри любого
Поле геометрии	Имя поля геометрии или тегированного поля GEOMETRY в данных входящего события. Процессор использует геометрию данных события, чтобы оценить пространственное отношение с геозонами для геотегирования.
Целевое поле	Целевое поле для записи в него значений с геотегами. По умолчанию – Существующее поле. Новое поле — значения с геотегами будут записаны в новом поле. Изменение схемы записи события путем добавления нового поля требует нового определения GeoEvent. Существующее поле — значения с геотегами будут записаны в существующее поле в обработанной записи события. Для получения значений с геотегами существующее поле должно быть текстовым. Примечание: Когда процессор настроен на запись в новое поле, данные, записанные в указанное поле, могут быть отформатированы либо как значения с разделителями, либо как группа JSON или список JSON. При настройке на запись в существующее поле имена геозон, которые удовлетворяют пространственным отношениям, оцениваемым процессором, добавляются к значению существующего поля в виде текста с разделителями. Опция обогащения обработанной записи события именами геозон, отформатированными в виде группы JSON или списка JSON, не поддерживается при записи в существующее поле.
Имя поля геотега (Условия)	Имя нового поля, в котором хранятся значения с геотегами. Параметр отображается, когда для Целевого поля установлено Новое поле, и скрыто, когда выбрано Существующее поле.
Формат геотега (Условия)	Формат значений с геотегами в поле GeoTag. Значения с геотегами можно отформатировать в виде списка через запятую, группы JSON или списка JSON. Значение по умолчанию - Значение с разделителями. Значение с разделителями — значения с геотегами будут отформатированы и сохранены в виде списка разделенных запятыми значений. Например: “UnitedStates/California,Counties/San_Bernardino” Группа — значения с геотегами будут отформатированы и сохранены как элементы в группе JSON. Например: [{"Category":"UnitedStates","Name":"California"},{"Category":"Counties","Name":"San_Bernardino"}] Список — значения с геотегами будут отформатированы и сохранены в виде списка JSON. Например: ["UnitedStates/California","Counties/San_Bernardino"] Параметр отображается, когда для Целевого поля установлено Новое поле, и скрыто, когда выбрано Существующее поле.
Имя нового определения GeoEvent (Условия)	Имя, которое присваивается для нового Определения GeoEvent. Новое определение GeoEvent объединит схему записи входящего события с новым полем GeoTag, используемым для хранения значений с геотегами. Параметр отображается, когда для Целевого поля установлено Новое поле, и скрыто, когда выбрано Существующее поле.
Существующее имя поля (Условия)	Имя существующего поля из записи события, используемого для хранения значений с геотегами. Для получения значений с геотегами существующее поле должно быть текстовым. Примечание: Используйте меню Определение, чтобы задать определение GeoEvent записей входящих событий. Указание определения GeoEvent сузит область доступных для выбора полей. Используйте меню Поле, чтобы выбрать имя существующего поля, в которое будут записаны значения, вычисленные процессором. Параметр отображается, когда для Целевого поля установлено Существующее поле, и скрыто, когда выбрано Новое поле.
Включить категорию геозоны в геотег	Указывает, следует ли включать категорию геозоны в значения с геотегами. По умолчанию – Да. Да — категория геозоны будет включена в значения с геотегами. Например: Counties/San_Bernardino Нет — категория геозоны не будет включена в значения с геотегами. Геотегировано будет только название геозоны. Например: San_Bernardino

Советы и ограничения

При использовании GeoTagger Processor нужно иметь в виду следующее:

• Обычно GeoFence рассматривают как моделирование области интереса, подразумевая, что геозоны всегда имеют полигональную геометрию. Геозона может также иметь точечную или полилинейную геометрию, как подразумевается списком поддерживаемых пространственных операторов. Полигональная геометрия, связанная с записью события, может быть проверена, чтобы вы смогли увидеть, пересекает ли, перекрещивается ли или содержит ли она геозону, геометрия которой представляет собой точку или полилинию.
• Учитывайте геометрию геозоны и геометрию записи события при настройке параметра Пространственный оператор. Некоторые пространственные операторы могут быть недопустимыми для типов используемой геометрии. Например, нельзя использовать пространственный оператор Содержит любой, если запись события является точкой, а геозона - полигоном. Точка не может содержать полигон. Более подробно о пространственных отношениях см. в разделе Пространственные фильтры.