size

AMD: require(["esri/smartMapping/symbology/size"], (sizeSchemes) => { /* code goes here */ });
ESM: import * as sizeSchemes from "@arcgis/core/smartMapping/symbology/size.js";
Object: esri/smartMapping/symbology/size
Since: ArcGIS Maps SDK for JavaScript 4.2

Object containing helper methods for generating optimal symbols for data-driven size visualizations. The getSchemes() method is used to generate symbol properties best suited to the given geometry type and basemap.

Method Overview

Name Return Type Summary Object
SizeScheme

Clones a size scheme object.

size
SizeSchemes

Returns a primary scheme and secondary schemes defining symbol properties for size-based data-driven visualizations in a FeatureLayer.

size
Theme[]

Returns metadata for the available themes.

size

Method Details

cloneScheme

Method
cloneScheme(scheme){SizeScheme}

Clones a size scheme object.

Parameter
scheme SizeScheme

The SizeScheme object to clone.

Returns
Type Description
SizeScheme Returns a clone of the given size scheme object.
Example
// clones the primary scheme returned from the getSchemes() method
let sizeScheme = primaryScheme.clone();

getSchemes

Method
getSchemes(params){SizeSchemes}

Returns a primary scheme and secondary schemes defining symbol properties for size-based data-driven visualizations in a FeatureLayer. The basemap parameter determines the color of the graphics used to visualize each feature. The geometryType determines which type of symbol to return.

Parameters
Specification
params Object

See the table below for details of each parameter that may be passed to this function.

Specification
basemap String|Basemap
optional

The Esri basemap to pair with the visualization. This value indicates the best symbol colors for visualizing features against the given basemap. If you have a non-Esri basemap (e.g. a VectorTileLayer basemap with a custom style) or no basemap at all, then use the basemapTheme parameter instead of this parameter.

basemapTheme String
optional

If you have a non-Esri basemap (e.g. a VectorTileLayer basemap with a custom style) or no basemap at all, use this parameter to indicate whether the background of the visualization is light or dark.

Possible Values:"light"|"dark"

geometryType String

The geometry type of the features to visualize.

Possible Values:"point"|"multipoint"|"polyline"|"polygon"

view SceneView
optional

The SceneView instance in which the scheme will be used. This property is only applicable when the scheme will be used in conjunction with 3D symbols.

worldScale Boolean
optional

Indicates if the size units of the scheme will be in meters. This should be true when the scheme is intended for 3D volumetric symbology. A view must be provided if this property is set to true.

Returns
Type Description
SizeSchemes Returns an object containing the optimal size scheme to use for the given basemap and secondary schemes that may also be used.
Example
// gets the primary scheme for the features of the given geometry type and basemap
let schemes = sizeSchemes.getSchemes({
  basemap: map.basemap,
  geometryType: featureLayer.geometryType
});

// the best default scheme for the layer and basemap
let primaryScheme = schemes.primaryScheme;

getThemes

Method
getThemes(basemap){Theme[]}

Returns metadata for the available themes. If a basemap is provided, returns themes that work best with the given basemap.

Parameter
basemap String|Basemap
optional

The Esri basemap string or object that will be used with the returned theme(s).

Returns
Type Description
Theme[] Returns an object containing information about the available themes for the given basemap.

Type Definitions

SizeScheme

Type Definition
SizeScheme SizeSchemeForPoint|SizeSchemeForPolyline|SizeSchemeForPolygon

Properties defining the symbology scheme used to visualize features with attribute data-driven size.

SizeSchemeForPoint

Type Definition
SizeSchemeForPoint

Properties defining the symbology scheme used to visualize point features driven by attribute data.

Properties
color Color

The fill color of the marker symbol.

noDataColor Color

The color of the marker symbol used to indicate features with no data and features that are out of range.

outline Object

Properties for defining the outline of the marker symbol.

Specification
color Color

The outline color of the marker symbol.

width Number

The width of the marker symbol in pixels or points.

size Number

The default size of the marker symbol in pixels or points.

noDataSize Number

The size of the marker symbol (in pixels or points) used to indicate features with no data and features that are out of range.

minSize Number

The minimum size of a marker symbol in pixels or points representing features with low data values.

maxSize Number

The maximum size of a marker symbol in pixels or points representing features with high data values.

opacity Number

The opacity of the marker symbol.

SizeSchemeForPolygon

Type Definition
SizeSchemeForPolygon

Properties defining the symbology scheme used to visualize polygon features driven by attribute data. When visualized by size, polygons are represented with marker symbols.

Properties

The scheme defining the symbology of the marker symbol used to represent polygon features by size.

background Object

The schema defining the backgound symbol of the feature. This is a fill symbol.

Properties
color Color

The color of the fill symbol representing the polygon.

outline Object

Properties for defining the outline of the background fill symbol.

Specification
color Color

The outline color of the background fill symbol.

width Number

The width of the background fill symbol's outline in pixels or points.

opacity Number

The opacity of the symbol.

SizeSchemeForPolyline

Type Definition
SizeSchemeForPolyline

Properties defining the symbology scheme used to visualize polyline features driven by attribute data.

Properties
color Color

The color of the line symbol.

noDataColor Color

The color of the line symbol used to indicate features with no data and features that are out of range.

width Number

The default width of the line symbol in pixels or points.

noDataWidth Number

The width of the line symbol in pixels or points used to indicate features with no data and features that are out of range.

minWidth Number

The minimum width of a line symbol in pixels or points representing features with low data values.

maxWidth Number

The maximum width of a line symbol in pixels or points representing features with high data values.

opacity Number

The opacity of the line symbol.

SizeSchemes

Type Definition
SizeSchemes

The return object of the getSchemes() method.

Properties
primaryScheme SizeScheme

The size scheme best suited for the given basemap and geometry type.

secondarySchemes SizeScheme[]

Additional size schemes that may be used to visualize data of the given geometry type overlaid on the given basemap.

basemapId String

The ID of the basemap associated with the given schemes.

basemapTheme String

Indicates whether the average basemap color is light or dark.

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.