define([ "dojo", "dojo/_base/array", "dojo/_base/declare", "dojo/_base/lang", "dojo/on", "esri/layers/GraphicsLayer", "esri/symbols/SimpleMarkerSymbol", "esri/SpatialReference", "esri/geometry/Point", "esri/graphic", "esri/symbols/Font", "esri/symbols/TextSymbol" ], function (dojo, array, declare, lang, on, GraphicsLayer, SimpleMarkerSymbol, SpatialReference, Point, Graphic, Font, TextSymbol) { var ClusterLayer = declare("extras.ClusterLayer", GraphicsLayer, { constructor: function (options) { // options: // data: Object[] // Array of objects. Required. Object are required to have properties named x, y and attributes. The x and y coordinates have to be numbers that represent a points coordinates. // distance: Number? // Optional. The max number of pixels between points to group points in the same cluster. Default value is 50. // labelColor: String? // Optional. Hex string or array of rgba values used as the color for cluster labels. Default value is #fff (white). // labelOffset: String? // Optional. Number of pixels to shift a cluster label vertically. Defaults to -5 to align labels with circle symbols. Does not work in IE. // resolution: Number // Required. Width of a pixel in map coordinates. Example of how to calculate: // map.extent.getWidth() / map.width // showSingles: Boolean? // Optional. Whether or graphics should be displayed when a cluster graphic is clicked. Default is true. // singleSymbol: MarkerSymbol? // Marker Symbol (picture or simple). Optional. Symbol to use for graphics that represent single points. Default is a small gray SimpleMarkerSymbol. // singleTemplate: PopupTemplate? // PopupTemplate. Optional. Popup template used to format attributes for graphics that represent single points. Default shows all attributes as "attribute = value" (not recommended). // maxSingles: Number? // Optional. Threshold for whether or not to show graphics for points in a cluster. Default is 1000. // webmap: Boolean? // Optional. Whether or not the map is from an ArcGIS.com webmap. Default is false. // spatialReference: SpatialReference? // Optional. Spatial reference for all graphics in the layer. This has to match the spatial reference of the map. Default is 102100. Omit this if the map uses basemaps in web mercator. this._clusterTolerance = options.distance || 20; this._clusterData = options.data || []; this._clusters = []; this._clusterLabelColor = options.labelColor || "#000"; // labelOffset can be zero so handle it differently this._clusterLabelXOffset = (options.hasOwnProperty("labelXOffset")) ? options.labelXOffset : -5; this._clusterLabelYOffset = (options.hasOwnProperty("labelYOffset")) ? options.labelYOffset : -5; this._labelClusters = (options.hasOwnProperty("labelClusters")) ? options.labelClusters : true; // graphics that represent a single point this._singles = []; // populated when a graphic is clicked this._showSingles = options.hasOwnProperty("showSingles") ? options.showSingles : true; // symbol for single graphics //var sms = esri.symbol.SimpleMarkerSymbol; this._singlesCallback = options.singlesCallback; this._popupCallback = options.popupCallback; this._maxSingles = options.maxSingles || 10000; this._webmap = options.hasOwnProperty("webmap") ? options.webmap : false; this._sr = options.spatialReference || new SpatialReference({ "wkid": 102100 }); this._zoomEnd = null; // layer config for dealing with click events etc this.layerConfig = (options.hasOwnProperty("layerConfig")) ? options.layerConfig : null; }, _setMap: function (map, surface) { // calculate and set the initial resolution this._clusterResolution = map.extent.getWidth() / map.width; // probably a bad default... this._clusterGraphics(); // connect to onZoomEnd so data is re-clustered when zoom level changes this._zoomEnd = dojo.connect(map, "onZoomEnd", this, function () { this.refreshClusters(); }); // GraphicsLayer will add its own listener here var div = this.inherited(arguments); return div; }, _unsetMap: function () { this.inherited(arguments); dojo.disconnect(this._zoomEnd); }, dropClusters: function () { this._clusterData = []; this._clusters = []; this._singles = []; // populated when a graphic is clicked }, refreshClusters: function () { this.clear(); // update resolution and recluster this._clusterResolution = this._map.extent.getWidth() / this._map.width; this._clusterGraphics(); }, add: function (p) { // Summary: The argument is a data point to be added to an existing cluster. If the data point falls within an existing cluster, it is added to that cluster and the cluster's label is updated. If the new point does not fall within an existing cluster, a new cluster is created. // // if passed a graphic, use the GraphicsLayer's add method if (p.declaredClass) { this.inherited(arguments); return; } // add the new data to _clusterData so that it's included in clusters // when the map level changes this._clusterData.push(p); var clustered = false; // look for an existing cluster for the new point for (var i = 0; i < this._clusters.length; i++) { var c = this._clusters[i]; if (this._clusterTest(p, c)) { // add the point to an existing cluster this._clusterAddPoint(p, c); // update the cluster's geometry this._updateClusterGeometry(c); // update the label this._updateLabel(c); clustered = true; break; } } if (!clustered) { this._clusterCreate(p); p.attributes.clusterCount = 1; this._showCluster(p); } }, clear: function () { // Summary: Remove all clusters and data points. this.inherited(arguments); this._clusters.length = 0; }, clearSingles: function (singles) { // Summary: Remove graphics that represent individual data points. var s = singles || this._singles; dojo.forEach(s, function (g) { this.remove(g); }, this); this._singles.length = 0; }, onClick: function (e) { if (this.layerConfig.popupMode == 'click') { this.highlightSingles(e); } }, onMouseOver: function (e) { if (this.layerConfig.popupMode == 'hover') { var target = e.target || e.srcElement, self = this; hoverTimer = setTimeout(function () { self.highlightSingles(e); }, 1000); } }, onMouseOut: function (e) { if (this.layerConfig.popupMode == 'hover') { if (hoverTimer) clearTimeout(hoverTimer); } }, highlightSingles: function (e) { // remove any previously showing single features this.clearSingles(this._singles); // find single graphics that make up the cluster that was clicked // would be nice to use filter but performance tanks with large arrays in IE var singles = []; for (var i = 0, il = this._clusterData.length; i < il; i++) { if (e.graphic.attributes.clusterId == this._clusterData[i].attributes.clusterId) { singles.push(this._clusterData[i]); } } if (singles.length > this._maxSingles) { alert("Sorry, that cluster contains more than " + this._maxSingles + " points. Zoom in for more detail."); return; } else { // stop the click from bubbling to the map e.stopPropagation(); this._addSingles(singles, e); } }, /* internal methods */ _clusterGraphics: function () { var skipClustering = false; if (map.getZoom() === map.getMaxZoom()) { skipClustering = true; } // first time through, loop through the points for (var j = 0, jl = this._clusterData.length; j < jl; j++) { // see if the current feature should be added to a cluster var point = this._clusterData[j]; var clustered = false; if (!skipClustering) { var numClusters = this._clusters.length; for (var i = 0; i < this._clusters.length; i++) { var c = this._clusters[i]; if (this._clusterTest(point, c)) { this._clusterAddPoint(point, c); clustered = true; break; } } } if (!clustered) { this._clusterCreate(point); } } this._showAllClusters(); }, _clusterTest: function(p, cluster) { var distance = ( Math.sqrt( Math.pow((cluster.x - p.x), 2) + Math.pow((cluster.y - p.y), 2) ) / this._clusterResolution ); return (distance <= this._clusterTolerance); }, _clusterTest: function (p, cluster) { var distance = ( Math.sqrt( Math.pow((cluster.x - p.x), 2) + Math.pow((cluster.y - p.y), 2) ) / this._clusterResolution ); return (distance <= this._clusterTolerance); }, // points passed to clusterAddPoint should be included // in an existing cluster // also give the point an attribute called clusterId // that corresponds to its cluster _clusterAddPoint: function (p, cluster) { // average in the new point to the cluster geometry var count, x, y; count = cluster.attributes.clusterCount; x = (p.x + (cluster.x * count)) / (count + 1); y = (p.y + (cluster.y * count)) / (count + 1); cluster.x = x; cluster.y = y; /* // build an extent that includes all points in a cluster // extents are for debug/testing only...not used by the layer if ( p.x < cluster.attributes.extent[0] ) { cluster.attributes.extent[0] = p.x; } else if ( p.x > cluster.attributes.extent[2] ) { cluster.attributes.extent[2] = p.x; } if ( p.y < cluster.attributes.extent[1] ) { cluster.attributes.extent[1] = p.y; } else if ( p.y > cluster.attributes.extent[3] ) { cluster.attributes.extent[3] = p.y; } */ // increment the count cluster.attributes.clusterCount++; //add the point to the cluster list cluster.attributes.points.push(p); // attributes might not exist if (!p.hasOwnProperty("attributes")) { p.attributes = {}; } // give the graphic a cluster id p.attributes.clusterId = cluster.attributes.clusterId; }, // point passed to clusterCreate isn't within the // clustering distance specified for the layer so // create a new cluster for it _clusterCreate: function (p) { var clusterId = this._clusters.length + 1; // console.log("cluster create, id is: ", clusterId); // p.attributes might be undefined if (!p.attributes) { p.attributes = {}; } p.attributes.clusterId = clusterId; // create the cluster var cluster = { "x": p.x, "y": p.y, "attributes": { "clusterCount": 1, "clusterId": clusterId, "extent": [p.x, p.y, p.x, p.y], "points": [] } }; cluster.attributes.points.push(p); this._clusters.push(cluster); }, _showAllClusters: function () { for (var i = 0, il = this._clusters.length; i < il; i++) { var c = this._clusters[i]; this._showCluster(c); } }, _showCluster: function (c) { var point = new Point(c.x, c.y, this._sr); this.add( new Graphic( point, null, c.attributes ) ); // code below is used to not label clusters with a single point if (c.attributes.clusterCount == 1) { return; } if (this._labelClusters) { //16 px //var labelFont = new esri.symbol.Font("1em", null, null, esri.symbol.Font.WEIGHT_BOLD, "Arial"); var symbolSize = null; console.log('clusterCount: ', c.attributes.clusterCount); var clusterCount = c.attributes.clusterCount; if (clusterCount > 99) { console.log('clusterCount less than 10: ', clusterCount); symbolSize = "10px"; } else if (clusterCount > 10) { symbolSize = "11px" } else { console.log('clusterCount greater than 10: ', c.attributes.clusterCount); symbolSize = "12px" } var labelFont = new Font(symbolSize, null, null, Font.WEIGHT_BOLD, "Arial"); // show number of points in the cluster var label = new TextSymbol(c.attributes.clusterCount, labelFont) .setColor(new dojo.Color(this._clusterLabelColor)) .setOffset(this._clusterLabelXOffset, this._clusterLabelYOffset); this.add( new Graphic( point, label, c.attributes ) ); } }, _addSingles: function (singles, e) { var g = this._singlesCallback(singles, e); this._singles.push(g); this._popupCallback(this._singles, e.graphic.geometry); }, _updateClusterGeometry: function (c) { // find the cluster graphic var cg = dojo.filter(this.graphics, function (g) { return !g.symbol && g.attributes.clusterId == c.attributes.clusterId; }); if (cg.length == 1) { cg[0].geometry.update(c.x, c.y); } else { console.log("didn't find exactly one CLUSTER GEOMETRY to update: ", cg); } }, _updateLabel: function (c) { // find the existing label var label = dojo.filter(this.graphics, function (g) { return g.symbol && g.symbol.declaredClass == "esri.symbol.TextSymbol" && g.attributes.clusterId == c.attributes.clusterId; }); if (label.length == 1) { // console.log("update label...found: ", label); this.remove(label[0]); var newLabel = new esri.symbol.TextSymbol(c.attributes.clusterCount) .setColor(new dojo.Color(this._clusterLabelColor)) .setOffset(this._clusterLabelXOffset, this._clusterLabelYOffset); this.add( new esri.Graphic( new esri.geometry.Point(c.x, c.y, this._sr), newLabel, c.attributes ) ); // console.log("updated the label"); } else { //console.log("didn't find exactly one LABEL: ", label); } }, // debug only...never called by the layer _clusterMeta: function () { // print total number of features console.log("Total: ", this._clusterData.length); // add up counts and print it var count = 0; dojo.forEach(this._clusters, function (c) { count += c.attributes.clusterCount; }); console.log("In clusters: ", count); } }); return ClusterLayer; });