SizeVariable

大小视觉变量根据数值（通常是专题）值定义图层中各个要素的大小。此值来自以下值之一：

• 属性字段
• 属性 field 的值除以 normalizationField
• 从 valueExpression 中指定的 Arcade 表达式返回的值。

大小以连续渐变的形式定义，可应用于 MapView 或 SceneView 中的渲染器。

符号大小可以按专题应用，也可以使用实际单位按字面应用。有关大小视觉变量的每个潜在用法的详细信息，请参阅以下对象规范表：

• BoundedMinMax - 要素大小受最小和最大数据值的限制。中间值在 minSize 和 maxSize 之间进行线性插值。
• ThematicStops - 定义两到六个停靠点，在该停靠点处将要素大小映射到数据值。
• ScaleDependentIcons - 图标大小受最小和最大数据值的限制，但 minSize 和 maxSize（以及插值大小）会根据 MapView 的比例而变化。
• ScaleDependentStops - 定义各种视图比例下面轮廓的宽度。
• RealWorldSize - 要素大小是根据实际测量值和单位确定的，而不是基于专题值和屏幕单位。

专题图标大小	专题拉伸	实际大小

对于 CIMSymbol，大小值仅应用于最大符号图层，而不是完整符号。所有其他符号图层将按比例缩放。

另请参阅：

• 示例 - 连续大小

• 示例 - 通过拉伸按专题可视化要素

• 示例 - 根据实际大小缩放要素大小 （2D）

• 示例 - 使用逼真的 3D 符号可视化要素

• 示例 - 根据实际高度拉伸建筑物覆盖区

示例：

// Bounded min/max visual variable (similar to proportional size)
const sizeVisualVariable = {
  type: "size",
  field: "WIND_SPEED",
  minDataValue: 0,
  maxDataValue: 60,
  minSize: 8,
  maxSize: 40
};
renderer.visualVariables = [ sizeVisualVariable ];

// Thematic stops variable (similar to proportional size)
renderer.visualVariables = [{
  type: "size",
  field: "POP_POVERTY",
  normalizationField: "TOTPOP_CY",
  legendOptions: {
    title: "% population in poverty by county"
  },
  stops: [
    { value: 0.15, size: 4, label: "<15%" },
    { value: 0.25, size: 12, label: "25%" },
    { value: 0.35, size: 24, label: ">35%" }
  ]
}];

// Real world size for 3D objects
const treeSizeVisualVariables = [{
  type: "size",
  axis: "height",
  field: "Height", // tree height
  valueUnit: "feet"
}, {
  type: "size",
  axis: "width",
  field: "Width_EW", // crown diameter from east to west
  valueUnit: "feet"
}, {
  type: "size",
  axis: "depth",
  field: "Width_NS", // crown diameter from north to south
  valueUnit: "feet"
}];
renderer.visualVariables = treeSizeVisualVariables;

构造函数

new SizeVariable(properties)

参数：

properties Object optional 有关可能传递到构造函数中的所有属性的列表，请参阅属性 。

属性概览

属性详细信息

axis String

仅在 SceneView 中工作时适用。定义使用 ObjectSymbol3DLayer 渲染要素时应应用大小视觉变量的轴。

可能的值	说明
width	符号从东到西的直径。
depth	符号从北到南的直径。
height	符号的高度。
width-and-depth	将大小视觉变量应用于宽度轴和深度轴。
all	将大小视觉变量应用于所有轴。

可能的值："width"|"depth"|"height"|"width-and-depth"|"all"

默认值：all

另请参阅：

• RealWorldSize

declaredClass Stringreadonly inherited

类的名称。声明的类名的格式为 geoscene.folder.className。

field String inherited

数值属性字段的名称，其中包含用于确定每个要素的颜色/不透明度/大小/旋转的数据值。

legendOptions Object

一个对象，提供用于在图例中显示视觉变量的选项。

属性：

customValues Number[] optional 使用此处指定的值覆盖图例值。这通常用于将值从 SizeVariable 内插的值舍入为舍入数字。

showLegend Boolean optional 指示是否在图例中显示视觉变量。

title String optional 描述图例中视觉变量的可视化效果的标题。这优先于字段别名或 valueExpressionTitle。

maxDataValue Number

大小渐变中使用的最大数据值。字段或 valueExpression 返回的值等于或高于 maxDataValue 中定义的值的要素将以 maxSize 中定义的大小进行渲染。

