Входной коннектор Опрос внешнего веб-сайта на наличие GeoJSON может использоваться для извлечения и адаптации данных событий, отформатированных как GeoJSON, с внешнего веб-сайта. Дополнительные примеры форматирования записей данных GeoJSON см. в Спецификации GeoJSON.
Когда из веб-сервера или веб-сервиса возвращается несколько записей данных о событиях, они должны быть организованы как FeatureCollection, как это показано ниже. Входящий адаптер GeoJSON обработает каждую запись объекта в FeatureCollection, как отдельную запись о событии.
Примечания по использованию
При использовании входного коннектора Опрос внешнего веб-сайта на наличие GeoJSON имейте в виду следующее:
- Используйте этот входной коннектор для запроса с веб-сервера или веб-сервиса данных, форматированных как GeoJSON, и их адаптации для создания записей событий для обработки.
- Этот входной коннектор соединяет в пару входной адаптер GeoJSON с входным транспортом HTTP.
- Ожидается, что запись объекта GeoJSON содержит и геометрию и свойства участников.
- Типичные записи событий, организованные как GeoJSON FeatureCollection, показаны выше.
- Адаптер обработает по отдельности записи объектов GeoJSON и записи GeoJSON FeatureCollection.
- Как и объект JSON, GeoJSON по сути является одним из вариантов JSON. Для обработки этих специальных форматов используются разные адаптеры GeoEvent Server.
- Дополнительные примеры форматирования записей данных GeoJSON см. в Спецификации GeoJSON.
- Этот адаптер не поддерживает возможность Построения геометрии из полей.
- Параметр Метод HTTP задает тип запроса HTTP, использующегося для запроса данных с веб-сервиса. По умолчанию применяется запрос HTTP/GET.
- Параметры запросы можно настроить с помощью свойства Параметры, чтобы более точно отобрать интересующие данные.
- Настройка параметров запроса как части запроса HTTP/GET может повысить производительность, т.к. уменьшит число возвращаемых элементов.
- Имя и значения определенного параметра запроса зависит от поддержки запросов внешним веб-сервисом.
- Для этого входного коннектора предполагается, что внешний веб-сервер или веб-сервис принимают запросы HTTP/GET, не требуя аутентификации. Если внешние веб-сайты требуют аутентификацию, можно создать собственный входной коннектор, который соединяет в пару Generic JSON Inbound Adapter и HTTP Inbound Transport, поддерживающий базовую, сертифицированную или OAuth аутентификацию.
- Параметр Получать только новые данные используется, чтобы при запросе лента возвращала только ранее не просмотренные или только что обновленные данные. Эта возможность зависит от правильности включения потоком параметра Last-Modified в заголовок ответа на запрос HTTP. Если в заголовке ответа не указывается дата или время последнего обновления, GeoEvent Server предполагает, что данные в ответе представляют новые или обновленные данные. Более подробно об использовании Last-Modified в заголовках ответов в спецификации RFC 7232 HTTP.
Параметры
Ниже приведены параметры для входного коннектора Опрос внешнего веб-сайта на наличие GeoJSON:
| Параметр | Описание |
|---|---|
Имя | Описательное имя входного коннектора, используемое для ссылки в GeoEvent Manager. |
URL | Базовый URL внешнего веб-сайта, содержащего данные GeoJSON. GeoEvent Server отправляет запрос на URL-адрес для извлечения данных GeoJSON. |
Создать определение GeoEvent | Указывает, следует ли использовать новое или существующее Определение GeoEvent для данных входящих событий. Определение GeoEvent требуется GeoEvent Server, чтобы понимать поля атрибутов и типы данных входящих событий.
|
Имя определения GeoEvent (новое) (Условия) | Имя, которое присваивается для нового Определения GeoEvent. Если определение GeoEvent с указанным именем уже существует, будет использоваться существующее определение GeoEvent. Первая полученная запись данных будет использоваться для определения ожидаемой схемы последующих записей данных, на основе которой будет создано новое определение GeoEvent. Параметр показывается, когда для свойства Создать определение GeoEvent задано значение Да, и скрыто, если задано значение Нет. |
Имя определения GeoEvent (существующее) (Условия) | Имя существующего определения GeoEvent для использования при адаптации полученных данных для создания данных событий для обработки сервисом GeoEvent. Параметр показывается, когда для свойства Создать определение GeoEvent задано значение Нет, и скрыто, если задано значение Да. |
Метод HTTP | Метод HTTP-запроса, который применяется, когда GeoEvent Server опрашивает внешний сервер, предоставляющий поток данных. По умолчанию применяется запрос HTTP/GET.
|
Запрос Post от Тело запроса Post Тип MIME тела сообщения Параметры запроса Post (Условия) | Эти параметры скрыты по умолчанию, когда для свойства Метод HTTP задано Get. Более подробную информацию см. в разделе Ограничения ниже. |
Пространственная привязка по умолчанию | Известный идентификатор (WKID) или известный текст (WKT) системы пространственной привязки, в которой выражены геометрические координаты. У этого параметра нет значения по умолчанию. Это устаревший параметр. Спецификация GeoJSON указывает на то, что все координаты должны быть выражены в географической системе координат с использованием данных Всемирной геодезической системы 1984 (WGS 84) с единицами долготы и широты десятичных градусов. |
Получать только новые данные | Указывает, будет ли адаптер искать последнее измененное значение в заголовке ответа канала данных и попытается использовать это значение, чтобы избежать обработки уже полученных и не обновленных данных. Название этого параметра может ввести в заблуждение. Транспорт всегда будет получать любые данные, которые канал включает в свой ответ на запрос коннектора. Однако, если указано Получать только новые данные, транспорт будет кэшировать дату/время последнего запроса и ретранслировать полученные данные адаптеру только в том случае, если ответ из канала данных содержит последнее измененное значение, которое больше, чем кэшированное значение транспорта. Указание последнего измененного значения необязательно. На практике не многие каналы данных включают его в свои ответы. Значение по умолчанию для этого параметра — Да, но если последнее измененное значение не найдено, параметр игнорируется, поскольку дата/время, необходимые для определения того, являются ли данные в ответе новыми или обновленными, недоступны.
Подробнее о использовании настройки Последний измененный в заголовке запросов см спецификацию RFC 7232 HTTP. |
Частота (в секундах) | Интервал (в секундах), по истечение которого внешний веб-сервер или веб-сервис будет опрошен для получения данных. Значение по умолчанию – 10 секунд (один запрос сбора данных будет выполнен каждые 10 секунд). |
Имя параметра заголовка:Список значений | Параметры, включаемые в HTTP-заголовок запроса при опросе внешнего веб-сервера или веб-сервиса. Параметры заголовка должны быть заданы с помощью пар Имя: Значение (включая двоеточие), разделенных запятыми. |
Параметры | Задает параметр запроса (или несколько параметров запроса) для присоединения к базовому URL. Параметры запроса будут разными для каждого веб-сервиса и поддерживаются не всеми сервисами. Если поддерживаются, параметры запроса помогают указать данные, представляющие особый интерес. У этого параметра нет значения по умолчанию. Параметры запроса, как правило, включены в параметр URL. |
Использовать URL-адрес прокси | Указывает, будет ли GeoEvent Server использовать URL-адрес прокси при выполнении HTTP-запросов. По умолчанию Нет.
|
URL-адрес прокси (Условия) | URL прокси для использования в время запроса HTTP. Параметр показывается, когда для свойства Использовать URL-адрес прокси задано значение Да, и скрыто, если задано значение Нет. |
Ожидаемый формат данных | Шаблон, используемый для соответствия ожидаемым строковым представлениям значений даты/времени и преобразования их в значения даты Java. Формат шаблона следует нормам для класса Java SimpleDateFormat. GeoEvent Server предпочитает, чтобы значения даты/времени выражались в стандарте ISO 8601, но несколько строковых представлений значений даты/времени, обычно распознаваемых как значения даты, могут быть преобразованы в значения даты Java без указания шаблона Ожидаемого формата даты. К ним относятся:
Если полученные значения даты/времени выражены с помощью формата, отличного от одного из пяти, показанных выше, необходимо указать ожидаемый формат даты, чтобы GeoEvent Server знал, как следует адаптировать значения даты/времени. |
Допустимые типы MIME (режим клиента) (Условия) | Указывает типы MIME, которые этот коннектор будет принимать при получении ответа на запрос к каналу данных. Ответ внешнего веб-сервиса указывает фактический тип(ы) MIME для любых данных, отправленных на GeoEvent Server. Этот коннектор понимает следующие типы MIME, которые принимаются по умолчанию для этого параметра: text/json,application/json Подробнее об официальных типах MIME см. Internet Assigned Numbers Authority (IANA). Подробнее о типах MIME, которые не используются ArcGIS Server, см. Типы MIME, не используемые ArcGIS Server. Этот параметр показывается, когда для Метода HTTP задано значение Получить, и скрыто, если стоят значения Закрепить или Поместить. |
Ожидание HTTP (в секундах) | Задает максимальное время (в секундах) ожидания входным коннектором ответа от внешнего веб-сервиса, к которому он отправил запрос. Указанное значение должно быть задано целым числом от 1 до 2147483. Значение по умолчанию – 30 секунд (HTTP-запрос будет остановлен через 30 секунд, если ответ не получен). |
Советы и ограничения
Всегда используйте запрос HTTP/GET, который не включает тело содержимого, и используйте параметры запроса для указания интересующих данных. Приведенные ниже параметры применимы только к выходным коннекторам, которые отправляют данные на внешний веб-сервер или веб-сервис. Оставьте для параметра Метод HTTP значение по умолчанию HTTP/GET, и эти параметры останутся скрытыми.
| Параметр | Описание |
|---|---|
Запрос Post от (Условия) | Указывает, будет ли этот коннектор использовать запрос HTTP/POST или HTTP/PUT.
Параметр показывается, когда для свойства Метод HTTP задано значение Post или Put, и скрыто, если задано значение Get. |
Тело запроса Post (Условия) | Указывает данные для включения в тело содержимого запроса HTTP/POST или HTTP/PUT. Параметр показывается, когда для свойства Запрос Post от задано значение Тело содержимого, и скрыто, если задано значение Параметры. |
Тип MIME тела сообщения (Условия) | Задает тип MIME данных, включенных в тело содержимого HTTP-запроса. Типы MIME обычно состоят из структуры типа/подтипа и используются для указания типов интернет-носителей, используемых и принимаемых HTTP-клиентом/сервером. Параметр показывается, когда для свойства Запрос Post от задано значение Тело содержимого, и скрыто, если задано значение Параметры. |
Параметры запроса Post (Условия) | Задает параметры для включения в HTTP-запрос. Параметры должны быть заданы с помощью пар Имя:Значение (включая двоеточие), разделенных запятыми. У этого параметра нет значения по умолчанию. Параметр показывается, когда для свойства Запрос Post от задано значение Параметры, и скрыто, если задано значение Тело содержимого. |