size
require(["esri/renderers/smartMapping/creators/size"], function(sizeRendererCreator) { /* code goes here */ });
esri/renderers/smartMapping/creators/size
This object contains helper methods for generating data-driven visualizations with continuous size or class breaks based on a field value or expression from features in a Layer. The methods in this module generate renderer or visual variable objects that may be applied directly to a supported layer. The renderers specify how features should be visualized based on data values and sizes optimized based on the indicated basemap.
Known Limitations
- Currently, 3D symbols can only be generated for layers with a
point
geometry type. - Only FeatureLayer, SceneLayer, and CSVLayer layer types are currently supported, except in the following scenarios:
- SceneLayers with
mesh
geometryType - SceneLayers without the
supportsRenderer
andsupportsLayerQuery
capabilities enabled, unless a predefined statistics object is passed to thestatistics
parameter of the method in conjunction with the layer. To check a SceneLayer's capabilities, use the getFieldInfoUsage() method.
- SceneLayers with
- You cannot generate renderers and visual variables using SQL expressions for client-side FeatureLayers in a SceneView.
- See also:
Method Overview
Name | Return Type | Summary | Object | |
---|---|---|---|---|
Promise<AgeRendererResult> | Generates a continuous size Renderer representing the age of features based on one or more fields. more details | more details | size | |
Promise<ClassBreaksRendererResult> | Generates a ClassBreaksRenderer that may be applied directly to the layer used to call this method. more details | more details | size | |
Promise<ContinuousRendererResult> | Generates a Renderer that may be applied directly to the layer used to call this method. more details | more details | size | |
Promise<VisualVariableResult> | This method generates an array of size visual variables with default stops that are optimally chosen based on the statistics queried for the indicated field or expression and mapped to appropriate sizes. more details | more details | size |
Method Details
- createAgeRenderer(params){Promise<AgeRendererResult>}Since: ArcGIS API for JavaScript 4.9
Generates a continuous size Renderer representing the age of features based on one or more fields. The age of a feature is calculated based on a given
startTime
andendTime
, one of which must be a date field in the inputlayer
. This method generates an Arcade expression and calculates statistics on the output of the expression to accomplish this. The resulting renderer contains a continuous size visual variable that maps optimal sizes based on the indicated basemap to data values based on the resulting statistics of the expression.You are required to provide a
layer
,view
,startTime
, andendTime
to generate this renderer. Optionally, you can set aunit
for the visualization. Other options are provided for convenience for more involved custom visualization authoring applications. For example, if you already generated statistics in another operation, you can pass the statistics object to thestatistics
parameter to avoid making an extra call to the server.Parameters:params ObjectInput parameters for generating a continuous size visualization of age for time data returned from start and/or end date field(s). See the table below for details of each parameter.
Specification:layer FeatureLayer|SceneLayer|CSVLayerThe layer for which the visualization is generated.
view ViewThe view instance in which the visualization will be rendered.
The name of the field, or a date value representing the start time in the age calculation. If a date value is specified, then the
endTime
paramter must reference a Date field in the layer.The name of the field, or a date value representing the end time in the age calculation. If a date value is specified, then the
startTime
paramter must reference a Date field in the layer.unit StringoptionalThe time unit used to calculate the difference between
endTime
andstartTime
. If a unit is not specified, then a suggested unit is determined based on the spread and distribution of the data.Possible Values: years | months | days | hours | minutes | seconds
optional Default Value: grayThe named string or basemap object of the Esri basemap that will be paired with the output visualization.
legendOptions ObjectoptionalProvides options for modifying Legend properties describing the visualization.
Specification:title StringoptionalThe title used to represent the age size ramp in the Legend.
showLegend BooleanoptionalIndicates whether to include the age renderer in the legend.
statistics SummaryStatisticsResultoptionalA statistics object generated from the summaryStatistics function. The
createAgeRenderer()
method generates an Arcade expression and executes a statistics query against the layer for the result of the expression. If statistics for the expression have already been generated, then pass the object here to avoid making a second statistics query.sizeScheme SizeSchemeoptionalIn authoring apps, the user may select a pre-defined size scheme. Pass the scheme object to this property to avoid getting one based on the
basemap
.symbolType StringoptionalDefault Value: 2dThe type of symbol to generate. This depends on the view in which you are working and the desired visualization. This parameter does not need to be specified for layers with a
mesh
geometry type. Possible values are described below.Value Description 2d Generates a visualization using 2D symbols such as SimpleMarkerSymbol, SimpleLineSymbol, or SimpleFillSymbol. Use this option if generating a visualization for data in a MapView. 3d-flat Generates a visualization using 3D symbols with flat symbol layers such as IconSymbol3DLayer, LineSymbol3DLayer, or FillSymbol3DLayer. Use this option if generating a 2D visualization for data in a SceneView. 3d-volumetric Generates a visualization using 3D symbols with volumetric symbol layers such as ObjectSymbol3DLayer, PathSymbol3DLayer, or ExtrudeSymbol3DLayer. Use this option if generating a 3D visualization for data in a SceneView. A SceneView instance must be provided to the view
parameter if this option is used.defaultSymbolEnabled BooleanoptionalDefault Value: trueEnables the
defaultSymbol
on the renderer and assigns it to features with no value.Returns:Type Description Promise<AgeRendererResult> Resolves to an instance of AgeRendererResult. Examples:const layer = new FeatureLayer({ url: "https://services.arcgis.com/V6ZHFr6zdgNZuVG0/arcgis/rest/services/311_Service_Requests_from_2015_50k/FeatureServer/0" }); // visualization based age of incidents closed passed their due date // or the number of days an incident was overdue at the time of closure. const ageParams = { layer: layer, view: view, basemap: map.basemap, // "gray" startTime: "Due_Date", endTime: "Closed_Date", unit: "days" }; // when the promise resolves, apply the renderer to the layer sizeRendererCreator.createAgeRenderer(ageParams) .then(function(response){ layer.renderer = response.renderer; });
const layer = new CSVLayer({ url: "https://earthquake.usgs.gov/earthquakes/feed/v1.0/summary/2.5_week.csv", copyright: "USGS Earthquakes" }); // visualization based off current age of incident const ageParams = { layer: layer, basemap: "topo", view: view, startTime: "time", endTime: Date.now(), legendOptions: { title: "Time since earthquake struck" } }; // when the promise resolves, apply the renderer to the layer sizeRendererCreator.createAgeRenderer(ageParams) .then(function(response){ layer.renderer = response.renderer; });
- createClassBreaksRenderer(params){Promise<ClassBreaksRendererResult>}Since: ArcGIS API for JavaScript 4.6
Generates a ClassBreaksRenderer that may be applied directly to the layer used to call this method. The resulting renderer defines the symbol size of each feature based on the value of the given
field
value. A default size scheme is determined based on the givenbasemap
. Depending on theclassificationMethod
, class breaks (or data ranges) are generated based on the statistics of the data. Each feature is assigned a size based on the class break in which the value of thefield
falls.In most cases you will provide a
layer
,basemap
,field
, andclassificationMethod
to generate this renderer. This is a scenario in which the statistics of the data aren't well known and the user doesn't know what sizes to use in the visualization. You can also use avalueExpression
instead of afield
to visualize features based on a value returned from a script executed at runtime.The other options are provided for convenience for more involved custom visualization authoring applications.
Parameters:params ObjectInput parameters for generating a classed size visualization based on data returned from a given field or expression. See the table below for details of each parameter.
Specification:layer FeatureLayer|SceneLayer|CSVLayerThe layer for which the visualization is generated.
optional Default Value: grayThe named string or basemap object of the Esri basemap that will be paired with the output visualization.
field StringThe name of the field whose data will be queried for statistics and classified. This property is ignored if a
valueExpression
is used.normalizationField StringoptionalThe name of the field to normalize the values of the given
field
. Providing a normalization field helps minimize some visualization errors and standardizes the data so all features are visualized with minimal bias due to area differences or count variation. This option is commonly used when visualizing densities.normalizationType StringoptionalIndicates how the data is normalized. The data value obtained from the
field
is normalized in one of the following ways before it is compared with the class breaks. See the table below for a list of possible values.Possible Value Description field Divides the field
value by the value ofnormalizationField
. This value is set by default if thenormalizationField
is provided.log Computes the base 10 logarithm of the data value. This can be a useful approach for some data distributions because it reduces the influence of very large data values. percent-of-total Divides the data value by the sum of all data values then multiplies by 100. Use normalizationTotal
to define the total value by which to normalize. This value is set by default if thenormalizationTotal
is provided.With the exception of
log
normalization, data normalization creates a ratio by dividing two values. When comparing attribute values between features, normalization minimizes the effect of varying map areas and the number of observations. For example, dividing the 18 to 30 year old population by the area of a polygon feature yields a density value that can be compared evenly with other features, regardless of their size.normalizationTotal NumberoptionalWhen
normalizationType
ispercent-of-total
, this property contains the total of all data values.classificationMethod StringoptionalDefault Value: equal-intervalThe classification method used for generating breaks. See the table below for a list of possible values.
Possible Value Description equal-interval Divides the range of attribute values into equal-sized subranges. For example, if you specify three classes for a field whose values range from 0 to 300, this method will create three classes with ranges of 0–100, 101–200, and 201–300. Equal interval is best applied to familiar data ranges, such as percentages and temperature. This method emphasizes the amount of an attribute value relative to other values. For example, it could show if a store is part of the group of stores that make up the top one-third of all sales. natural-breaks Groups similar values that maximize the differences between classes. Features are divided into classes whose boundaries are set where there are relatively big differences in the data values. Natural breaks are data-specific classifications and not useful for comparing multiple maps built from different underlying information. quantile Assigns the same number of data values to each class. This is well suited to linearly distributed data. Because features are grouped in equal numbers in each class, the resulting map can often be misleading. Similar features can potentially be placed in adjacent classes, or features with widely different values can be put in the same class. You can minimize this distortion by increasing the number of classes. standard-deviation Creates class breaks with equal value ranges that are a proportion of the standard deviation. This is usually done at intervals of one, one-half, one-third, or one-fourth standard deviations from the mean. standardDeviationInterval NumberoptionalDefault Value: 1If a
standard-deviation
classification method is used, then this indicates the interval by which to generate class breaks.Possible Values: 1 | 0.5 | 0.33 | 0.25
numClasses NumberoptionalDefault Value: 5The number of class breaks to generate. This is ignored if a
standard-deviation
classification method is specified.sizeScheme SizeSchemeoptionalIn authoring apps, the user may select a pre-defined size scheme. Pass the scheme object to this property to avoid getting one based on the
basemap
.valueExpression StringoptionalAn Arcade expression that returns a number. This expression can reference field values using the
$feature
global variable. This property overrides thefield
property and therefore is used instead of an inputfield
value.valueExpressionTitle StringoptionalText describing the value returned from the
valueExpression
. This is used by the Legend widget.sqlExpression StringoptionalA SQL expression evaluating to a number.
sqlWhere StringoptionalA SQL where clause used to filter features for the statistics query. For example, this is useful in situations where you want to avoid dividing by zero as is the case with creating a predominance visualization.
legendOptions ObjectoptionalProvides options for setting a title to describe a field instead of using the field name. This title will represent the field in the Legend.
Specification:title StringoptionalThe title used to represent the given field or expression in the Legend.
minValue NumberoptionalA minimum value set by the user. Use this in conjunction with
maxValue
to generate class breaks between lower and upper bounds. This will be the lower bound of the lowest class break.maxValue NumberoptionalA maximum value set by the user. Use this in conjunction with
minValue
to generate class breaks between lower and upper bounds. This will be the upper bound of the highest class break.defaultSymbolEnabled BooleanoptionalDefault Value: trueEnables the
defaultSymbol
on the renderer and assigns it to features with no value and features that do not fall within the configured data range.view ViewoptionalThe view instance in which the visualization will be rendered. A SceneView is required if
symbolType = "3d-volumetric"
or3d-volumetric-uniform
. The relevant SceneView or MapView is required when avalueExpression
is specified.symbolType StringoptionalDefault Value: 2dThe type of symbol to generate. This depends on the view in which you are working and the desired visualization. Possible values are described below.
Value Description 2d Generates a visualization using 2D symbols such as SimpleMarkerSymbol, SimpleLineSymbol, or SimpleFillSymbol. Use this option if generating a visualization for data in a MapView. 3d-flat Generates a visualization using 3D symbols with flat symbol layers such as IconSymbol3DLayer, LineSymbol3DLayer, or FillSymbol3DLayer. Use this option if generating a 2D visualization for data in a SceneView. 3d-volumetric Generates a visualization using 3D symbols with volumetric symbol layers such as ObjectSymbol3DLayer, PathSymbol3DLayer, or ExtrudeSymbol3DLayer. Use this option if generating a 3D visualization for data in a SceneView and only the symbol's height should be variable, for example with cylinders. A SceneView instance must be provided to the view
parameter if this option is used.3d-volumetric-uniform Generates a visualization using uniformly sized 3D symbols with volumetric symbol layers. Use this option if generating a 3D visualization for data in a SceneView and the symbol should be sized uniformly, for example with spheres. A SceneView instance must be provided to the view
parameter if this option is used.Returns:Type Description Promise<ClassBreaksRendererResult> Resolves to an instance of ClassBreaksRendererResult. Examples:var layer = new FeatureLayer({ url: "https://services.arcgis.com/V6ZHFr6zdgNZuVG0/arcgis/rest/services/counties_politics_poverty/FeatureServer/0" }); // visualization based on field and normalization field var sizeParams = { layer: layer, basemap: map.basemap, // "gray" field: "POP_POVERTY", normalizationField: "TOTPOP_CY", classificationMethod: "quantile", numClasses: 4 }; // when the promise resolves, apply the renderer to the layer sizeRendererCreator.createClassBreaksRenderer(sizeParams) .then(function(response){ layer.renderer = response.renderer; });
var layer = new FeatureLayer({ url: "https://services.arcgis.com/V6ZHFr6zdgNZuVG0/arcgis/rest/services/counties_politics_poverty/FeatureServer/0" }); // visualization based off Arcade expression var sizeParams = { layer: layer, basemap: "topo", classificationMethod: "equal-interval", valueExpression: "($feature.POP_POVERTY / $feature.TOTPOP_CY) * 100", view: view, legendOptions: { title: "% of people living in poverty" } }; // when the promise resolves, apply the renderer to the layer sizeRendererCreator.createClassBreaksRenderer(sizeParams) .then(function(response){ layer.renderer = response.renderer; });
- createContinuousRenderer(params){Promise<ContinuousRendererResult>}
Generates a Renderer that may be applied directly to the layer used to call this method. The renderer contains a continuous size visual variable that maps marker sizes to specific stop values based on queried statistics from the indicated field or expression.
In most cases you will provide a
layer
,basemap
, andfield
to generate this renderer. This is a scenario in which the statistics of the data aren't well known and the user doesn't know what sizes to use in the visualization. You can also use avalueExpression
instead of afield
to visualize features based on a value returned from a script executed at runtime.The other options are provided for convenience for more involved custom visualization authoring applications. For example, if you already generated statistics in another operation, you can pass the statistics object to the
statistics
parameter to avoid making an extra call to the server.Parameters:params ObjectInput parameters for generating size visual variables based on data returned from a given field or expression. See the table below for details of each parameter.
Specification:layer FeatureLayer|SceneLayer|CSVLayerThe layer for which the renderer is generated.
field StringoptionalThe name of the field whose data will be queried for statistics and used for the basis of the data-driven visualization. This property is ignored if a
valueExpression
is used.normalizationField StringoptionalThe name of the field to normalize the values of the given
field
. Providing a normalization field helps minimize some visualization errors and standardizes the data so all features are visualized with minimal bias due to area differences or count variation. This option is commonly used when visualizing densities.optional Default Value: grayThe named string or basemap object of the Esri basemap that will be paired with the output visualization.
sizeScheme SizeSchemeoptionalIn authoring apps, the user may select a pre-defined size scheme. Pass the scheme object to this property to avoid getting one based on the
basemap
.valueExpression StringoptionalAn Arcade expression that returns a number. This expression can reference field values using the
$feature
global variable. This property overrides thefield
property and therefore is used instead of an inputfield
value.valueExpressionTitle StringoptionalText describing the value returned from the
valueExpression
. This is used by the Legend widget.sqlExpression StringoptionalA SQL expression evaluating to a number.
sqlWhere StringoptionalA SQL where clause used to filter features for the statistics query. For example, this is useful in situations where you want to avoid dividing by zero as is the case with creating a predominance visualization.
legendOptions ObjectoptionalProvides options for setting a title to a field when an expression is provided instead of a field name. This title will represent the field in the Legend.
Specification:title StringoptionalThe title used to represent the given field or expression in the Legend.
showLegend BooleanoptionalIndicates whether to describe the renderer in the legend.
statistics SummaryStatisticsResultoptionalA statistics object generated from the summaryStatistics function. If statistics for the field have already been generated, then pass the object here to avoid making a second statistics query to the server.
minValue NumberoptionalA custom minimum value set by the user. Use this in conjunction with
maxValue
to generate statistics between lower and upper bounds. This will be the lowest stop in the returned size visual variable.maxValue NumberoptionalA custom maximum value set by the user. Use this in conjunction with
minValue
to generate statistics between lower and upper bounds. This will be the uppermost stop in the returned size visual variable.defaultSymbolEnabled BooleanoptionalDefault Value: trueEnables the
defaultSymbol
on the renderer and assigns it to features with no value and features that do not fall within the configured data range.view ViewoptionalThe view instance in which the visualization will be rendered. A SceneView is required if
symbolType = "3d-volumetric"
or3d-volumetric-uniform
. The relevant SceneView or MapView is required when avalueExpression
is specified.symbolType StringoptionalDefault Value: 2dThe type of symbol to generate. This depends on the view in which you are working and the desired visualization. Possible values are described below.
Value Description 2d Generates a visualization using 2D symbols such as SimpleMarkerSymbol, SimpleLineSymbol, or SimpleFillSymbol. Use this option if generating a visualization for data in a MapView. 3d-flat Generates a visualization using 3D symbols with flat symbol layers such as IconSymbol3DLayer, LineSymbol3DLayer, or FillSymbol3DLayer. Use this option if generating a 2D visualization for data in a SceneView. 3d-volumetric Generates a visualization using 3D symbols with volumetric symbol layers such as ObjectSymbol3DLayer, PathSymbol3DLayer, or ExtrudeSymbol3DLayer. Use this option if generating a 3D visualization for data in a SceneView and only the symbol's height should be variable, for example with cylinders. A SceneView instance must be provided to the view
parameter if this option is used.3d-volumetric-uniform Generates a visualization using uniformly sized 3D symbols with volumetric symbol layers. Use this option if generating a 3D visualization for data in a SceneView and the symbol should be sized uniformly, for example with spheres. A SceneView instance must be provided to the view
parameter if this option is used.Returns:Type Description Promise<ContinuousRendererResult> Resolves to an instance of ContinuousRendererResult. Examples:var layer = new FeatureLayer({ url: "https://services.arcgis.com/V6ZHFr6zdgNZuVG0/arcgis/rest/services/counties_politics_poverty/FeatureServer/0" }); // visualization based on field and normalization field var sizeParams = { layer: layer, basemap: map.basemap, // "gray" field: "POP_POVERTY", normalizationField: "TOTPOP_CY", }; // when the promise resolves, apply the renderer to the layer sizeRendererCreator.createContinuousRenderer(sizeParams) .then(function(response){ layer.renderer = response.renderer; });
var layer = new FeatureLayer({ url: "https://services.arcgis.com/V6ZHFr6zdgNZuVG0/arcgis/rest/services/counties_politics_poverty/FeatureServer/0" }); // visualization based off Arcade expression var sizeParams = { layer: layer, basemap: "topo", valueExpression: "($feature.POP_POVERTY / $feature.TOTPOP_CY) * 100", view: view, legendOptions: { title: "% of people living in poverty" } }; // when the promise resolves, apply the renderer to the layer sizeRendererCreator.createContinuousRenderer(sizeParams) .then(function(response){ layer.renderer = response.renderer; });
- createVisualVariables(params){Promise<VisualVariableResult>}
This method generates an array of size visual variables with default stops that are optimally chosen based on the statistics queried for the indicated field or expression and mapped to appropriate sizes.
There are two different ways this method may be called. The most common case is by providing a
layer
,basemap
, andfield
. This is the scenario where the statistics of the data aren't well known and the user doesn't know what sizes to use. You can optionally use avalueExpression
instead of a field to visualize features based on a numeric value returned from a script executed at runtime.The other options are provided for convenience for more involved custom visualization authoring applications. For example, if you already generated statistics in another operation, you can pass the object in the
statistics
parameter to avoid making an extra call to the server. You can also provide asizeScheme
if you don't want one picked for you. In this case thebasemap
andtheme
options would be ignored.The resulting array of visual variables will contain exactly one size visual variable unless the
axis
parameter is set to "height".Parameters:params ObjectInput parameters for generating size visual variables based on data returned from a given field or expression. See the table below for details of each parameter.
Specification:layer FeatureLayer|SceneLayer|CSVLayerThe layer for which the visual variables are generated.
field StringThe name of the field whose data will be queried for statistics and used for the basis of the data-driven visualization. This property is ignored if a
valueExpression
is used.normalizationField StringoptionalThe name of the field to normalize the values of the given
field
. Providing a normalization field helps minimize some visualization errors and standardizes the data so all features are visualized with minimal bias due to area differences or count variation. This option is commonly used when visualizing densities.optional Default Value: grayThe named string or basemap object of the Esri basemap that will be paired with the output visualization.
sizeScheme SizeSchemeoptionalIn authoring apps, the user may select a pre-defined size scheme. Pass the scheme object to this property to avoid getting one based on the
basemap
.valueExpression StringoptionalAn Arcade expression that returns a number. This expression can reference field values using the
$feature
global variable. This property overrides thefield
property and therefore is used instead of an inputfield
value.valueExpressionTitle StringoptionalText describing the value returned from the
valueExpression
. This is used by the Legend widget.sqlExpression StringoptionalA SQL expression evaluating to a number.
sqlWhere StringoptionalA SQL where clause used to filter features for the statistics query. For example, this is useful in situations where you want to avoid dividing by zero as is the case with creating a predominance visualization.
legendOptions ObjectoptionalProvides options for setting a title to a field when an expression is provided instead of a field name. This title will represent the field in the Legend.
Specification:title StringoptionalThe title used to represent the given field or expression in the Legend.
showLegend BooleanoptionalIndicates whether to describe the renderer in the legend.
statistics SummaryStatisticsResultoptionalA statistics object generated from the summaryStatistics function. If statistics for the field have already been generated, then pass the object here to avoid making a second statistics query to the server.
minValue NumberoptionalA custom minimum value set by the user. Use this in conjunction with
maxValue
to generate statistics between lower and upper bounds. This will be the lowest stop in the returned size visual variable.maxValue NumberoptionalA custom maximum value set by the user. Use this in conjunction with
minValue
to generate statistics between lower and upper bounds. This will be the uppermost stop in the returned size visual variable.view ViewoptionalWhen generating 3D symbols, a SceneView instance is required. The relevant SceneView or MapView is required when a
valueExpression
is specified.worldScale BooleanoptionalIndicates if the size units of the symbols will be in meters. This should be
true
when generating visualizations with 3D volumetric symbology. Aview
must be provided if this property is set totrue
.axis StringoptionalDefault Value: allWhen set to
all
, a single size variable that scales uniformly in all dimensions is generated. When set toheight
, the result contains two size visual variables: the first one sizes the height according to the field statistics, while the second defines a constant size for width and depth.Possible Values: all | height
Returns:Type Description Promise<VisualVariableResult> Resolves to an instance of VisualVariableResult. Examples:var layer = new FeatureLayer({ url: "https://services.arcgis.com/V6ZHFr6zdgNZuVG0/arcgis/rest/services/counties_politics_poverty/FeatureServer/0" }); // visualization based on field and normalization field var sizeParams = { layer: layer, basemap: map.basemap, // "gray" field: "POP_POVERTY", normalizationField: "TOTPOP_CY" }; // when the promise resolves, apply the visual variables to the renderer sizeRendererCreator.createVisualVariables(sizeParams) .then(function(response){ var renderer = layer.renderer.clone(); renderer.visualVariables = response.visualVariables; layer.renderer = renderer; });
var layer = new FeatureLayer({ url: "https://services.arcgis.com/V6ZHFr6zdgNZuVG0/arcgis/rest/services/counties_politics_poverty/FeatureServer/0" }); // visualization based off Arcade expression var sizeParams = { layer: layer, basemap: "topo", valueExpression: "($feature.POP_POVERTY / $feature.TOTPOP_CY) * 100", view: view, legendOptions: { title: "% of people living in poverty" } }; // when the promise resolves, apply the visual variables to the renderer sizeRendererCreator.createVisualVariables(sizeParams) .then(function(response){ var renderer = layer.renderer.clone(); renderer.visualVariables = response.visualVariables; layer.renderer = renderer; });
Type Definitions
- AgeRendererResultSince: ArcGIS API for JavaScript 4.9
The result object of the createAgeRenderer() method. See the table below for details of each property.
- Properties:
- renderer ClassBreaksRenderer
The renderer object configured to best match the given basemap and the spread of the data. Set this on a layer's
renderer
property to update its visualization.visualVariables SizeVisualVariable[]Size visual variables configured based on the statistics of the data and the given basemap and scheme.
unit StringThe time unit used to represent age in the output
renderer
.sizeScheme SizeSchemeThe size scheme used by the visual variables.
defaultValuesUsed BooleanIndicates whether default values are used in the absence of sufficient data and/or statistics from the layer. Default values are typically used when all features have the same field value or no value at all.
statistics SummaryStatisticsResultBasic statistics returned from a query for the generated expression.
basemapId StringThe ID of the basemap used to determine the optimal fill color of the features.
- ClassBreaksRendererResultSince: ArcGIS API for JavaScript 4.6
The result object of the createClassBreaksRenderer() method. See the table below for details of each property.
- Properties:
- renderer ClassBreaksRenderer
The renderer object configured to best match the given basemap and the spread of the data. Set this on a layer's
renderer
property to update its visualization.classBreaksResult ClassBreaksResultThis object describes class breaks generated from data in a layer for a given field with a specified classification method.
sizeScheme SizeSchemeThe size scheme used by the visual variables.
defaultValuesUsed BooleanIndicates whether default values are used in the absence of sufficient data and/or statistics from the layer. Default values are typically used when all features have the same field value or no value at all.
basemapId StringThe ID of the basemap used to determine the optimal fill color of the features.
- ContinuousRendererResult
The result object of the createContinuousRenderer() method. See the table below for details of each property.
- Properties:
- renderer ClassBreaksRenderer
The renderer object configured to best match the given basemap and the spread of the data. Set this on a layer's
renderer
property to update its visualization.visualVariables SizeVisualVariable[]Size visual variables configured based on the statistics of the data and the given basemap and scheme.
sizeScheme SizeSchemeThe size scheme used by the visual variables.
defaultValuesUsed BooleanIndicates whether default values are used in the absence of sufficient data and/or statistics from the layer. Default values are typically used when all features have the same field value or no value at all.
statistics SummaryStatisticsResultBasic statistics returned from a query to the service for data from the given field name or expression.
basemapId StringThe ID of the basemap used to determine the optimal fill color of the features.
- VisualVariableResult
The result object of the createVisualVariables() method. See the table below for details of each property.
- Properties:
- visualVariables SizeVisualVariable[]
An array of size visual variables configured based on the statistics of the data and the view scale.
sizeScheme SizeSchemeThe size scheme used by the main visual variable.
defaultValuesUsed BooleanIndicates whether default values were used in the absence of sufficient data and/or statistics from the layer. Default values are typically used when all features have the same field value or no value at all.
statistics SummaryStatisticsResultBasic statistics returned from a query to the service for the given field or expression.
basemapId StringThe ID of the basemap used to determine the optimal fill color of the features.
authoringInfo AuthoringInfoAuthoring information related to the creation of the visual variable. This includes information related to UI inputs from sliders and selected themes.