Work with bin-enabled feature layers

Bin-enabled feature layers are aggregated visualizations of point feature datasets. When the dataset includes so many features that it is difficult to interpret meaning from drawing each feature individually at smaller scales, you can aggregate them into equally sized polygonal bins. Each bin can be symbolized to represent the number of features contained within (the feature count) or another summary statistic. Drawing the point feature information as bins at smaller scales makes the data easier to understand and fast to draw. As you zoom in, the individual points are drawn in place of the bins at a defined threshold, revealing the full complexity of the data at larger scales. The changes in bin size as you zoom in or out are referred to as levels of detail (LODs).

To aggregate point features into bins, the source feature class must first be enabled for binning. Use the Enable Feature Binning tool to do so. Only point and multipoint feature classes stored in an enterprise geodatabase or database can be enabled for binning. You specify the coordinate system of the bins when you enable binning. Because you are comparing equally sized containers, an equal-area coordinate system is recommended.

Once binning is enabled, you can turn the appearance of bins on and off, adjust the way the aggregation into bins is calculated, and modify the way the bins and the underlying point features are symbolized. In addition to the summary statistics that are defined when binning is enabled, you can specify other summary statistics to aggregate in bins. Once the bins are displayed appropriately, you can optionally share the bin-enabled feature layer as a map image layer.

To learn more about when it is appropriate to use feature binning or consider other types of feature aggregation, see Visualize features through aggregation.

Determine whether a layer is enabled for binning

The Aggregation contextual tab becomes available when a bin-enabled feature layer is selected in the Contents pane. The Binning tab contains functionality for managing, editing, and updating binned features. You can also view the layer's properties to determine whether feature binning is enabled on the Source tab.

Tip:

The bins are not a feature layer but a capability on a feature layer. This is why the ArcGIS Pro ribbon shows independent contextual tabs for feature layers and binning when a bin-enabled feature layer is selected.

Manage the display of bins

The way bin-enabled feature layers display on a map or scene depends on the map scale (or distance), the bin size, and the coordinate system. You can change how bins display using the tools on the Binning tab. In a local or global scene, only point features can be displayed in the 3D Layers category.

Turn bins on and off

When feature classes are enabled for binning, the aggregation type is set to Binning and the bins are drawn by default. You can turn binning on and off from the Binning tab to view differences between bins and individual features. The symbology and display settings of the bins are maintained even when bin drawing is turned off.

To turn the display of bins on and off for a bin-enabled feature class, follow these steps:

  1. Select a bin-enabled feature layer in the Contents pane.
  2. Under Aggregation, on the Binning tab, in the Layer group, click the Binning button Enable Binning.

When bins are drawn on the map, you can click them to open a pop-up that displays calculated summary statistics for that bin at the given level of detail. Bins cannot be selected, but you can turn them off to select point features.

Note:

Bin pop-ups are not viewable for feature layers from SAP HANA or spatiotemporal databases.

Adjust the bin size and scale threshold

There is a direct relationship between the size of the bins and the scale of the map. For example, when zooming in and out on the map, the map draws the same number of bins in each extent by dynamically changing the LOD. You can set a binning threshold to specify when bins are drawn. This prevents bins from being drawn at large scales where there is not enough data on the map.

The size of the bin (LOD) can be increased or decreased. You can also lock the bin size so that the area of the bin does not change at different scales and extents. Under Aggregation, on the Binning tab, you can view the bin scale, size, appearance, and symbology settings.

  • In the Binning Threshold group, click the Scale drop-down list and choose a preset scale or the current scale, or provide a custom scale. The map only draws point features if you are zoomed in farther than the binning threshold scale. If your data is stored in a spatiotemporal database and consumed via a feature service, you can set the binning threshold using the number of features instead of specifying a scale.
  • In the Size group, click the Increase Bin Size or Decrease Bin Size arrows to increase or decrease the bin size. Hover over the arrows to view the current bin LOD. A smaller LOD means the bin size is larger.
  • Click the Lock bin size control Lock to lock the bin size at its current LOD. This keeps the bin polygon size consistent when zooming in and out on the map, as polygons appear larger or smaller on the screen but represent the same area in each map extent. This is similar to setting a reference scale, but bin symbol markers and outlines will continue to change at different scales. If your layer is in a local or global scene, it is recommended that you lock the bin size so that the LOD is fixed at all distances in the 3D view.
Note:

The size of the bin depends on the bin type. For more information, see Symbolize binned feature layers.

Change the bin type

