Skip To Content

Подписаться на внешний WebSocket для получения GeoJSON

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

Этот входной оператор подключения работает как клиент и должен иметь возможность подписаться на WebSocket, размещенный на сервере. Если вы ищете входной коннектор, который работает как сервер и позволяет клиентским приложениям подписывать и отправлять данные на вход, рассмотрите возможность использования Получать GeoJSON на WebSocket.

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

При использовании входного коннектора Подписаться на внешний WebSocket для получения GeoJSON имейте в виду следующее:

  • Используйте этот входной оператор подключения, чтобы получать данные в формате GeoJSON через WebSocket, Server обслуживаемый внешним сервером
  • Этот входной оператор подключения работает как клиент и подписывается на размещенный WebSocket сервера для получения данных, транслируемых сервером.
  • Этот входной коннектор соединяет в пару входной адаптер GeoJSON с входным транспортом WebSocket.
  • Ожидается, что запись объекта GeoJSON содержит и геометрию и свойства участников.
  • Адаптер обработает по отдельности записи объектов GeoJSON и записи GeoJSON FeatureCollection.
  • Как и объект JSON, GeoJSON по сути является одним из вариантов JSON. Для обработки этих специальных форматов используются разные адаптеры GeoEvent Server.
  • Дополнительные примеры форматирования записей данных GeoJSON см. в Спецификации GeoJSON.
  • Этот адаптер не поддерживает возможность Построения геометрии из полей.
  • Этим оператором подключения поддерживаются и протокол WebSocket (ws), и WebSocket Secure (wss).
  • Клиенты, отправляющие данные на конечную точку WebSocket, должны использовать ws://<machine_name>.<domain>:6180/path.
  • Клиенты, отправляющие данные на конечную точку WebSocket Secure, должны использовать wss://<machine_name>.<domain>:6143/path.

Параметры

Ниже приведены параметры для входного коннектора Подписаться на внешний WebSocket для получения GeoJSON:

ПараметрОписание

Имя

Описательное имя входного коннектора, используемое для ссылки в GeoEvent Manager.

WebSocket URI удаленного сервера (режим клиента)

Полная конечная точка URL, включая протокол, имя хоста или IP-адрес, порт и путь. По умолчанию это localhost. Обновите этот параметр, чтобы отразить URI для WebSocket хост-сервера.

Создать определение GeoEvent

Указывает, следует ли использовать новое или существующее Определение GeoEvent для данных входящих событий. Определение GeoEvent требуется GeoEvent Server, чтобы понимать поля атрибутов и типы данных входящих событий.

  • Да – новое Определение GeoEvent будет создано на основе схемы первой полученной записи события.
  • Нет – новое Определение GeoEvent не будет создаваться. Выберите существующее Определение GeoEvent, соответствующее схеме данных входящего события.

Имя определения GeoEvent (новое)

(Условия)

Имя, которое присваивается для нового Определения GeoEvent. Если определение GeoEvent с указанным именем уже существует, будет использоваться существующее определение GeoEvent. Первая полученная запись данных будет использоваться для определения ожидаемой схемы последующих записей данных, на основе которой будет создано новое определение GeoEvent.

Параметр показывается, когда для свойства Создать определение GeoEvent задано значение Да, и скрыто, если задано значение Нет.

Имя определения GeoEvent (существующее)

(Условия)

Имя существующего определения GeoEvent для использования при адаптации полученных данных для создания данных событий для обработки сервисом GeoEvent.

Параметр показывается, когда для свойства Создать определение GeoEvent задано значение Нет, и скрыто, если задано значение Да.

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

Известный идентификатор (WKID) или известный текст (WKT) системы пространственной привязки, в которой выражены геометрические координаты. У этого параметра нет значения по умолчанию.

Это устаревший параметр. Спецификация GeoJSON указывает на то, что все координаты должны быть выражены в географической системе координат с использованием данных Всемирной геодезической системы 1984 (WGS 84) с единицами долготы и широты десятичных градусов.

Ожидаемый формат данных

Шаблон, используемый для соответствия ожидаемым строковым представлениям значений даты/времени и преобразования их в значения даты Java. Формат шаблона следует нормам для класса Java SimpleDateFormat.

GeoEvent Server предпочитает, чтобы значения даты/времени выражались в стандарте ISO 8601, но несколько строковых представлений значений даты/времени, обычно распознаваемых как значения даты, могут быть преобразованы в значения даты Java без указания шаблона Ожидаемого формата даты. К ним относятся:

  • "2019-12-31T23:59:59" – формат стандарта ISO 8601
  • 1577836799000 – дата Java (epoch long integer; UTC)
  • "Tue Dec 31 23:59:59 -0000 2019" – общий строковый формат веб-сервисов
  • "12/31/2019 11:59:59 PM" – общий формат, используемый в США (12 часов)
  • "12/31/2019 23:59:59" – общий формат, используемый в США (24 часа)

Если полученные значения даты/времени выражены с помощью формата, отличного от одного из пяти, показанных выше, необходимо указать ожидаемый формат даты, чтобы GeoEvent Server знал, как следует адаптировать значения даты/времени.