Входной коннектор Получить GeoJSON на WebSocket можно использовать для получения и адаптации данных событий, представленных в формате GeoJSON на WebSocket, обслуживаемом ArcGIS GeoEvent Server. При стандартной конфигурации GeoEvent Server клиенты ожидают подписания и отправки данных на конечную точку в формате wss://<machine_name>.<domain>:6143/path, где path — это значение, указанное в параметре URL-путь.
Когда из веб-сервера или веб-сервиса возвращается несколько записей данных о событиях, они должны быть организованы как FeatureCollection, как это показано ниже. Входящий адаптер GeoJSON обработает каждую запись объекта в FeatureCollection, как отдельную запись о событии.
Дополнительную информацию и примеры записей данных в формате GeoJSON см. в Спецификация GeoJSON.
Этот входной коннектор запускается как сервер, чтобы позволить клиентским приложениям подписывать и отправлять данные на GeoEvent Server. Если вы ищете входной коннектор, который запускается, как клиент и подписывается на получение данных, передаваемых с WebSocket сервера, имейте в виду возможность Подписаться на внешний WebSocket для получения GeoJSON.
Примечания по использованию
При использовании входного коннектора Receive GeoJSON на входной WebSocket имейте в виду следующее:
- Используйте этот входной коннектор, чтобы получать данные в формате GeoJSON через WebSocket, обслуживаемый GeoEvent Server.
- Этот входной коннектор соединяет в пару входящий адаптер GeoJSON с входящим транспортом WebSocket.
- Ожидается, что запись объекта GeoJSON содержит и геометрию и свойства участников.
- Типичные данные о событиях, организованные как часть GeoJSON FeatureCollection, показаны выше.
- Адаптер обработает по отдельности записи объектов 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.
Параметры
Ниже приведены параметры для Receive GeoJSON на входном коннекторе WebSocket:
| Параметр | Описание |
|---|---|
Имя | Описательное имя входного коннектора, используемое для ссылки в GeoEvent Manager. |
URL-путь | Полная конечная точка URL включает протокол, имя хоста или IP-адрес, порт и путь. Для этого коннектора необходимо указать только путь URL. По умолчанию – /ws. Полный URL, который клиенты используют для подписки, выглядит следующим образом: ws://<machine_name>.<domain>:6180/path или wss://<machine_name>.<domain>:6143/path. Например, если значение URL-путь указано как /SampleRecords, клиенты, отправляющие данные в безопасный URL WebSocket, будут использовать wss://PS000123.esri.com:6143/SampleRecords для машины с именем PS000123 на домен esri.com. |
Создать определение GeoEvent | Указывает, используется ли новое или существующее определение GeoEvent для данных входящих событий. Определение GeoEvent требуется GeoEvent Server, чтобы понимать поля атрибутов и типы данных входящих событий.
|
Имя определения GeoEvent (новое) (Условия) | Имя, которое присваивается для нового Определения GeoEvent. Если определение GeoEvent с указанным именем уже существует, используется существующее определение GeoEvent. Первая полученная запись данных используется для определения ожидаемой схемы последующих записей данных, на основе которой создается новое определение GeoEvent. Этот параметр показывается, когда для свойства Создать определение GeoEvent задано значение Да, и скрыто, если задано значение Нет. |
Имя определения GeoEvent (существующее) (Условия) | Имя существующего определения GeoEvent для использования при адаптации полученных данных для создания данных событий для обработки сервисом GeoEvent. Этот параметр показывается, когда для свойства Создать определение GeoEvent задано значение Нет, и скрыто, если задано значение Да. |
Пространственная привязка по умолчанию | Известный идентификатор (WKID) или известный текст (WKT) системы пространственной привязки, в которой выражены геометрические координаты. У этого параметра нет значения по умолчанию. Это устаревший параметр. Спецификация GeoJSON указывает на то, что все координаты должны быть выражены в географической системе координат с использованием данных Всемирной геодезической системы 1984 (WGS 84) с единицами долготы и широты десятичных градусов. |
Ожидаемый формат данных | Шаблон, используемый для соответствия ожидаемым строковым представлениям значений даты/времени и преобразования их в значения даты Java. Формат шаблона следует нормам для класса Java SimpleDateFormat. Хотя предпочтительным шаблоном для значений даты/времени в GeoEvent Server является стандарт ISO 8601, несколько строковых представлений значений даты/времени, обычно распознаваемых как значения даты, могут быть преобразованы в значения даты Java без указания значения Ожидаемого формата даты. К ним относятся:
Если полученные значения даты/времени используют соглашение, отличное от перечисленных выше, необходимо указать ожидаемый шаблон формата даты, чтобы GeoEvent Server мог адаптировать значения даты/времени. |