Процессор Добавить значения XYZ используется для получения координат x, y и z из записей событий с точечной геометрией. Значения координат добавляются к записи события, что требует нового определения GeoEvent для описания новой схемы записи события.
Примеры
Ниже приводится пример использования процессора Добавить значения XYZ:
- Приложениям может потребоваться, чтобы местоположение записи события было выражено в виде отдельных координат, а не в виде объекта JSON, GeoJSON или общего представления геометрии JSON.
- Этот процессор можно использовать для получения координат по объекту JSON (например, по точечной геометрии объекта из сервиса объектов).
- Полученные этим процессором значения x, y и z можно использовать в качестве исходных или целевых данных для процессора Калькулятор курса.
Примечания по использованию
При работе с процессором Добавить значения XYZ учитывайте следующее:
- Процессор поддерживает только извлечение значений координат из точечной геометрии. Процессор лучше всего использовать с данными о событиях, импортированных из входных коннекторов опрос 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.
- Этот процессор не получает массив значений координат для других типов геометрии, таких как мультиточка, конверт, полилиния и полигон. Поддерживается только извлечение значений координат точечной геометрии.