{"id":922831,"date":"2020-07-09T13:00:29","date_gmt":"2020-07-09T20:00:29","guid":{"rendered":"https:\/\/www.esri.com\/arcgis-blog\/?post_type=blog&p=922831"},"modified":"2020-07-10T09:45:42","modified_gmt":"2020-07-10T16:45:42","slug":"labels-now-supported-in-point-clustering","status":"publish","type":"blog","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/js-api-arcgis\/mapping\/labels-now-supported-in-point-clustering","title":{"rendered":"Labeling support added to point clustering"},"author":6561,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"open","ping_status":"closed","template":"","format":"standard","meta":{"_acf_changed":false,"_searchwp_excluded":""},"categories":[22941],"tags":[26751,30111,24921,128002,667481],"industry":[],"product":[36831,36601],"class_list":["post-922831","blog","type-blog","status-publish","format-standard","hentry","category-mapping","tag-clustering","tag-data-visualization","tag-javascript","tag-labeling","tag-whats-new-june-2020","product-js-api-arcgis","product-developers"],"acf":{"short_description":"The ArcGIS API for JavaScript added support for labeling point clusters with the total count or other aggregate summary information.","flexible_content":[{"acf_fc_layout":"content","content":"

The ArcGIS API for JavaScript<\/a> (ArcGIS JS API) version 4.16 added support for labeling point clusters. This has been one of the most popular enhancement requests since clustering was released.<\/p>\n

Clustering<\/a> is a method of merging nearby and overlapping features into a single symbol to reduce cluttered features in the view. The size of the cluster icon indicates the number of features in each cluster relative to other clusters. Adding a label can provide more precise context to the features represented by the cluster.<\/p>\n

For example, check out this example of earthquakes that occurred along the Aleutian Islands in Alaska over the last 30 days.<\/p>\n"},{"acf_fc_layout":"image","image":{"ID":928581,"id":928581,"title":"Screen Shot 2020-07-09 at 12.30.54 PM","filename":"Screen-Shot-2020-07-09-at-12.30.54-PM.png","filesize":27611,"url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-09-at-12.30.54-PM.png","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/js-api-arcgis\/mapping\/labels-now-supported-in-point-clustering\/screen-shot-2020-07-09-at-12-30-54-pm","alt":"Earthquakes clustered.","author":"6561","description":"","caption":"Earthquakes that occurred along the Aleutian Islands in June 2020. The points are clustered so you can easily see where more earthquakes occur.","name":"screen-shot-2020-07-09-at-12-30-54-pm","status":"inherit","uploaded_to":922831,"date":"2020-07-09 19:32:04","modified":"2020-12-30 23:02:38","menu_order":0,"mime_type":"image\/png","type":"image","subtype":"png","icon":"https:\/\/www.esri.com\/arcgis-blog\/wp-includes\/images\/media\/default.png","width":1328,"height":426,"sizes":{"thumbnail":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-09-at-12.30.54-PM-213x200.png","thumbnail-width":213,"thumbnail-height":200,"medium":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-09-at-12.30.54-PM.png","medium-width":464,"medium-height":149,"medium_large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-09-at-12.30.54-PM.png","medium_large-width":768,"medium_large-height":246,"large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-09-at-12.30.54-PM.png","large-width":1328,"large-height":426,"1536x1536":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-09-at-12.30.54-PM.png","1536x1536-width":1328,"1536x1536-height":426,"2048x2048":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-09-at-12.30.54-PM.png","2048x2048-width":1328,"2048x2048-height":426,"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-09-at-12.30.54-PM-826x265.png","card_image-width":826,"card_image-height":265,"wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-09-at-12.30.54-PM.png","wide_image-width":1328,"wide_image-height":426}},"image_position":"center","orientation":"horizontal","hyperlink":"https:\/\/developers.arcgis.com\/javascript\/latest\/sample-code\/featurereduction-cluster\/index.html"},{"acf_fc_layout":"content","content":"

Clustering helps you immediately see where more points are densely located than others. When clustering is not enabled, it’s difficult to discern areas with a lot of overlapping points. <\/p>\n

Notice how the cluster of 1,000+ earthquakes in the previous image is not discernible when the same layer is not clustered.<\/p>\n"},{"acf_fc_layout":"image","image":{"ID":928591,"id":928591,"title":"Screen Shot 2020-07-09 at 12.31.38 PM","filename":"Screen-Shot-2020-07-09-at-12.31.38-PM.png","filesize":33220,"url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-09-at-12.31.38-PM.png","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/js-api-arcgis\/mapping\/labels-now-supported-in-point-clustering\/screen-shot-2020-07-09-at-12-31-38-pm","alt":"Earthquakes along the Aleutian Islands from the last 30 days. Not clustered.","author":"6561","description":"","caption":"Earthquakes that occurred along the Aleutian Islands in June 2020. In this visualization, each earthquake is represented with one point. When points aren't clustered, overlapping points make it difficult to see areas with a high number of earthquakes.","name":"screen-shot-2020-07-09-at-12-31-38-pm","status":"inherit","uploaded_to":922831,"date":"2020-07-09 19:32:07","modified":"2020-12-30 23:02:16","menu_order":0,"mime_type":"image\/png","type":"image","subtype":"png","icon":"https:\/\/www.esri.com\/arcgis-blog\/wp-includes\/images\/media\/default.png","width":1258,"height":426,"sizes":{"thumbnail":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-09-at-12.31.38-PM-213x200.png","thumbnail-width":213,"thumbnail-height":200,"medium":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-09-at-12.31.38-PM.png","medium-width":464,"medium-height":157,"medium_large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-09-at-12.31.38-PM.png","medium_large-width":768,"medium_large-height":260,"large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-09-at-12.31.38-PM.png","large-width":1258,"large-height":426,"1536x1536":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-09-at-12.31.38-PM.png","1536x1536-width":1258,"1536x1536-height":426,"2048x2048":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-09-at-12.31.38-PM.png","2048x2048-width":1258,"2048x2048-height":426,"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-09-at-12.31.38-PM-826x280.png","card_image-width":826,"card_image-height":280,"wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-09-at-12.31.38-PM.png","wide_image-width":1258,"wide_image-height":426}},"image_position":"center","orientation":"horizontal","hyperlink":"https:\/\/developers.arcgis.com\/javascript\/latest\/sample-code\/featurereduction-cluster\/index.html"},{"acf_fc_layout":"content","content":"

In fact the area where those 1,000+ earthquakes occurred is so small, most users will incorrectly assume there are fewer earthquakes in that location.<\/p>\n

Show cluster counts<\/h2>\n

Labeling clusters is very similar to labeling individual features in a layer. Just like the FeatureLayer.labelingInfo<\/a> property of the FeatureLayer, FeatureReductionCluster<\/a> now has a labelingInfo<\/a> property that allows you to configure cluster labels.<\/p>\n

That means you have full control over the label’s font, symbol, placement, and text. The following code will display cluster counts in the center of the cluster.<\/p>\n

const<\/span> clusterConfig = {\r\n  type: \"cluster\"<\/span>,\r\n  clusterRadius: \"100px\"<\/span>,\r\n  \/\/ increase the min cluster size<\/span>\r\n  \/\/ to fit cluster labels<\/span>\r\n  clusterMinSize: \"24px\"<\/span>,\r\n  clusterMaxSize: \"60px\"<\/span>,\r\n  \/\/ {cluster_count} is an aggregate field containing<\/span>\r\n  \/\/ the number of features comprised by the cluster<\/span>\r\n  labelingInfo: [\r\n    {\r\n      \/\/ allows for slight label overlap<\/span>\r\n      deconflictionStrategy: \"none\"<\/span>,\r\n      labelExpressionInfo: {\r\n        \/\/ Arcade expression formatting the cluster count<\/span>\r\n        expression: \"Text($feature.cluster_count, '#,###')\"<\/span>\r\n      },\r\n      symbol: {\r\n        type: \"text\"<\/span>,\r\n        color: \"#004a5d\"<\/span>,\r\n        font: {\r\n          weight: \"bold\"<\/span>,\r\n          family: \"Noto Sans\"<\/span>,\r\n          size: \"12px\"<\/span>\r\n        }\r\n      },\r\n      labelPlacement: \"center-center\"<\/span>\r\n    }\r\n  ]\r\n};\r\n\r\nlayer.featureReduction = clusterConfig;\r\n<\/code><\/pre>\n
Here are a few properties introduced at version 4.16 of the ArcGIS JS API worth mentioning.<\/p>\n
deconflictionStrategy<\/a> \u2013 Labeling in the ArcGIS JS API has always supported label deconfliction. Otherwise, most labels would be illegible. However, when it comes to displaying labels for clusters, it’s generally preferable to turn off label deconfliction so all cluster counts display. Now you have the option to disable label deconfliction. This looks better than removing labels when there’s only a little overlap.<\/p>\n"},{"acf_fc_layout":"image","image":{"ID":926501,"id":926501,"title":"Screen Shot 2020-07-08 at 5.23.28 PM","filename":"Screen-Shot-2020-07-08-at-5.23.28-PM.png","filesize":20417,"url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-08-at-5.23.28-PM.png","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/js-api-arcgis\/mapping\/labels-now-supported-in-point-clustering\/screen-shot-2020-07-08-at-5-23-28-pm","alt":"side by side view of clusters with conflicting and deconflicting labels","author":"6561","description":"","caption":"The image on the left shows how label deconfliction removes labels that overlap, or \"conflict\". This is typically desirable for layer labeling, but looks strange in cluster labels.","name":"screen-shot-2020-07-08-at-5-23-28-pm","status":"inherit","uploaded_to":922831,"date":"2020-07-09 00:23:38","modified":"2020-07-09 00:25:04","menu_order":0,"mime_type":"image\/png","type":"image","subtype":"png","icon":"https:\/\/www.esri.com\/arcgis-blog\/wp-includes\/images\/media\/default.png","width":755,"height":277,"sizes":{"thumbnail":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-08-at-5.23.28-PM-213x200.png","thumbnail-width":213,"thumbnail-height":200,"medium":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-08-at-5.23.28-PM.png","medium-width":464,"medium-height":170,"medium_large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-08-at-5.23.28-PM.png","medium_large-width":755,"medium_large-height":277,"large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-08-at-5.23.28-PM.png","large-width":755,"large-height":277,"1536x1536":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-08-at-5.23.28-PM.png","1536x1536-width":755,"1536x1536-height":277,"2048x2048":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-08-at-5.23.28-PM.png","2048x2048-width":755,"2048x2048-height":277,"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-08-at-5.23.28-PM.png","card_image-width":755,"card_image-height":277,"wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-08-at-5.23.28-PM.png","wide_image-width":755,"wide_image-height":277}},"image_position":"center","orientation":"horizontal","hyperlink":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-08-at-5.23.28-PM.png"},{"acf_fc_layout":"content","content":"
Advanced Labels<\/h2>\n
Given there is no limitation to the labelingInfo spec for clusters compared to layer labeling, you have the flexibility to style labels however you want and present summary information related to the renderer beyond the cluster count. You can add as many label classes as you want to create a rich experience for the end user.<\/p>\n
Check out the following sample<\/a>, which adds six label classes to the FeatureReductionCluster labelingInfo. Note the various scale constraints, label placements, and symbol configurations for each.<\/p>\n
\nExpand to view the code for all six label classes<\/summary>\n
const<\/span> clusterConfig = {\r\n  type: \"cluster\"<\/span>,\r\n  \/\/ larger radii look better with multiple label classes<\/span>\r\n  \/\/ smaller radii looks better visually<\/span>\r\n  clusterRadius: \"120px\"<\/span>,\r\n  labelsVisible: true<\/span>,\r\n  labelingInfo: [\r\n    {\r\n      symbol: {\r\n        type: \"text\"<\/span>,\r\n        haloColor,\r\n        haloSize: \"1px\"<\/span>,\r\n        color,\r\n        font: {\r\n          family: \"Noto Sans\"<\/span>,\r\n          size: \"11px\"<\/span>\r\n        },\r\n        xoffset: 0<\/span>,\r\n        yoffset: \"-15px\"<\/span>\r\n      },\r\n      labelPlacement: \"center-center\"<\/span>,\r\n      labelExpressionInfo: {\r\n        expression: \"Text($feature.cluster_count, '#,### plants')\"<\/span>\r\n      },\r\n      where: `cluster_avg_capacity_mw > ${clusterLabelThreshold}<\/span>`<\/span>\r\n    },\r\n    {\r\n      symbol: {\r\n        type: \"text\"<\/span>,\r\n        haloColor,\r\n        haloSize: \"2px\"<\/span>,\r\n        color,\r\n        font: {\r\n          weight: \"bold\"<\/span>,\r\n          family: \"Noto Sans\"<\/span>,\r\n          size: \"18px\"<\/span>\r\n        },\r\n        xoffset: 0<\/span>,\r\n        yoffset: 0<\/span>\r\n      },\r\n      labelPlacement: \"center-center\"<\/span>,\r\n      labelExpressionInfo: {\r\n        expression: \"$feature.cluster_type_fuel1\"<\/span>\r\n      },\r\n      where: `cluster_avg_capacity_mw > ${clusterLabelThreshold}<\/span>`<\/span>\r\n    },\r\n    {\r\n      symbol: {\r\n        type: \"text\"<\/span>,\r\n        haloColor,\r\n        haloSize: \"1px\"<\/span>,\r\n        color,\r\n        font: {\r\n          weight: \"bold\"<\/span>,\r\n          family: \"Noto Sans\"<\/span>,\r\n          size: \"12px\"<\/span>\r\n        },\r\n        xoffset: 0<\/span>,\r\n        yoffset: \"15px\"<\/span>\r\n      },\r\n      deconflictionStrategy: \"none\"<\/span>,\r\n      labelPlacement: \"center-center\"<\/span>,\r\n      labelExpressionInfo: {\r\n        expression: `\r\n          var value = $feature.cluster_avg_capacity_mw;\r\n          var num = Count(Text(Round(value)));\r\n\r\n          Decode(num,\r\n            4, Text(value \/ Pow(10, 3), \"##.0k\"),\r\n            5, Text(value \/ Pow(10, 3), \"##k\"),\r\n            6, Text(value \/ Pow(10, 3), \"##k\"),\r\n            7, Text(value \/ Pow(10, 6), \"##.0m\"),\r\n            Text(value, \"#,###\")\r\n          );\r\n        `<\/span>\r\n      },\r\n      where: `cluster_avg_capacity_mw > ${clusterLabelThreshold}<\/span>`<\/span>\r\n    },\r\n    {\r\n      symbol: {\r\n        type: \"text\"<\/span>,\r\n        haloColor,\r\n        haloSize: \"1px\"<\/span>,\r\n        color,\r\n        font: {\r\n          family: \"Noto Sans\"<\/span>,\r\n          size: \"11px\"<\/span>\r\n        },\r\n        xoffset: 0<\/span>,\r\n        yoffset: \"-15px\"<\/span>\r\n      },\r\n      labelPlacement: \"above-right\"<\/span>,\r\n      labelExpressionInfo: {\r\n        expression: \"Text($feature.cluster_count, '#,### plants')\"<\/span>\r\n      },\r\n      where: `cluster_avg_capacity_mw <= ${clusterLabelThreshold}<\/span>`<\/span>\r\n    },\r\n    {\r\n      symbol: {\r\n        type: \"text\"<\/span>,\r\n        haloColor,\r\n        haloSize: \"2px\"<\/span>,\r\n        color,\r\n        font: {\r\n          weight: \"bold\"<\/span>,\r\n          family: \"Noto Sans\"<\/span>,\r\n          size: \"18px\"<\/span>\r\n        }\r\n      },\r\n      labelPlacement: \"above-right\"<\/span>,\r\n      labelExpressionInfo: {\r\n        expression: \"$feature.cluster_type_fuel1\"<\/span>\r\n      },\r\n      where: `cluster_avg_capacity_mw <= ${clusterLabelThreshold}<\/span>`<\/span>\r\n    },\r\n    {\r\n      symbol: {\r\n        type: \"text\"<\/span>,\r\n        haloColor,\r\n        haloSize: \"1px\"<\/span>,\r\n        color,\r\n        font: {\r\n          weight: \"bold\"<\/span>,\r\n          family: \"Noto Sans\"<\/span>,\r\n          size: \"12px\"<\/span>\r\n        },\r\n        xoffset: 0<\/span>,\r\n        yoffset: 0<\/span>\r\n      },\r\n      labelPlacement: \"center-center\"<\/span>,\r\n      labelExpressionInfo: {\r\n        expression: `\r\n          var value = $feature.cluster_avg_capacity_mw;\r\n          var num = Count(Text(Round(value)));\r\n\r\n          Decode(num,\r\n            4, Text(value \/ Pow(10, 3), \"##.0k\"),\r\n            5, Text(value \/ Pow(10, 3), \"##k\"),\r\n            6, Text(value \/ Pow(10, 3), \"##k\"),\r\n            7, Text(value \/ Pow(10, 6), \"##.0m\"),\r\n            Text(value, \"#,###\")\r\n          );\r\n        `<\/span>\r\n      },\r\n      where: `cluster_avg_capacity_mw <= ${clusterLabelThreshold}<\/span>`<\/span>\r\n    }\r\n  ]\r\n};\r\n<\/code><\/pre>\n<\/details>\n"},{"acf_fc_layout":"image","image":{"ID":925441,"id":925441,"title":"cluster-advanced-labels","filename":"cluster-advanced-labels.png","filesize":86660,"url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/cluster-advanced-labels.png","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/js-api-arcgis\/mapping\/labels-now-supported-in-point-clustering\/cluster-advanced-labels","alt":"Global power plants clustered with several labels summarizing the points within each cluster.","author":"6561","description":"","caption":"Global power plants clustered and labeled with summary information including the predominant fuel type, number of power plants, and average wattage produced by plants in the cluster.","name":"cluster-advanced-labels","status":"inherit","uploaded_to":922831,"date":"2020-07-08 20:40:37","modified":"2020-07-08 20:43:54","menu_order":0,"mime_type":"image\/png","type":"image","subtype":"png","icon":"https:\/\/www.esri.com\/arcgis-blog\/wp-includes\/images\/media\/default.png","width":800,"height":417,"sizes":{"thumbnail":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/cluster-advanced-labels-213x200.png","thumbnail-width":213,"thumbnail-height":200,"medium":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/cluster-advanced-labels.png","medium-width":464,"medium-height":242,"medium_large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/cluster-advanced-labels.png","medium_large-width":768,"medium_large-height":400,"large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/cluster-advanced-labels.png","large-width":800,"large-height":417,"1536x1536":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/cluster-advanced-labels.png","1536x1536-width":800,"1536x1536-height":417,"2048x2048":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/cluster-advanced-labels.png","2048x2048-width":800,"2048x2048-height":417,"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/cluster-advanced-labels.png","card_image-width":800,"card_image-height":417,"wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/cluster-advanced-labels.png","wide_image-width":800,"wide_image-height":417}},"image_position":"center","orientation":"horizontal","hyperlink":"https:\/\/developers.arcgis.com\/javascript\/latest\/sample-code\/featurereduction-cluster-filter-slider\/index.html"},{"acf_fc_layout":"content","content":"
Also, when you label clusters with summary information, you should also consider adding complementary labels on individual features that don’t belong to a cluster. The sample above demonstrates this as well.<\/p>\n
Suggested default labels<\/h2>\n
Since cluster count may not be the only label of importance to the user, we added the getLabelSchemes<\/a> method in the new esri\/smartMapping\/labels\/clusters<\/code><\/a> module to generate suggested primary and secondary label classes for use in clustering.<\/p>\n
All label classes are based on the fields used by the layer’s renderer. This can especially come in handy with complex renderers that refer to multiple fields and Arcade expressions<\/a>.<\/p>\n
Simply reference the layer and view in the method. Then you can apply any of the primary or secondary label schemes on the layer’s featureReduction<\/code> property.<\/p>\n
\/\/ Sets a suggested popupTemplate on the layer based on its renderer<\/span>\r\nclusterLabelCreator.getLabelSchemes({\r\n  layer: featureLayer,\r\n  view: view\r\n}).then(function<\/span>(labelSchemes<\/span>)<\/span>{\r\n  \/\/ labelSchemes has a `primaryScheme` and `secondarySchemes`<\/span>\r\n  const<\/span> featureReduction = featureLayer.featureReduction.clone();\r\n  const<\/span> { labelingInfo, clusterMinSize } = labelSchemes.primaryScheme;\r\n  featureReduction.labelingInfo = labelingInfo;\r\n  featureReduction.clusterMinSize = clusterMinSize;\r\n\r\n  featureLayer.featureReduction = featureReduction;\r\n}).catch(function<\/span>(error<\/span>)<\/span>{\r\n  console<\/span>.error(error);\r\n});\r\n<\/code><\/pre>\n
\/\/ clusterField can be either<\/span>\r\n\/\/ {cluster_count} or<\/span>\r\n\/\/ {cluster_avg_FIELDNAME}<\/span>\r\n\/\/ where FEILDNAME is the name of<\/span>\r\n\/\/ a number field used by the renderer<\/span>\r\n$feature[\"${clusterField}\"<\/span>];\r\nvar<\/span> value = $feature[\"${clusterField}\"<\/span>];\r\nvar<\/span> num = Count(Text(Round(value)));\r\nvar<\/span> label = When(\r\n  num < 4<\/span>, Text(value, \"#.#\"<\/span>),\r\n  num == 4<\/span>, Text(value \/ Pow(10<\/span>, 3<\/span>), \"#.0k\"<\/span>),\r\n  num <= 6<\/span>, Text(value \/ Pow(10<\/span>, 3<\/span>), \"#k\"<\/span>),\r\n  num == 7<\/span>, Text(value \/ Pow(10<\/span>, 6<\/span>), \"#.0m\"<\/span>),\r\n  num > 7<\/span>, Text(value \/ Pow(10<\/span>, 6<\/span>), \"#m\"<\/span>),\r\n  Text(value, \"#,###\"<\/span>)\r\n);\r\nreturn<\/span> label;\r\n<\/code><\/pre>\n
Experiment with alternate label schemes and configurations<\/h2>\n
While the primary labeling scheme usually involves placing the cluster count in the center of the cluster, you may be given a primary scheme that involves another attribute. For example, when generating label classes for any layer rendered with a size visual variable<\/a>, the default scheme will suggest labeling clusters with the average value of the field or expression used in the size variable. This should provide clarity to the end user since the size variable referenced in the renderer is reused as the cluster size variable. <\/p>\n
For example, given a UniqueValueRenderer<\/a> containing a size variable in the power plants layer, the primary scheme will show the average capacity of power plants.<\/p>\n"},{"acf_fc_layout":"image","image":{"ID":926321,"id":926321,"title":"Screen Shot 2020-07-08 at 4.12.21 PM","filename":"Screen-Shot-2020-07-08-at-4.12.21-PM.png","filesize":63764,"url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-08-at-4.12.21-PM.png","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/js-api-arcgis\/mapping\/labels-now-supported-in-point-clustering\/screen-shot-2020-07-08-at-4-12-21-pm","alt":"power plants clustered and labeled with the average capacity of power plants in the center of the cluster","author":"6561","description":"","caption":"The labels on these clusters may appear to be counts, but in reality they represent the average capacity of power plants in each cluster. This is the default because the size of the cluster represents average capacity, not feature count.","name":"screen-shot-2020-07-08-at-4-12-21-pm","status":"inherit","uploaded_to":922831,"date":"2020-07-08 23:59:35","modified":"2020-07-08 23:59:48","menu_order":0,"mime_type":"image\/png","type":"image","subtype":"png","icon":"https:\/\/www.esri.com\/arcgis-blog\/wp-includes\/images\/media\/default.png","width":896,"height":516,"sizes":{"thumbnail":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-08-at-4.12.21-PM-213x200.png","thumbnail-width":213,"thumbnail-height":200,"medium":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-08-at-4.12.21-PM.png","medium-width":453,"medium-height":261,"medium_large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-08-at-4.12.21-PM.png","medium_large-width":768,"medium_large-height":442,"large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-08-at-4.12.21-PM.png","large-width":896,"large-height":516,"1536x1536":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-08-at-4.12.21-PM.png","1536x1536-width":896,"1536x1536-height":516,"2048x2048":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-08-at-4.12.21-PM.png","2048x2048-width":896,"2048x2048-height":516,"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-08-at-4.12.21-PM-807x465.png","card_image-width":807,"card_image-height":465,"wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-08-at-4.12.21-PM.png","wide_image-width":896,"wide_image-height":516}},"image_position":"center","orientation":"horizontal","hyperlink":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-08-at-4.12.21-PM.png"},{"acf_fc_layout":"content","content":"
If the layer’s renderer did not include a size variable, then cluster size would indicate the count. Therefore, the suggested primary labelingInfo would display the count.<\/p>\n"},{"acf_fc_layout":"image","image":{"ID":926251,"id":926251,"title":"Screen Shot 2020-07-08 at 4.09.00 PM","filename":"Screen-Shot-2020-07-08-at-4.09.00-PM.png","filesize":54843,"url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-08-at-4.09.00-PM.png","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/js-api-arcgis\/mapping\/labels-now-supported-in-point-clustering\/screen-shot-2020-07-08-at-4-09-00-pm","alt":"power plants clustered and labeled with the number of power plants in the center of the cluster","author":"6561","description":"","caption":"When no size variable is used on the renderer, the cluster size will always indicate the number of features in the cluster. So labeling these clusters with the count makes more sense.","name":"screen-shot-2020-07-08-at-4-09-00-pm","status":"inherit","uploaded_to":922831,"date":"2020-07-08 23:53:41","modified":"2020-07-09 00:01:21","menu_order":0,"mime_type":"image\/png","type":"image","subtype":"png","icon":"https:\/\/www.esri.com\/arcgis-blog\/wp-includes\/images\/media\/default.png","width":1005,"height":571,"sizes":{"thumbnail":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-08-at-4.09.00-PM-213x200.png","thumbnail-width":213,"thumbnail-height":200,"medium":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-08-at-4.09.00-PM.png","medium-width":459,"medium-height":261,"medium_large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-08-at-4.09.00-PM.png","medium_large-width":768,"medium_large-height":436,"large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-08-at-4.09.00-PM.png","large-width":1005,"large-height":571,"1536x1536":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-08-at-4.09.00-PM.png","1536x1536-width":1005,"1536x1536-height":571,"2048x2048":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-08-at-4.09.00-PM.png","2048x2048-width":1005,"2048x2048-height":571,"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-08-at-4.09.00-PM-818x465.png","card_image-width":818,"card_image-height":465,"wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-08-at-4.09.00-PM.png","wide_image-width":1005,"wide_image-height":571}},"image_position":"center","orientation":"horizontal","hyperlink":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-08-at-4.09.00-PM.png"},{"acf_fc_layout":"content","content":"
Given the renderer is a UniqueValueRenderer, you could use the predominant fuel type provided in the secondary label schemes to label each cluster.<\/p>\n"},{"acf_fc_layout":"image","image":{"ID":926261,"id":926261,"title":"Screen Shot 2020-07-08 at 4.12.55 PM","filename":"Screen-Shot-2020-07-08-at-4.12.55-PM.png","filesize":67102,"url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-08-at-4.12.55-PM.png","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/js-api-arcgis\/mapping\/labels-now-supported-in-point-clustering\/screen-shot-2020-07-08-at-4-12-55-pm","alt":"clusters with labels showing the predominant fuel type of power plants in each cluster.","author":"6561","description":"","caption":"You can opt to label clusters with a secondary label scheme indicating the predominant type of features within the clusters. Since the power plants layer colors each plant based on the fuel type, the color of each cluster indicates the predominant type. ","name":"screen-shot-2020-07-08-at-4-12-55-pm","status":"inherit","uploaded_to":922831,"date":"2020-07-08 23:55:23","modified":"2020-07-08 23:58:01","menu_order":0,"mime_type":"image\/png","type":"image","subtype":"png","icon":"https:\/\/www.esri.com\/arcgis-blog\/wp-includes\/images\/media\/default.png","width":969,"height":503,"sizes":{"thumbnail":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-08-at-4.12.55-PM-213x200.png","thumbnail-width":213,"thumbnail-height":200,"medium":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-08-at-4.12.55-PM.png","medium-width":464,"medium-height":241,"medium_large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-08-at-4.12.55-PM.png","medium_large-width":768,"medium_large-height":399,"large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-08-at-4.12.55-PM.png","large-width":969,"large-height":503,"1536x1536":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-08-at-4.12.55-PM.png","1536x1536-width":969,"1536x1536-height":503,"2048x2048":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-08-at-4.12.55-PM.png","2048x2048-width":969,"2048x2048-height":503,"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-08-at-4.12.55-PM-826x429.png","card_image-width":826,"card_image-height":429,"wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-08-at-4.12.55-PM.png","wide_image-width":969,"wide_image-height":503}},"image_position":"center","orientation":"horizontal","hyperlink":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-08-at-4.12.55-PM.png"},{"acf_fc_layout":"content","content":"
Or you can use all available schemes to show summary information about each cluster. This requires some rearranging using the LabelClass<\/a> label placement and TextSymbol<\/a> offset properties. <\/p>\n"},{"acf_fc_layout":"image","image":{"ID":926301,"id":926301,"title":"Screen Shot 2020-07-08 at 4.18.53 PM","filename":"Screen-Shot-2020-07-08-at-4.18.53-PM.png","filesize":51936,"url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-08-at-4.18.53-PM.png","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/js-api-arcgis\/mapping\/labels-now-supported-in-point-clustering\/screen-shot-2020-07-08-at-4-18-53-pm","alt":"clusters labeled with multiple label schemes","author":"6561","description":"","caption":"You can add more than one label class to clusters to provide additional summary information about features within the cluster.","name":"screen-shot-2020-07-08-at-4-18-53-pm","status":"inherit","uploaded_to":922831,"date":"2020-07-08 23:58:16","modified":"2020-07-08 23:58:56","menu_order":0,"mime_type":"image\/png","type":"image","subtype":"png","icon":"https:\/\/www.esri.com\/arcgis-blog\/wp-includes\/images\/media\/default.png","width":894,"height":468,"sizes":{"thumbnail":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-08-at-4.18.53-PM-213x200.png","thumbnail-width":213,"thumbnail-height":200,"medium":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-08-at-4.18.53-PM.png","medium-width":464,"medium-height":243,"medium_large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-08-at-4.18.53-PM.png","medium_large-width":768,"medium_large-height":402,"large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-08-at-4.18.53-PM.png","large-width":894,"large-height":468,"1536x1536":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-08-at-4.18.53-PM.png","1536x1536-width":894,"1536x1536-height":468,"2048x2048":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-08-at-4.18.53-PM.png","2048x2048-width":894,"2048x2048-height":468,"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-08-at-4.18.53-PM-826x432.png","card_image-width":826,"card_image-height":432,"wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-08-at-4.18.53-PM.png","wide_image-width":894,"wide_image-height":468}},"image_position":"center","orientation":"horizontal","hyperlink":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-08-at-4.18.53-PM.png"},{"acf_fc_layout":"content","content":"
<\/a><\/p>\n
A final thought<\/h2>\n
In previous posts about clustering<\/a>, I stated the following, and it is worth repeating:<\/p>\n
Clustering options available via featureReduction do not perform complex statistical analyses. Therefore, the clustering visualizations described above should not be interpreted as precise, statistically significant \u201cclusters\u201d of data. Rather, they should merely be approached as a nice summary of the data, providing you with a preview to potentially identify spatial patterns that may or may not reveal significant storylines.<\/p><\/blockquote>\n
Also, be sure to check out the newly documented configuration best practices<\/a> in the FeatureReductionCluster class description and the updated clustering samples:<\/p>\n
Check out the Point clustering – generate suggested configuration<\/a> sample to see how this works in a live app.<\/p>\n"},{"acf_fc_layout":"image","image":{"ID":928481,"id":928481,"title":"Screen Shot 2020-07-09 at 12.14.22 PM","filename":"Screen-Shot-2020-07-09-at-12.14.22-PM.png","filesize":187113,"url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-09-at-12.14.22-PM.png","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/js-api-arcgis\/mapping\/labels-now-supported-in-point-clustering\/screen-shot-2020-07-09-at-12-14-22-pm","alt":"Places of worship in India clustered.","author":"6561","description":"","caption":"Places of worship in India. The color represents the predominant religion of places of worship in each cluster. The size and label of each cluster indicate the total number of points in the cluster. Note the formatting of larger clusters.","name":"screen-shot-2020-07-09-at-12-14-22-pm","status":"inherit","uploaded_to":922831,"date":"2020-07-09 19:14:28","modified":"2020-07-09 19:16:06","menu_order":0,"mime_type":"image\/png","type":"image","subtype":"png","icon":"https:\/\/www.esri.com\/arcgis-blog\/wp-includes\/images\/media\/default.png","width":2496,"height":1510,"sizes":{"thumbnail":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-09-at-12.14.22-PM-213x200.png","thumbnail-width":213,"thumbnail-height":200,"medium":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-09-at-12.14.22-PM.png","medium-width":431,"medium-height":261,"medium_large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-09-at-12.14.22-PM.png","medium_large-width":768,"medium_large-height":465,"large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-09-at-12.14.22-PM.png","large-width":1785,"large-height":1080,"1536x1536":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-09-at-12.14.22-PM-1536x929.png","1536x1536-width":1536,"1536x1536-height":929,"2048x2048":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-09-at-12.14.22-PM-2048x1239.png","2048x2048-width":2048,"2048x2048-height":1239,"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-09-at-12.14.22-PM-769x465.png","card_image-width":769,"card_image-height":465,"wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/07\/Screen-Shot-2020-07-09-at-12.14.22-PM-1785x1080.png","wide_image-width":1785,"wide_image-height":1080}},"image_position":"center","orientation":"horizontal","hyperlink":"https:\/\/developers.arcgis.com\/javascript\/latest\/sample-code\/featurereduction-cluster-filter\/index.html"},{"acf_fc_layout":"content","content":"
The suggested label classes generated for number fields will contain a TextSymbol with a color and halo that look good for most renderer configurations. Label expressions<\/a> will look something like the following to improve the formatting of larger clusters. <\/p>\n
While the labels help make this visualization easy to explore, it takes a lot of time to get the labels right. In fact, placing this much information in labels may not be necessary in most scenarios because of the issue I describe below<\/a>.<\/p>\n
clusterMinSize<\/a>\/clusterMaxSize<\/a>. Now you can configure the size of your smallest and largest clusters. All other cluster sizes interpolate linearly. The default size (12px) of the smallest cluster is a bit too small to house a readable label. Therefore, you may find yourself bumping this value up to something like 18-24px to get something that looks better with the label. Any time you change the clusterMaxSize<\/code> you should also consider adjusting the clusterRadius<\/a>.<\/p>\n