Входной коннектор Получить GeoJSON на конечной точке REST можно использовать для получения и адаптации данных событий, представленных в формате GeoJSON, на конечной точке REST, обслуживаемой ArcGIS GeoEvent Server. При стандартной конфигурации GeoEvent Server для поставщиков данных ожидаемым вариантом будет отправка данных через HTTP/POST на конечную точку в формате https://<machine_name>.<domain>:6143/geoevent/rest/receiver/name, где name — это имя настроенного входного коннектора.
Клиенты, которым нужно отправить несколько записей с данными, должны организовать их как FeatureCollection, как это показано ниже. Входной адаптер GeoJSON обработает каждую запись объекта в FeatureCollection, как отдельную запись о событии. GeoJSON, проиллюстрированный ниже, будет адаптирован для создания двух записей событий для обработки сервисом GeoEvent.
Дополнительную информацию и примеры записей данных в формате GeoJSON см. в Спецификация GeoJSON.
Примечания по использованию
При использовании входного коннектора Получить GeoJSON на конечной точке REST имейте в виду следующее:
- Используйте этот входной коннектор для получения данных, отформатированных как GeoJSON, отправляйте с помощью HTTP/POST на конечную точку REST, размещенную на GeoEvent Server.
- Этот входной коннектор соединяет в пару входной адаптер GeoJSON с входным транспортом HTTP.
- Выше показан типичный пример GeoJSON FeatureCollection. Коллекция в этом примере состоит из двух записей объектов GeoJSON.
- Адаптер обработает по отдельности записи объектов GeoJSON и записи GeoJSON FeatureCollection.
- Как и объект JSON, GeoJSON по сути является одним из вариантов JSON. Для обработки этих специальных форматов используются разные адаптеры GeoEvent Server.
- Дополнительные примеры форматирования записей данных GeoJSON см. в Спецификации GeoJSON.
- Настройка и сохранение нового входного коннектора Получить GeoJSON на конечной точке REST создает конечную точку REST, которая обслуживается GeoEvent Server.
- Можно восстановить полный путь к конечной точке REST, обслуживаемой GeoEvent Server, изменив входные данные после сохранения.
- GeoEvent Server можно настроить на использование другого базового URL для приемника REST и подключения через порт, отличный от 6143.
- Поставщик данных должен включить в заголовок HTTP/POST тип MIME, связанный с отправляемыми данными.
- Настроенные входные параметры должны описывать, какие типы MIME будет принимать транспорт.
- Этот входной коннектор ожидает тип MIME application/json, который является типом MIME по умолчанию для обмена JSON между клиентом и сервером.
- Корректные записи объектов GeoJSON включают геометрию и свойства. Этот входной оператор подключения невозможно использовать для построения геометрии на основе координат, полученных среди значений свойств. Все записи объектов GeoJSON используют датум World Geodetic System 1984 (WGS 84) со значениями координат, описанными как долгота и широта в десятичных градусах. Не нужно указывать Пространственную привязку по умолчанию при использовании этого коннектора.
Параметры
Ниже приведены параметры для входного коннектора Получить GeoJSON на конечной точке REST:
| Параметр | Описание |
|---|---|
Имя | Описательное имя входного коннектора, используемое для ссылки в GeoEvent Manager. |
Создать определение GeoEvent | Указывает, следует ли использовать новое или существующее Определение GeoEvent для данных входящих событий. Определение GeoEvent требуется GeoEvent Server, чтобы понимать поля атрибутов и типы данных входящих событий.
|
Имя определения GeoEvent (новое) (Условия) | Имя, которое присваивается для нового Определения GeoEvent. Если определение GeoEvent с указанным именем уже существует, будет использоваться существующее определение GeoEvent. Первая полученная запись данных будет использоваться для определения ожидаемой схемы последующих записей данных, на основе которой будет создано новое определение GeoEvent. Параметр показывается, когда для свойства Создать определение GeoEvent задано значение Да, и скрыто, если задано значение Нет. |
Имя определения GeoEvent (существующее) (Условия) | Имя существующего определения GeoEvent для использования при адаптации полученных данных для создания данных событий для обработки сервисом GeoEvent. Параметр показывается, когда для свойства Создать определение GeoEvent задано значение Нет, и скрыто, если задано значение Да. |
Пространственная привязка по умолчанию | Известный идентификатор (WKID) или известный текст (WKT) системы пространственной привязки, в которой выражены геометрические координаты. У этого параметра нет значения по умолчанию. |
Допустимые типы 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. |
Ожидаемый формат данных | Шаблон, используемый для соответствия ожидаемым строковым представлениям значений даты/времени и преобразования их в значения даты Java. Формат шаблона следует нормам для класса Java SimpleDateFormat. GeoEvent Server предпочитает, чтобы значения даты/времени выражались в стандарте ISO 8601, но несколько строковых представлений значений даты/времени, обычно распознаваемых как значения даты, могут быть преобразованы в значения даты Java без указания шаблона Ожидаемого формата даты. К ним относятся:
Если полученные значения даты/времени выражены с помощью формата, отличного от одного из пяти, показанных выше, необходимо указать ожидаемый формат даты, чтобы GeoEvent Server знал, как следует адаптировать значения даты/времени. |
Имя параметра для сырых данных | Имя параметра запроса, чьи значения являются сырыми данными для внутренних запросов HTTP/GET. Значение параметра запроса должно быть одной строкой, отформатированной как объект GeoJSON или GeoJSON FeatureCollection. |