Find point clusters

A point cluster analysis resulting in a new layer with areas (clusters) of invasive beetles in Canada.

What is a cluster analysis?

A cluster analysis is the process of finding clusters of point features within surrounding noise at a specified distance. To execute the analysis, use the and the FindPointClusters operation.

find point clusters

Real-world examples of this analysis include the following:

  • Where are there clusters of traffic incidents?
  • Where are there clusters of insect infestations?
  • Where are there clusters of trees?

How to perform a point cluster analysis

  1. Review the parameters for the FindPointClusters operation.
  2. Send a request to get the spatial analysis service URL.
  3. Execute a job request with the following URL and parameters:
    • URL: https://<YOUR_ANALYSIS_SERVICE>/arcgis/rest/services/tasks/GPServer/FindPointClusters/submitJob
    • Parameters:
      • analysisLayer: Your dataset as a hosted feature layer or feature collection.
      • minFeaturesCluster: Define how many points constitute a cluster.
      • outputName: A string representing the name of the hosted feature layer to return with the results.
  4. Check the status.
  5. Get the output layer results.

To see examples using ArcGIS API for Python, ArcGIS REST JS, and the ArcGIS REST API, go to Examples below.

URL request

1
http://<YOUR_ANALYSIS_SERVICE>/arcgis/rest/services/tasks/GPServer/FindPointClusters/submitJob?<parameters>

Required parameters

NameDescriptionExamples
fThe format of the data returned.f=json f=pjson
token

An (API key or OAuth 2.0) with the required Spatial Analysis > Feature analysis privilege.

token=<ACCESS_TOKEN>
analysisLayerThe point data.{url:"https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/Traffic_Crashes/FeatureServer/0"}
minFeaturesClusterDefine the minimum number of features to be considered a cluster.5

Key parameters

NameDescriptionExamples
searchDistanceA double value to use as the maximum distance to search for neighboring features.200
searchDistanceUnitMust be provided if searchDistance is specified.Miles, Feet, Meters, Kilometers
outputNameA string representing the name of the to return with the results. NOTE: If you do not include this parameter, the results are returned as a feature collection (JSON).{"serviceProperties": {"name": "<SERVICE_NAME>"}}
contextA bounding box or output spatial reference for the analysis."extent":{"xmin:", "ymin:", "xmax:", "ymax:"}

Example

Find clusters of traffic crashes

This example uses the FindPointClusters operation to find where there are areas (clusters) of traffic crashes. The analysisLayer value is the Traffic crashes hosted feature layer. The minFeaturesCluster is defined as 500. The results show four distinct colors that represent the four distinct clusters found in the analysis.

Point cluster analysis showing clusters of traffic crashes in San Francisco.

APIs

ArcGIS API for PythonArcGIS API for PythonArcGIS REST JS
Expand
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
analysisLayer = "https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/Traffic_Crashes/FeatureServer/0"

results = find_point_clusters(
    analysis_layer=analysisLayer,
    min_features_cluster=500,
    #Ouputs results as a hosted feature service.
    output_name="Find point clusters results",
)

result_features = results.layers[0].query()

print(
    f"The find point clusters layer has {len(result_features.features)} new records"
)

Service requests

Request
HTTPHTTPcURL
1
2
3
4
5
POST arcgis.com/sharing/rest/portals/self HTTP/1.1
Content-Type: application/x-www-form-urlencoded

&f=json
&token=<ACCESS_TOKEN>
Response (JSON)
1
2
3
4
5
6
7
8
9
10
11
{
  "helperServices": {
    // Other parameters
    "analysis": {
      "url": "https://<YOUR_ANALYSIS_SERVICE>/arcgis/rest/services/tasks/GPServer"
    },
    "geoenrichment": {
      "url": "https://geoenrich.arcgis.com/arcgis/rest/services/World/GeoenrichmentServer"
    }
  }
}

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.

You can no longer sign into this site. Go to your ArcGIS portal or the ArcGIS Location Platform dashboard to perform management tasks.

Your ArcGIS portal

Create, manage, and access API keys and OAuth 2.0 developer credentials, hosted layers, and data services.

Your ArcGIS Location Platform dashboard

Manage billing, monitor service usage, and access additional resources.

Learn more about these changes in the What's new in Esri Developers June 2024 blog post.

Close