If the bin-enabled feature layer is stored in a spatiotemporal big data store, you can change the type of bin after binning is enabled. This option is otherwise unavailable for bin-enabled feature layers.

  1. Under Aggregation, on the Binning tab, in the Appearance group, click the Bin type drop-down menu.
  2. Choose a new bin type.

    GeoHash

    Geohash bin type

    The bins are a tessellation of rectangles. Geohashes bisect the Earth into a series of rectangles with unique alphanumeric string IDs. The string IDs are precise and predictable, which makes them systematically easier to interpret. However, for this reason, this bin type must use the WGS 1984 geographic coordinate system.

    Hexagon (flat-topped)

    Flat hexagon bin type

    Also called flat geohex or flat hexbinning, the bins are a tessellation of hexagons. The flat edge of the hexagon is oriented on top. Hexagons are efficient for binning because the distance from the center of the hexagon to each edge is equal.

    Hexagon (pointy-topped)

    Pointy hexagon bin type

    Also called pointy geohex or pointy hexbinning, the bins are a tessellation of hexagons. The point of the hexagon is oriented on top. Hexagons are efficient for binning because the distance from the center of the hexagon to each edge is equal.

    Square

    Square hexagon bin type

    The tiles are a tessellation of squares, also known as geosquare or squarebinning. Binning into squares is the least mathematically complex option, so this bin type is best for basic pattern analysis.

Change the bins' coordinate system

Bins are drawn using the same coordinate system as the map. Bin-enabled feature layers can have bins generated into different coordinate systems. This is an important concept of feature aggregation, because drawing bins in certain coordinate systems can change the statistics of each bin. For example, in a Web Mercator projection, the bin's shape and size stay constant, but because the map is distorted near the poles, bins over Greenland and Antarctica represent a smaller area than bins on the same projection near the equator. Because of this, it is recommended that you change the projected coordinate system of the bins to a projection that preserves area instead.

When feature binning is first enabled on your data, one or two coordinate systems can be defined to visualize the aggregated output feature layer. Other coordinate systems cannot be added unless binning is disabled and reenabled. Custom coordinate systems are not supported.

You can change the projected coordinate system of the bins on the Binning tab. To change the coordinate system, follow these steps:

  1. Under Aggregation, on the Binning tab, in the Appearance group, open the Coordinate System drop-down menu.
  2. Choose a new coordinate system.

    The map redraws the bins using the selected projection.

If the feature class is the first layer added to the project, the map's projection changes to an available equal-area projection from the list of defined coordinate systems for the bins. If an equal-area projection is not available, the first projection in the list is used.

Set a definition query

You can limit the display of a bin-enabled feature layer to show only certain features. If you filter features with definition queries, the bins display only these features. This is similar to setting a definition query on a standard feature layer.

Note:

Display filters applied to the point features do not affect the drawing of bins.

  1. In the Contents pane, right-click a bin-enabled feature layer and click Properties.
  2. On the Layer Properties dialog box, on the Definition Query tab, click New definition query to add and edit a new query.
  3. Click Apply, and click OK to apply the definition query to the layer.
Note:

If a definition query is applied to the bin-enabled feature layer, the bins' symbology does not reflect changes set by the query. In the Symbology pane Symbology, under the Bins tab, on the Primary symbology tab Primary symbology, click the More drop-down menu and click Refresh values to recompute the symbology based on the query.

Filter by time or range

You can filter bins by setting time properties or adding a range slider on the feature layer on the Layer Properties dialog box. Time and range settings are preserved when you switch the display between bins and individual features.

Note:

If static bins are generated on the feature class and you set a definition query or use a time or range slider on the current map view, the layer does not use the cached statistics. Instead, it generates summary statistics dynamically using the definition query, current time, or current range.

Manage the binning cache

If a static binning cache was generated when feature binning was first enabled, when you edit, create, or update point features in ArcGIS Pro, you must update the binning cache to reflect these changes. The option to generate a binning cache is checked by default when binning is enabled, as this improves drawing performance for very large datasets.

Run the Manage Feature Bin Cache tool to reflect updates from the database in your binning cache. If your data is frequently updated, it is recommended that you run this tool periodically. If the feature class was enabled with the option to generate a static cache unchecked, a static cache is created automatically when this tool is run.

Depending on the data or the layer's full extent, not all LODs are cached at once. When you zoom past the last cached LOD, the layer dynamically generates the bins, which reflect the latest updates made in ArcGIS Pro. The Max cached level property on a bin-enabled layer's Layer Properties dialog box lists the maximum level of detail of the static cache.

Note:

If your data is managed outside of ArcGIS Pro and a binning cache is not created, you need to disable and reenable binning for updates to be reflected.

Share bin-enabled feature layers

You can share a bin-enabled feature layer as a map image layer to ArcGIS Enterprise and consume the web layer in ArcGIS Pro. Prior to publishing, the source database of the bin-enabled feature layer must be registered to a server federated with the portal. In the Sharing pane, under Data and Layer Type, click Map Image under Reference registered data. Optionally, check the Feature check box to include a feature layer.

Beginning with ArcGIS Enterprise 10.9, when you publish a bin-enabled feature layer to a feature service, you can consume the service in ArcGIS Pro and change certain layer properties such as the bin's symbology or bin size.

Note:

There are some situations in which sharing a map with a bin-enabled feature layer is not supported. For more information, see 20055: Feature binning functionality will be dropped.

Related topics