maxSize Number|ScaleDependentStopsautocast

Autocasts from String|Object

用于渲染包含最大数据值的要素的大小。

• 设置数字时，所有 2D 符号和 3D 平面符号图层的大小均以点表示；大小以米表示所有 3D 体积符号。
• 仅 2D 符号和 3D 平面符号图层支持字符串值。字符串可以以点或像素为单位指定大小（例如 minSize: "16pt"、minSize: "12px"）。
• 使用对象时，数据值（在字段或 valueExpression 中定义）大于或等于给定视图比例的 maxDataValue 的要素的大小。

minDataValue Number

大小渐变中使用的最小数据值。字段或 valueExpression 返回的值等于或低于 maxDataValue 中定义的值的要素将以 minSize 中定义的大小进行渲染。

minSize Number|ScaleDependentStopsautocast

Autocasts from String|Object

用于渲染包含最小数据值的要素的大小。

• 设置数字时，所有 2D 符号和 3D 平面符号图层的大小均以点表示；大小以米表示所有 3D 体积符号。
• 仅 2D 符号和 3D 平面符号图层支持字符串值。字符串可以以点或像素为单位指定大小（例如 minSize: "16pt"、minSize: "12px"）。
• 使用对象时，数据值（在字段或 valueExpression 中定义）大于或等于给定视图比例的 minDataValue 的要素的大小。

normalizationField String

用于规范化给定字段中的数据的数值属性字段的名称。如果使用此字段，则 maxDataValue 和 minDataValue 或停靠点中的值应规范化为百分比或比率。

stops SizeStop[]autocast

Autocasts from Object[]

一个对象数组，它定义从字段或 valueExpression 返回的数据值到图标大小的映射。必须指定 2 - 6 个停靠点。停靠点必须根据每个停靠点中的 value 属性值以升序列出。

target String

当基于视图比例缩放面轮廓宽度时，此值必须为 outline。如果需要与缩放相关的图标，则应忽略此属性。

另请参阅：

• ScaleDependentStops

type Stringreadonly

视觉变量类型。

对于 SizeVariable，类型始终是"size"。

useSymbolValue Boolean

使用 ObjectSymbol3DLayer 在渲染器上设置大小视觉变量时，此属性指示是否将高度、宽度或深度属性定义的值应用于此视觉变量的相应轴，而不是按比例缩放此轴的值。查看此示例。

valueExpression String inherited

遵循 Arcade 可视化配置文件定义的规范的 Arcade 表达式。视觉变量中的表达式可以使用 $feature 全局变量引用字段值，并且必须返回一个数字。

从此表达式返回的值是用于驱动停靠点中定义的可视化的数据。这优先于字段。因此，此属性通常用作视觉变量中字段的替代项。

另请参阅：

• Arcade - 可视化配置文件

valueExpressionTitle String inherited

标题，用于标识和描述 valueExpression 属性中定义的关联 Arcade 表达式。在 legendOptions 属性中没有提供的 title 情况下，它显示为图例中相应视觉变量的标题。

valueRepresentation String

指定在映射实际大小时如何应用数据值。有关支持的值，请参阅下表。

值	说明
radius	点数据值表示圆形要素的半径。
diameter	点数据值表示圆形要素的直径。
area	点数据值表示要素的面积。
width	折线数据值表示线的宽度。
distance	折线数据值表示距中心线的距离（宽度的一半）。

已知限制

• 对于由 3D SceneView 中的实际大小驱动的平面 （2D） 线符号，不支持此属性。
• 数据值必须以视图空间参考的单位表示要素的平面大小。

可能的值："radius"|"diameter"|"area"|"width"|"distance"

valueUnit String

指示用于解释字段或 valueExpression 返回的值的度量单位。对于 3D 体积符号，默认值为 meters。如果数据值表示专题数量（例如，流量计数、人口普查数据等），则不应使用此属性。

已知限制

• 对于由 3D SceneView 中的实际大小驱动的平面 （2D） 线符号，不支持此属性。
• 数据值必须以视图空间参考的单位表示要素的平面大小。

可能的值："unknown"|"inches"|"feet"|"yards"|"miles"|"nautical-miles"|"millimeters"|"centimeters"|"decimeters"|"meters"|"kilometers"|"decimal-degrees"

