Feature layers can be created by referencing a layer from either a map service or a feature service. Use a map service if you just want to retrieve geometries and attributes from the server and symbolize them yourself. Use a feature service if you want to take advantage of symbols from the service’s source map document. Also, use a feature service if you plan on doing editing with the feature layer. Feature layers honor any feature templates configured in the source map document. Feature collection objects are used to create a feature layer based on the supplied definition.

Referenced by: operationalLayers

Properties

PropertyDetails
attributeTableInfoAn attributeTableInfo object defining how the data will be presented in tabular format.
customParametersA sequence of custom parameters appended to the URL of all requests related to a layer.
disablePopupIndicates whether to allow a client to ignore popups defined by the service item.
idA unique identifying string for the layer.
itemIdOptional string containing the item ID of the service if it’s registered on ArcGIS Online or your organization’s portal.
layerDefinitionAdditional properties that define drawing information and other configurations for the layer.
See layerDefinition properties table.
layerTypeString indicating the layer type.
Valid value of this property ArcGISFeatureLayer
listModeTo show or hide layers in the layer list
Valid values:
  • hide
  • show
opacityThe degree of transparency applied to the layer on the client side, where 0 is full transparency and 1 is no transparency.
pathFor offline data, a path to a geodatabase file. A URI format is used starting with file: followed by a file system path with a .geodatabase extension. A query parameter itemId must also be present specifying the ID of a table in the geodatabase’s GDB_ServiceItems table. A relative path must be from the file which defines the layer. For example file:../p20/northamerica.geodatabase?itemId=1.
popupInfoA popupInfo object defining the content of popup windows when you click or query a feature.
refreshIntervalRefresh interval of the layer in minutes. Non-zero value indicates automatic layer refresh at the specified interval. Value of 0 indicates auto refresh is not enabled.
screenSizePerspectiveApply perspective scaling to screen-size symbols.
showLabelsLabels will display if this property is set to true and the layer also has a labelingInfo property associated with it. This property can get stored in the web scene config and in the item/data.
showLegendBoolean value indicating whether to display the layer in the legend. Default value is true.
timeAnimationIndicates whether to enable time animation if the layer supports it. Default value is true.
titleA user-friendly string title for the layer that can be used in a table of contents.
urlThe URL to the layer. If the layer is not from a web service but rather a feature collection, then the url property is omitted.
visibilityBoolean property determining whether the layer is initially visible in the web scene.
visibilityTimeExtentRepresents time extent that will control when a layer should be visible based on webscene’s current time. Visibility time extent only affects the layer visibility and will not filter the data.

layerDefinition properties

PropertyDetails
capabilitiesA comma separated list of supported capabilities, e.g. Query,Editing.
definitionExpressionSQL-based definition expression string that narrows the data to be displayed in the layer.
drawingInfo.labelingInfo[]An array of labelingInfo objects.
drawingInfo.rendererThe renderer object contains the drawing information for the operationalLayer.
drawingInfo.transparencyNumber value ranging between 0 (no transparency) to 100 (completely transparent).
elevationInfoElevation info defines how features and other scene elements are aligned to ground or other layers.
featureReductionAn object that specifies how features are reduced or aggregated, with the goal of decluttering the view or presenting the user with an aggregate visualization.
fieldConfigurations[]An array of fieldConfiguration objects that define configuration for fields within a layer, including how to format date, time and number fields. Support for fieldConfigurations is currently limited to feature service-backed feature layers, oriented imagery layers, catalog footprint layers and tables. Support for additional layer types is planned for future releases.
floorInfoContains floor-awareness information for the layer.
maxScaleRepresents the maximum scale (most zoomed in) at which the layer is visible in the view. If the web scene is zoomed in beyond this scale, the layer will not be visible. A value of 0 means the layer does not have a maximum scale. If set, the maxScale value should always be smaller than the minScale value, and greater than or equal to the service specification.
minScaleRepresents the minimum scale (most zoomed out) at which the layer is visible in the view. If the web scene is zoomed out beyond this scale, the layer will not be visible. A value of 0 means the layer does not have a minimum scale. If set, the minScale value should always be larger than the maxScale value, and lesser than or equal to the service specification.
timeInfoAn object that defines properties to enable time on a layer or table.

featureLayer Example

Live sample web scene showing ArcGISFeatureLayer as an operationalLayer

{
"id": "Recreation_4720",
"layerType": "ArcGISFeatureLayer",
"url": "http://sampleserver6.arcgisonline.com/arcgis/rest/services/Recreation/MapServer/0",
"visibility": true,
"opacity": 1,
"title": "Map Service Layer",
"popupInfo": {
"title": "Facilities: {description}",
"fieldInfos": [],
"showAttachments": true,
"mediaInfos": []
}
}