fieldUtils

方法列表

方法详细说明

getDisplayFieldName(layer){String}

起始版本: GeoScene API for JavaScript 4.22

获取用于标记功能的相应显示字段名称。

参数:

layer FeatureLayer|CSVLayer|GeoJSONLayer|OGCFeatureLayer|SceneLayer|StreamLayer 用于确定显示字段的字段数组。

返回值:

类型	描述
String	用于标记的显示字段的名称。

getElevationFields(layer){Promise<string[]>}

返回 Arcade 表达式中使用的字段名称数组，用于计算给定要素图层的 FeatureLayer.elevationInfo 中要素的 z 值。

参数:

layer FeatureLayer 用于提取计算要素 z 值所需字段的要素图层。

返回值:

类型	描述
Promise<string[]>	解析后，返回字段名称的数组。

getExpressionFields(layer, expressions){Promise<string[]>}

起始版本: GeoScene API for JavaScript 4.22

返回在一个或多个 Arcade 表达式中引用的字段名称数组，这些表达式将在渲染器、标注或弹出模板的给定图层上进行设置。当您希望在更新渲染器以实现快速可视化更新之前请求这些字段的数据时，或者当您希望在图层上设置 Arcade 表达式之前对这些数据执行客户端查询时，这非常有用。

参数:

layer FeatureLayer|CSVLayer|GeoJSONLayer|SceneLayer|StreamLayer 创作 Arcade  expressions 的图层。 该图层必须具有字段属性。

expressions String[] 要在给定 layer上设置的 Arcade 表达式数组。

返回值:

类型	描述
Promise<string[]>	返回由 $feature.fieldName 或$feature[fieldName]  语法声明的字段名称数组。

示例:

• Arcade - 表达式语言

示例代码:

const windDirectionExpression = `
  $feature["WIND_DIRECT"];
  $feature["WIND_SPEED"];
  var DEG = $feature.WIND_DIRECT;
  var SPEED = $feature.WIND_SPEED;
  var DIR = When( SPEED == 0, "",
    (DEG < 22.5 && DEG >= 0) || DEG > 337.5, "N",
    DEG >= 22.5 && DEG < 67.5, "NE",
    DEG >= 67.5 && DEG < 112.5, "E",
    DEG >= 112.5 && DEG < 157.5, "SE",
    DEG >= 157.5 && DEG < 202.5, "S",
    DEG >= 202.5 && DEG < 247.5, "SW",
    DEG >= 247.5 && DEG < 292.5, "W",
    DEG >= 292.5 && DEG < 337.5, "NW", "" );
  return SPEED + " mph " + DIR;
`;

const labelExpressions = [
  "Round($feature.TEMP) + '° F';",
  "$feature.R_HUMIDITY + '% RH'",
  "$feature.STATION_NAME",
  windDirectionExpression
];

// 假设图层只请求了 OBJECTID 字段
fieldUtils.getExpressionFields(layer, labelExpressions)
 .then(function(fieldNames){

  // fieldNames = ["R_HUMIDITY", "STATION_NAME", "TEMP", "WIND_DIRECT", "WIND_SPEED"]
  layer.outFields = fieldNames;

  // 使用这些字段执行其他操作，例如客户端查询
 }).catch(function(error){
   console.error(error);
 });

getFeatureEditFields(layer){String[]}

返回给定要素图层的编辑者追踪字段名称数组。它包括 FeatureLayer.editFieldsInfo 中的字段。

参数:

layer FeatureLayer 要从中提取编辑者追踪字段的要素图层。

返回值:

类型	描述
String[]	用于编辑者追踪的字段名称数组。

getFeatureGeometryFields(layer){String[]}

起始版本: GeoScene API for JavaScript 4.22

返回给定要素图层的几何字段名称数组。它包括 FeatureLayer.geometryProperties 中的字段。

参数:

layer FeatureLayer 要从中提取几何字段的要素图层。

返回值:

类型	描述
String[]	几何字段名称的数组。

getLabelingFields(layer){Promise<string[]>}

返回 Arcade 表达式中用于标注给定要素图层的 FeatureLayer.labelingInfo 中的要素的字段名称数组。

参数:

layer FeatureLayer 要从中提取标注字段的要素图层。

返回值:

类型	描述
Promise<string[]>	解析后，返回用于标记的字段名称数组。

getTimeFields(layer){Promise<string[]>}

返回与时间相关的字段名称数组。它包括 FeatureLayer.timeInfo 中的字段和 trackIdField。

参数:

layer FeatureLayer 要从中提取时间字段的要素图层。

返回值:

类型	描述
Promise<string[]>	解析后，返回时间字段名称的数组。