Skip To Content

Получать объекты на конечной точке REST

Входной коннектор Получать объекты на конечной точке REST можно использовать для получения и адаптации данных событий, представленных в формате объекта JSON, на конечной точке REST, обслуживаемой ArcGIS GeoEvent Server. При стандартной конфигурации GeoEvent Server для поставщиков данных ожидаемым вариантом будет отправка данных через HTTP/POST на конечную точку в формате https://<machine_name>.<domain>:6143/geoevent/rest/receiver/name, где name - это имя настроенного входного коннектора.

Объект JSON с двумя записями объектов, с точечной геометрией, организованной в массив

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

  • Используйте этот коннектор для получения отформатированных данных с добавлением атрибутов и геометрии, как это описано в разделе Объекты геометрии.
  • Этот входной оператор подключения соединяет в пару Входящий адаптер объект JSON с Входящим транспортом HTTP.
  • Пример типичного объекта JSON показан выше. Этот пример организовывает две записи объектов с точечной геометрией в массив
  • Адаптер будет обрабатывать каждый объект в массиве как отдельную запись события.
  • Как и GeoJSON, объект JSON по сути является одним из вариантов JSON. Для обработки этих специальных форматов используются разные адаптеры GeoEvent Server.
  • Этот коннектор может адаптировать точечные, мультиточечные, линейные и полигональные объекты. Он не обрабатывает наборы объектов или коллекции объектов.
  • Настройка и сохранение нового коннектора Получать объекты на конечной точке REST создает конечную точку REST, которая обслуживается GeoEvent Server.
  • Поставщики данных отправляют объект JSON на конечную точку REST, обслуживаемую GeoEvent Server, как часть запроса HTTP/POST.
  • Вы можете восстановить полный путь к конечной точке REST, обслуживаемой GeoEvent Server, изменив входные данные после сохранения.
  • GeoEvent Server можно настроить на использование другого базового URL для приемника REST и/или подключения через порт, отличный от 6143.
  • Поставщик данных должен включить в заголовок HTTP/POST тип MIME, связанный с отправляемыми данными.
  • Настроенные входные параметры должны описывать, какие типы MIME будет принимать транспорт.
  • Этот оператор подключения ожидает тип MIME application/json, который является типом MIME по умолчанию для обмена JSON между клиентом и сервером.
  • Объект JSON обычно ожидает, что в него включена геометрия, а не значения координат, из которых эта геометрия должна быть восстановлена.
  • Этот входной оператор подключения не строит геометрию на основе координат, полученных среди атрибутивных значений.
  • Данные, представленные в формате объекта JSON, должны включать пространственную привязку. Вы не должны указывать Пространственную привязку по умолчанию при использовании этого оператора.
  • Транспорт будет принимать и запросы HTTP/GET, и HTTP/POST. Поставщик данных обычно создает запрос HTTP/POST для отправки данных о событии на GeoEvent Server c объектом JSON в теле запроса и без параметров запроса. Однако этот входной оператор подключения также может извлечь объект JSON, входящий в виде значения указанного параметра запроса в URL запроса HTTP/GET. Используйте свойство Имя параметра для исходных данных для этой возможности.

Параметры

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

Имя

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

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

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

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

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

(Условия)

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

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

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

(Условия)

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

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

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

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

Допустимые типы MIME (режим сервера)

Определяет типы MIME, которые будет принимать входной оператор подключения. Для разделения значений используйте запятые, например: text/plain,application/xml,text/xml. Типы MIME обычно состоят из структуры типа/подтипа и используются, когда серверу нужно указать тип(ы) интернет-медиа данных, которые он будет получать от клиента. По умолчанию используется application/json, который является официальным типом MIME для обмена JSON между клиентом и сервером.

Подробнее об официальных типах MIME см. Internet Assigned Numbers Authority (IANA). Подробнее о типах MIME, которые не используются ArcGIS Server, см. Типы MIME, не используемые ArcGIS Server.

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

Известный идентификатор (WKID) пространственной привязки, используемый при построении геометрии из значений полей атрибутов, координаты которых не являются значениями широты и долготы для предполагаемой географической системы координат WGS84, или строки геометрии, не включающие пространственную привязку. Также может быть указано известное текстовое значение (WKT) или имя поля атрибута, содержащего WKID или WKT.

Имя параметра для сырых данных

Имя параметра запроса, чьи значения являются сырыми данными для внутренних запросов HTTP/GET. Значение параметра запроса должно быть одной строкой, отформатированной как универсальный JSON.