另请参阅：

• RealWorldSize

方法概述

方法详细信息

clone(){SizeVariable}

创建 SizeVisualVariable 的深度克隆。

返回：

类型	说明
SizeVariable	调用此方法的大小视觉变量的深度克隆。

示例：

// Creates a deep clone of the visual variable
let renderer = renderer.visualVariables[0].clone();

flipSizes()

通过翻转停靠点中的大小来修改 SizeVariable。这适用于您希望使用较大图标渲染小数字（如等级 1、2、3）的方案。此函数对于在从 sizeRendererCreator 模块中的方法返回 SizeVariable 的大小时特别有用。

示例：

// flips the size ramp when a checkbox is clicked in the app UI
checkbox.addEventListener("change", function() {
  const renderer = layer.renderer.clone();
  const sizeVariable = renderer.visualVariables[0];
  sizeVariable.flipSizes();
  layer.renderer = renderer;
});

fromJSON(json){*}static

创建此类的新实例，并使用从 GeoScene 产品生成的 JSON 对象中的值对其进行初始化。传递到输入 json 参数中的对象通常来自对 REST API 中查询操作的响应或来自其他 GeoScene 产品的 toJSON() 方法。请参阅指南中的使用 fromJSON() 主题，了解有关何时以及如何使用此功能的详细信息和示例。

参数：

json Object GeoScene 格式的实例的 JSON 表示形式。有关各种输入 JSON 对象的结构示例，请参阅 GeoScene REST API documentation。

返回：

类型	说明
*	返回此类的新实例。

toJSON(){Object}

将此类的实例转换为其 GeoScene portal JSON 表示形式。有关详细信息，请参阅使用 fromJSON() 指南主题。

返回：

类型	说明
Object	此类实例的 GeoScene portal JSON 表示形式。

类型定义

BoundedMinMax

定义具有最小和最大边界的大小视觉变量。将具有此规范的对象应用于渲染器的 visualVariables 属性时，要素大小将受最小和最大数据值的约束。值为大于所提供最大值的要素分配指定的最大大小。同样，值为小于提供的最小值的要素分配指定的最小大小。值为介于最小值和最大值之间的要素分配了相应的大小，该大小在最小值和最大大小值之间进行线性插值。

下面定义了此大小视觉变量类型的属性。

属性：

type String 值必须为 size。

field String optional 请参阅字段。

normalizationField String optional 请参阅 normalizationField。

valueExpression String optional 请参阅 valueExpression。

valueExpressionTitle String optional 请参阅 valueExpressionTitle。

maxDataValue Number 请参阅 maxDataValue。

maxSize String|Number 用于渲染包含最大数据值的要素的大小。 设置数字时，所有 2D 符号和 3D 平面符号图层的大小均以点表示；大小以米表示所有 3D 体积符号。 仅 2D 符号和 3D 平面符号图层支持字符串值。字符串可以以点或像素为单位指定大小（例如 minSize: "16pt"、minSize: "12px"）。

minDataValue Number 请参阅 minDataValue。

minSize String|Number 用于渲染包含最小数据值的要素的大小。 设置数字时，所有 2D 符号和 3D 平面符号图层的大小均以点表示；大小以米表示所有 3D 体积符号。 仅 2D 符号和 3D 平面符号图层支持字符串值。字符串可以以点或像素为单位指定大小（例如 minSize: "16pt"、minSize: "12px"）。

示例：

// thematic size defined with min and max data values
const sizeVisVar = {
  type: "size",
  field: "POPULATION",
  // features with this value or lower will be assigned the size defined in minSize
  minDataValue: 5000,
  // features with this value or higher will be assigned the size defined in maxSize
  maxDataValue: 1000000,
  minSize: "6px",
  maxSize: "80px"
};
renderer.visualVariables = [ sizeVisVar ];

// 3D thematic extrusion
const sizeVisVar = {
  type: "size",
  field: "POP_POVERTY",
  normalizationField: "TOTPOP_CY",
  minDataValue: 0.10,  // 10% of population in poverty
  maxDataValue: 0.35,  // 35% of population in poverty
  minSize: 10000,  // extruded by 10,0000 meters
  maxSize: 500000  // extruded by 500,000 meters
};
renderer.visualVariables = [ sizeVisVar ];

RealWorldSize

