Процессор Добавить значения XYZ

Процессор Добавить значения XYZ используется для получения координат X, Y и Z из GeoEvents (геособытий) с точечной геометрией. Значения координат присоединяются как уникальные поля в новом определении GeoEvent.

Примеры

Ниже приводится пример использования процессора Добавить значения XYZ:

• Приложения могут требовать, чтобы местоположение записи события было выражено в виде отдельных координат, а не в виде объекта JSON, GeoJSON или общего представления геометрии JSON.
• Этот процессор можно использовать для получения координат по объекту JSON (например, по точечной геометрии объекта из сервиса объектов).
• Полученные этим процессором значения X, Y и Z можно использовать в качестве исходных или целевых данных для процессора Калькулятор курса.

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

При работе с процессором Добавить значения XYZ имейте в виду следующее:

• Процессор поддерживает только извлечение значений координат из точечной геометрии, которая выражена как объект JSON. Поэтому этот процессор лучше всего использовать с данными о событиях, импортированных из входных коннекторов Опрос ArcGIS Server на наличие объектов или Получить объекты на конечной точке REST.
• Записи о событиях, которые передаются на этот процессор, должны иметь определение GeoEvent, содержащее точечную геометрию. Это геометрическое значение используется для получения значений координат X, Y и Z для каждой записи о событии.
• Хотя таким значением имен для полей X, Y и Z по умолчанию являются соответственно x, y и z, эти значения могут быть изменены. Например, параметр поле X можно задать как долгота, параметр поле Y – как широта, а параметр поле Z – как превышение или высота.
• Все эти параметры – поле X, поле Y и поле Z являются обязательными. Чтобы изменить схему выходного определения GeoEvent, созданного этим процессором, объедините его либо с Процессором Сопоставление полей, либо с процессором Сокращение полей.

Параметры

Ниже приводятся параметры процессора Добавить значения XYZ:

Параметр	Описание
Имя	Описательное имя процессора, используемое для справочной информации в GeoEvent Manager.
Процессор	Указывает выбранный процессор.
Поле геометрии	Имя геометрического поля или поля записи события с тегом GEOMETRY, из которых этот процессор будет брать значения координат X, Y и Z. Указанное поле геометрии должно быть точечной геометрией.
Определение выходного GeoEvent	Указывает имя определения GeoEvent, созданного процессором. В созданное определение GeoEvent поля координат X, Y и Z будут добавлены как часть новой схемы.
X-поле	Имя поля, в котором будет храниться значение координаты X. Это поле будет добавлено в новое определение GeoEvent, созданное процессором. Значение по умолчанию x.
Y-поле	Имя поля, в котором будет храниться значение координаты Y. Это поле будет добавлено в новое определение GeoEvent, созданное процессором. Значение по умолчанию y.
Z-поле	Имя поля, в котором будет храниться значение координаты Z. Это поле будет добавлено в новое определение GeoEvent, созданное процессором. Значение по умолчанию z. Примечание: Если в точечной геометрии не будет значения координаты Z, то по умолчанию в это поле будет добавлено 0,0.

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

При использовании процессора Добавить значения XYZ нужно иметь в виду следующее:

• Процессор использует поле или тег геометрии на входящем определении GeoEvent, чтобы распознать точечную геометрию и получить значения координат X, Y и Z. Если поле или тег этой геометрии не существует, тогда перед настройкой этого процессора необходимо будет создать поле геометрии или применить тег GEOMETRY к существующему полю. Это ограничение не применяется, если именем поля входной геометрии является geometry, или если тег GEOMETRY уже используется.
• Процессор создаст новое определение GeoEvent, поскольку добавляются новые поля. Изменение схемы записей события путем добавления нового поля всегда требует от GeoEvent Server создания нового определения GeoEvent.
• Этот процессор не получает массив значений координат для других типов геометрии, таких как мультиточка, конверт, полилиния и полигон. Поддерживается только извлечение значений координат точечной геометрии.