location
require(["esri/renderers/smartMapping/symbology/location"], function(locationSchemes) { /* code goes here */ });
esri/renderers/smartMapping/symbology/location
Object containing helper methods for generating optimal symbols for location-only 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 | |
---|---|---|---|---|
LocationScheme | Clones a location scheme object. more details | more details | location | |
LocationSchemes | Returns a primary scheme and secondary schemes defining symbol properties for location-only visualizions in a FeatureLayer or SceneLayer. more details | more details | location |
Method Details
- cloneScheme(scheme){LocationScheme}
Clones a location scheme object.
Parameter:scheme LocationSchemeThe location scheme object to clone.
Returns:Type Description LocationScheme Returns a clone of the given location scheme object. Example:// clones the primary scheme returned from the getSchemes() method var locationScheme = primaryScheme.clone();
- getSchemes(params){LocationSchemes}
Returns a primary scheme and secondary schemes defining symbol properties for location-only visualizions in a FeatureLayer or SceneLayer. The
basemap
parameter determines the color of the graphics used to visualize each feature. ThegeometryType
determines which type of symbol to return.Parameters:params ObjectSee the table below for details of each parameter that may be passed to this function.
Specification:The basemap to pair with the visualization. This value indicates the best symbol color for visualizing features on top of the given basemap.
geometryType StringThe geometry type of the features to visualize.
Possible Values: point | multipoint | polyline | polygon | meshview SceneViewoptionalThe 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 BooleanoptionalIndicates if the size units of the scheme will be in meters. This should be
true
when the scheme is intended for 3D volumetric symbology. Aview
must be provided if this property is set totrue
.Returns:Type Description LocationSchemes Returns an object containing the optimal location scheme (and secondary schemes) to use for the given basemap. Example:// gets the primary scheme for the features of the given geometry type and basemap var schemes = locationSchemes.getSchemes({ basemap: map.basemap, geometryType: featureLayer.geometryType }); // the best default scheme for the layer, basemap, and theme var primaryScheme = schemes.primaryScheme;
Type Definitions
Defines the symbology scheme used to visualize default location-based symbols depending on the layer's geometry type.
- LocationSchemeForMesh
Properties defining the location-only symbology scheme used to visualize mesh features.
- LocationSchemeForPoint
Properties defining the location-only symbology scheme used to visualize point features.
- LocationSchemeForPolygon
Properties defining the location-only symbology scheme used to visualize polygon features.
- LocationSchemeForPolyline
Properties defining the location-only symbology scheme used to visualize polyline features.
- LocationSchemes
The return object of the getSchemes() method.
- Properties:
- primaryScheme LocationScheme
The location scheme best suited for the given basemap and geometry type.
secondarySchemes LocationScheme[]Additional location schemes that may be used to visualize data of the given geometry type overlaid on the given basemap.
basemapId StringThe ID of the basemap associated with the given schemes.