定义一个大小视觉变量，其中数据值被解释为基于给定单位的实际大小。然后根据实际测量值（而不是专题值和屏幕单位）确定要素大小。

数据值必须以视图空间参考的单位表示要素的平面大小。这将正确渲染每个要素的大小以及其他业务图层和基础图层中的所有其他要素。

下面提供了此对象的对象规范。

属性：

axis String optional 请参阅轴。仅在 SceneView 中工作时适用。

type String 值必须为 size。

field String optional 请参阅字段。字段名称，以视图空间参考的单位包含要素的平面大小。

normalizationField String optional 请参阅 normalizationField。

valueExpression String optional 请参阅 valueExpression。表达式必须以视图空间参考的单位返回要素的平面大小。

valueUnit String optional 请参阅 valueUnit。

valueRepresentation String optional 请参阅 valueRepresentation。

另请参阅：

• 示例 - 根据实际大小缩放要素大小 （2D）

• 示例 - 根据实际高度拉伸建筑物覆盖区

• 示例 - 具有逼真的 3D 符号的专题可视化

示例：

// real-world size for 3D buildings
const sizeVisVar = {
  // The type must be set to size
  type: "size",
  // Assign the field name to visualize with size
  field: "HEIGHT",
  valueUnit: "feet"
};
renderer.visualVariables = [ sizeVisVar ];

// real-world size for 2D tree canopies
const sizeVisVar = {
  // The type must be set to size
  type: "size",
  // Assign the field name to visualize with size
  field: "CANOPY",
  valueUnit: "feet",
  valueRepresentation: "diameter"
};
renderer.visualVariables = [ sizeVisVar ];

// real-world size for 3D using axis property
const crownRenderer = {
  type: "simple", // autocasts as new SimpleRenderer()
  symbol: sym, // set from the code snippet in step 3
  visualVariables: [
     {
       type: "size",
       axis: "height", // specify which axis to apply the data values to
       field: "Crown_Height",
       valueUnit: "feet"
     },
     {
       type: "size",
       axis: "width",
       field: "Width_EW",
       valueUnit: "feet"
     },
     {
       type: "size",
       axis: "depth", // specify which axis to apply the data values to
       field: "Width_NS",
       valueUnit: "feet"
     }
   ]
};

ScaleDependentIcons

基于与 BoundedMinMax 情况类似的最小和最大边界，在大小视觉变量中定义图标大小。但是，此规范允许开发人员根据 MapView.scale 指定各种最小和最大大小。

值为大于提供的最大值的要素分配了给定视图比例的指定最大大小。同样，将为值小于所提供最小值的要素分配给定视图比例的指定最小大小。值为最小值和最大值之间的要素分配了相应的大小，该大小在给定比例值的最小值和最大大小值之间线性插值。

下面提供了此对象的对象规范。

已知限制

SceneView 中当前不支持与比例相关的大小视觉变量。::

属性：

type String 值必须为 size。

field String optional 请参阅字段。

normalizationField String optional 请参阅 normalizationField。

valueExpression String optional 请参阅 valueExpression。

maxDataValue Number 请参阅 maxDataValue。

maxSize ScaleDependentStops 定义要素大小的对象，其数据值（在 field 或 valueExpression 中定义）大于或等于给定视图比例的 maxDataValue 。

minDataValue Number 请参阅 minDataValue。

minSize ScaleDependentStops 定义要素大小的对象，其数据值（在 field 或 valueExpression 中定义）小于或等于给定视图比例的 minDataValue 。

另请参阅：

• 示例 - 使用客户端图形创建 FeatureLayer

示例：

// scale-dependent size
const sizeVisVar = {
  type: "size",
  field: "pop2000",
  minDataValue: 500000,
  maxDataValue: 33000000,
  // minimum size to render minDataVal at specified view scales
  minSize: {
    type: "size",
    valueExpression: "$view.scale",
    stops: [
     { value: 1128,      size: 12 },  // smallest marker will be 12pt at 1:1128 scale
     { value: 288895,    size: 12 },
     { value: 73957191,  size: 7 },
     { value: 591657528, size: 1.5 }  // smallest marker will be 1.5pt at 1:591657528 scale
   ]
 },
 // maximum size to render maxDataVal at specified view scales
 maxSize: {
   type: "size",
   valueExpression: "$view.scale",
   stops: [
     { value: 1128,      size: 60 },  // largest marker will be 60pt at 1:1128 scale
     { value: 288895,    size: 60 },
     { value: 73957191,  size: 37 },
     { value: 591657528, size: 19 }  // largest marker will be 19pt at 1:591657528 scale
   ]
 }
};
renderer.visualVariables = [ sizeVisVar ];

