Esri JSON

Esri JSON 是一种用于对多种地理数据结构进行编码的格式。 提及 Esri JSON 时,通常是指 featureSet 对象,其中包含一组要素对象ArcGIS Velocity 可以将 Esri JSON 提取为 featureSet 对象(要素集合)或者将单个 Feature 对象提取为行。

以下源和数据源类型支持将 Esri JSON 作为数据格式:

  • 源 - Azure Event Hub、Azure Service Bus、AWS IoT、HTTP 轮询器、HTTP 接收器、Kafka、WebSocket、RabbitMQ 和 MQTT
  • 数据源 - Azure Blob 存储、Amazon S3 和 HTTP 轮询器

受支持的 Esri JSON

Velocity 支持保持一致的几何类型、字段集合和空间参考的 Esri JSON。

生成 Esri JSON

可以使用 ArcGIS Pro要素转 JSON 工具将数据从多种格式转换为 Esri JSON。

指定 Esri JSON 配置

配置源或数据源时,将进行采样以了解要提取的数据类型。 如果采样确定数据为 Esri JSON 格式,则可以指定 Esri JSON 配置的其他属性。

位置属性

在某些情况下,尤其是对单个要素对象进行采样时,如果样本数据中不存在其他位置信息,则可能需要进行配置。 例如,要素阵列中的几何对象可能不包含每个要素的空间参考。 对 featureSet 对象进行采样时,Velocity 可以导出完整的位置信息,并且不需要位置属性的其他配置。

注意事项和限制

Velocity 中使用 Esri JSON 格式的数据时,需了解下述注意事项和限制。

Esri JSON 要素属性必须保持一致

使用 Esri JSON 数据格式时,属性数据用属性对象内的名称值对表示。 任何属性的值都应该具有空值或有效值。 如果要素的某个属性不具有值,则该属性值应以空值表示,而不应缺少该属性名称。

更改字段类型

建议您不要更改 Esri JSON 的字段类型。 当 Velocity 采样并提取 featureSet 对象时,将得出字段类型的准确表示,并且在配置源时不应更改这些字段类型。 更改字段类型的例外情况是要素对象。 要素对象将日期字段中的时间表示为新纪元毫秒,它们将始终作为整型字段类型导出,而没有明确包含字段类型的完整 featureSet。 因此,应对其进行相应调整。 此外,对于要素对象,Velocity 将尝试仅根据检索的样本来派生其他字段类型,并且应相应地检查字段类型。

Esri JSON 文件大小

最佳做法是确保在 Velocity 中提取的每个 Esri JSON 文件小于100 MB。 如果存在大量数据,可将文件分割为较小的文件(每个文件小于 100 MB)。