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 МБ на файл).