映射字段

可用于实时分析和大数据分析。

映射字段工具 可将数据从输入方案转换为输出方案。 可以使用映射字段工具执行字段计算、创建字段和标记关键字段。 将使用 ArcGIS Arcade 表达式映射字段。 Arcade 是一种轻量级的安全表达式语言,专为应用于 ArcGIS 而编写。 与其他表达式语言类似,该语言可以执行数学计算和评估逻辑语句。

了解有关 ArcGIS Arcade 表达式语言的详细信息

示例

以下为映射字段工具的用例:

  • 一位城市 GIS 分析师希望处理添加到要素图层中的所有新要素,并更改字段名称、删除某些字段以及使用 Arcade 表达式创建其他字段。
  • 一位数据分析师希望更改分隔文本文件(云端)中存储的数百万条数据记录的方案。 此工具可以使用 Arcade 表达式更改字段名称、删除某些字段并创建其他字段。
  • 一位物联网专家想要使用 Arcade 表达式来解析字符串字段中的几何值,并将这些值设置为要素几何。

用法说明

使用映射字段工具时,请谨记以下信息:

  • 可以使用可选的配置几何参数来配置和调整几何。 关于几何表达式和空间参考规范的其他参数详细信息如下。
  • ArcGIS 客户端当前不支持 64 位整型字段类型。 如果将字段指定为 Int64,则该字段将转换为 Float64,并在任何关联的地图或要素服务中以双精度类型列出。
  • 转换前,Int64 类型的数据字段支持 -(253) -1 到 (2 53) -1 之间的整数。 尝试读取或写入此范围之外的数字可能会导致对值进行舍入。
  • 作为映射字段工具的替代方法,在首次配置数据源或源时,您可以设置字段名称修改和关键字段标记。
  • 在实时分析中,请勿从源中移除 TRACK_ID 字段名称标签,因为这会使其失效。 最佳做法是在更改标有追踪 ID 字段名称的字段时,确保新的追踪 ID 字段名称包含原始的追踪 ID 字段值。 例如,可以创建一个包含原始追踪 ID 字段值与其他字段值的串联的新字段。
  • 使用此工具进行的几何计算目前仅限于熟知 ID (WKID) 空间参考。 熟知文本 (WKT) 空间参考不支持用于 Arcade 几何函数。

参数

以下是映射字段工具的参数:

属性字段映射(新字段映射)

参数描述数据类型

输入图层

要素,其字段将映射到新方案。

要素

输入字段

工具接收的数据模式。 对于输入字段列表中的每个条目,可从输入图层中的现有字段进行映射,或者构建 Arcade 表达式以计算要写入指定输出字段参数的新值。

字符串

输出字段

工具转换后的数据方案。

字符串

关键字段(可选)

识别关键字段以使用其功能标记字段(如果适用)。

字符串

可为空

指示映射的字段是否可包含空值。 此参数表示为复选框。

布尔

几何配置

参数描述数据类型

输入图层

要素,其字段将映射到新方案。

要素

几何表达式

表达式包括点、多点、折线或面 Arcade 函数。

函数应包含有效的 Esri 几何对象

注:

如果未指定输入方案的空间参考(表格数据)或者使用除 GCS WGS 1984 (WKID: 4326) 以外的任何空间参考,则必须在 Arcade 表达式中指定空间参考,才能成功评估。 否则,将显示以下错误执行错误:无法在此空间参考中创建几何。 引擎使用不同的空间参考。

用于构建几何的示例 Arcade 表达式如下所示:

  • 使用要素方案中现有的经度和纬度字段生成点几何。
    • Point({"x" : $feature.longitude, "y" : $feature.latitude, "spatialReference" : {"wkid" : 4326}})
  • 使用要素方案中现有的经度和纬度字段生成折线几何。
    • Polyline({"paths":[[[$feature.longitude,$feature.latitude],[$feature.longitude+5000,$feature.latitude+5000]]],"spatialReference":{"wkid":102100}})

字符串

空间参考

由几何表达式生成的几何的空间参考。 可将其提供为 WKID 或 WKT 字符串。

如果在表达式中指定了空间参考,则此处指定的空间参考必须与 Esri 几何对象的空间参考相匹配。

JSON WKID 或 WKT 对象

输出图层

输出图层具有由输出字段列表定义的方案。 如果配置了几何,则几何会根据指定的几何表达式和空间参考进行更改。