ScaleDependentStops

在基于 MapView.scale 的大小视觉变量中定义要素大小和轮廓宽度。它还在 ScaleDependentIcons 大小视觉变量中提供了 minSize 和 maxSize 属性的规范。

下面提供了此对象的对象规范。

已知限制

SceneView 中当前不支持与比例相关的大小视觉变量。

属性：

type String 值必须为 size。

valueExpression String 值必须为 $view.scale。

target String optional 当基于视图比例缩放面轮廓宽度时，此值必须为 outline。如果需要与缩放相关的图标，则应忽略此属性。

stops SizeStop[] 一个对象数组，用于定义给定比例下图标的大小 value（或面轮廓的宽度）。必须指定 2 - 6 个停靠点。停靠点必须根据每个停靠点中的 value 属性值以升序列出。当 MapView.scale 等于停靠点中的 value 时，图标（或轮廓）将以相应的大小渲染。

另请参阅：

• 示例 - 使用客户端图形创建 FeatureLayer

示例：

// scale-dependent size
const sizeVisVar = {
  type: "size",
  field: "pop2000",
  minDataValue: 500000,
  maxDataValue: 33000000,
  // minimum size to render minDataVal at specified view scales
  minSize: {
    type: "size",
    valueExpression: "$view.scale",
    stops: [
     { value: 1128,      size: 12 },  // smallest marker will be 12pt at 1:1128 scale
     { value: 288895,    size: 12 },
     { value: 73957191,  size: 7 },
     { value: 591657528, size: 1.5 }  // smallest marker will be 1.5pt at 1:591657528 scale
   ]
 },
 // maximum size to render maxDataVal at specified view scales
 maxSize: {
   type: "size",
   valueExpression: "$view.scale",
   stops: [
     { value: 1128,      size: 60 },  // largest marker will be 60pt at 1:1128 scale
     { value: 288895,    size: 60 },
     { value: 73957191,  size: 37 },
     { value: 591657528, size: 19 }  // largest marker will be 19pt at 1:591657528 scale
   ]
 }
};
renderer.visualVariables = [ sizeVisVar ];

// scale-dependent size targeting polygon outlines
const sizeVisVar = {
  type: "size",
  valueExpression: "$view.scale",
  target: "outline"
  stops: [
    { value: 1128,      size: 3 },  // outline widths will be 3pt at 1:1128 scale
    { value: 288895,    size: 2 },
    { value: 73957191,  size: 1 },
    { value: 591657528, size: 0 }  // outlines widths will be 0pt at 1:591657528 scale
  ]
};
renderer.visualVariables = [ sizeVisVar ];

ThematicStops

定义两个或多个停靠点，在该停靠点处，要素大小将映射到大小视觉变量中的数据值。设置两个停靠点与创建 BoundedMinMax 大小视觉变量具有相同的效果。通过添加其他停靠点，您可以将特定大小映射到数据值。尺寸在停靠点值之间线性插值。

下面提供了此对象的对象规范。

属性：

type String 值必须为 size。

field String optional 请参阅字段。

normalizationField String optional 请参阅 normalizationField。

valueExpression String optional 请参阅 valueExpression。

stops SizeStop[] 在一系列数据或表达式中定义专题大小渐变的对象数组停靠点。至少需要两个停靠点。停靠点必须根据每个停靠点中的 value 属性值以升序列出。

另请参阅：

• 示例 - 连续大小

• 示例 - 通过拉伸按专题可视化要素

示例：

const sizeVisVar = {
  type: "size",
  field: "POPULATION",
  stops: [
    { value: 5000, size: "6px" },
    { value: 1000000, size: "80px" }
  ]
};
renderer.visualVariables = [ sizeVisVar ];

const sizeVisVar = {
  type: "size",
  valueExpression: "( $feature.TOT_VOTES / $feature.REG_VOTERS ) * 100",
  stops: [
    { value: 30, size: "6px" },
    { value: 70, size: "60px" }
  ]
};
renderer.visualVariables = [ sizeVisVar ];