fieldUtils

方法概述

方法详细说明

getDisplayFieldName(layer){String}

起始版本：GeoScene Maps SDK for JavaScript 4.15

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

参数

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 Maps SDK for JavaScript 4.15

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

参数

layer FeatureLayer|CSVLayer|GeoJSONLayer|SceneLayer|StreamLayer 为其创建 Arcade expressions 的图层。该图层必须具有 fields 属性。

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
];

// Assume the layer has only requested the OBJECTID field
fieldUtils.getExpressionFields(layer, labelExpressions)
 .then(function(fieldNames){

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

  // Do something else like a client-side query with those fields
 }).catch(function(error){
   console.error(error);
 });

getFeatureEditFields(layer){String[]}

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

参数

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

返回

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

getFeatureGeometryFields(layer){String[]}

起始版本：GeoScene Maps SDK for JavaScript 4.19

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

参数

layer FeatureLayer 要从中提取几何字段的 featureLayer。

返回

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

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

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

参数

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

返回

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

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

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

参数

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

返回

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