Esri JSON

Esri JSON - это формат для кодирования различных географических структур данных. При обращении к Esri JSON, как правило обращаются к объекту featureSet, который содержит набор элементов объекта. ArcGIS Velocity может быть получать Esri JSON как объект featureSet (набор объектов) или как отдельные строки элементов объекта.

Esri JSON поддерживается в качестве формата данных для следующих типов каналов и источников данных:

  • Каналы - Azure Event Hub, Azure Service Bus, AWS IoT, HTTP Poller, HTTP Receiver, Kafka, WebSocket, RabbitMQ и MQTT
  • Источники данных - Azure Blob storage, Amazon S3 и HTTP Poller

Поддерживаемые Esri JSON

Velocity поддерживает Esri JSON, в котором задан один тип геометрии, настроены поля и пространственная привязка.

Создание Esri JSON

Данные можно конвертировать в Esri JSON из различных форматов с помощью инструмента ArcGIS Pro Объекты в JSON.

Задание конфигурации Esri JSON

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

Свойства местоположений

В некоторых случаях, особенно при выборке отдельных элементов объекта, может потребоваться настройка дополнительной информации о местоположении, если она отсутствует в выборке данных. Например, геометрические объекты в массиве пространственных объектов не включают пространственную привязку для каждого объекта. При выборе объекта featureSet, Velocity может получить полную информацию о местоположении, и дополнительная настройка свойств местоположения не требуется.

Советы и ограничения

При работе с данными в формате Esri JSON в Velocity необходимо ознакомится с информацией и ограничениями, описанными ниже.

Свойства объекта Esri JSON должны оставаться постоянными

При использовании формата данных Esri JSON, атрибутивные данные представлены в виде значений имени в паре с объектом атрибута. Значение для любого свойства должно быть либо нулевым, либо действительным значением. Если у объекта нет значения для свойства, он должен быть представлен нулем для того значения, вместо того, чтобы там было имя атрибута.

Изменение типа поля

Рекомендуется не изменять типы полей в Esri JSON. Когда Velocity проводит выборку и принимает объект featureSet, извлекается точное отображение типов полей, его не следует менять при настройке источника или канала. Исключением для изменения полей являются элементы объекта. Элементы объекта отображают время в полях даты в миллисекундах эпохи, поэтому они всегда извлекаются как поля целочисленного типа без полного featureSet, который содержит типы полей в явном виде. Следовательно, вы должны соответствующим образом скорректировать их. Кроме того, в случае использования элементов объектов, Velocity будет пытаться использовать другие типы полей, основываясь на полученных образцах, и типы полей должны быть соответственно перепроверены.

Размер файла Esri JSON

Рекомендуется, чтобы объем загружаемых в Esri файлов Velocity JSON составлял менее 100 МБ. Если у вас больший объем данных, разделите файлы на файлы меньшего размера (менее 100 МБ на файл).