Процессор Добавить значения 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.
- Этот процессор не получает массив значений координат для других типов геометрии, таких как мультиточка, конверт, полилиния и полигон. Поддерживается только извлечение значений координат точечной геометрии.