Краткая информация
Процессор Добавить значения XYZ можно использовать для получения координат X, Y и Z из GeoEvents (геособытий) с точечной геометрией. Значения координат присоединяются как уникальные поля в новом определении GeoEvent.
Примеры
- Приложения могут требовать, чтобы местоположение записи события было выражено в виде отдельных координат, а не в виде объекта 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, созданного этим процессором, объедините его либо с Процессором Сопоставление полей, либо с процессором Сокращение полей.
Параметры
| Параметр | Описание |
|---|---|
| Название | Описательное имя процессора, используемое для справочной информации в 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.
- Этот процессор не получает массив значений координат для других типов геометрии, таких как мультиточка, конверт, полилиния и полигон. Поддерживается только извлечение значений координат точечной геометрии.