The Find Hot Spots task analyzes point data (such as crime incidents, traffic accidents, or trees) or field values associated with points or area features (such as the number of people in each census tract or the total sales for retail stores). It finds statistically significant spatial clusters of high values (hot spots) and low values (cold spots). For point data when no field is specified, hot spots are locations with lots of points and cold spots are locations with very few points.
The result map layer shows hot spots in red and cold spots in blue. The darkest red features indicate the strongest clustering of high values or point densities; you can be 99 percent confident that the clustering associated with these features could not be the result of random chance. Similarly, the darkest blue features are associated with the strongest spatial clustering of low values or the lowest point densities. Features that are beige are not part of a statistically significant cluster; the spatial pattern associated with these features could very likely be the result of random processes and random chance.
Request URL
http://<analysis url>/FindHotSpots/submitJob
Limits
The processInfo parameter and pop-ups are not updated by overwriting the output feature layer if the existing output feature layer already has strings for processInfo and custom pop-ups.
Request Parameters
Parameter | Description |
---|---|
analysisLayer (Required) | The point or polygon feature layer for which hot spots will be calculated. Syntax: As described in detail in the Feature input topic, this parameter can be one of the following:
Examples:
|
analysisField (Required if the analysisLayer contains polygons) | The numeric field that will be analyzed. The field you select might represent:
If an analysisField is not supplied, hot spot results are based on point densities only. Syntax: "analysisField": "Average_Score" |
divideByField | The numeric field in the analysisLayer that will be used to normalize your data. For example, if your points represent crimes, dividing by total population would result in an analysis of crimes per capita rather than raw crime counts. You can use esriPopulation to geoenrich each area feature with the most recent population values, which will then be used as the attribute to divide by. This option will use credits. Syntax: "divideByField": "esriPopulation" |
boundingPolygonLayer | When the analysis layer is points and no analysisField is specified, you can provide polygons features that define where incidents could have occurred. For example, if you are analyzing boating accidents in a harbor, the outline of the harbor might provide a good boundary for where accidents could occur. When no bounding areas are provided, only locations with at least one point will be included in the analysis. Syntax: As described in detail in the Feature input topic, this parameter can be one of the following:
|
aggregationPolygonLayer | When the analysisLayer contains points and no analysisField is specified, you can provide polygon features into which the points will be aggregated and analyzed, such as administrative units. The number of points that fall within each polygon are counted, and the point count in each polygon is analyzed. Syntax: As described in detail in the Feature input topic, this parameter can be one of the following:
|
shapeType | The shape of the polygon mesh the input features will be aggregated into.
Example: "shapeType": "Hexagon" |
cellSize | The size of the grid cells used to aggregate your features. When aggregating into a hexagon grid, this distance is used as the height to construct the hexagon polygons. Example: "cellSize": 500 |
cellSizeUnits | The units of the cellSize value. You must provide a value if cellSize has been set. Values: Miles | Feet | Kilometers | Meters Example: "cellSizeUnit": "Meters" |
distanceBand | The spatial extent of the analysis neighborhood. This value determines which features are analyzed together in order to assess local clustering. |
distanceBandUnits | The units of the distanceBand value. You must provide a value if distanceBand has been set. Values: Miles | Feet | Kilometers | Meters Example: "distanceBandUnit": "Meters" |
outputName | If provided, the task will create a feature service of the results. You define the name of the service. If an outputName value is not provided, the task will return a feature collection. Syntax: Syntax: |
context | The Context parameter contains the following additional settings that affect task operation:
Syntax:
|
f | The response format. The default response format is html. Values: html | json |
Response
When you submit a request, the service assigns a unique job ID for the transaction.
Syntax:{
"jobId": "<unique job identifier>",
"jobStatus": "<job status>"
}
After the initial
request is submitted you can use the
jobId to periodically check the status of the job and messages as described in the topic Checking job status.
Once the job has successfully completed, use
the jobId to retrieve the results. To track the status, you can make a request of the following form:http://<analysis url>/FindHotSpots/jobs/<jobId>
Analysis results
When the status of the job request is esriJobSucceded, you can access the results of the analysis by making a request of the following form:
http://<analysis url>/FindHotSpots/jobs/<jobId>/results/hotSpotsResultLayer?token=<your token>&f=json
Parameter | Description |
---|---|
hotSpotsResultLayer | The result of Find Hot Spots is a feature layer that provides information about statistically significant hot and cold features. If the input analysis layer (analysisLayer) contains points and an analysisField is specified, the result will be points. For all other scenarios (polygons or points when no analysisField is specified) the output is polygons. The result layer has the following attributes:
Example:
The result has properties for parameter name, data type, and value. The contents of value depends on the outputName parameter provided in the initial request.
See Feature Output for more information about how the result layer or collection is accessed. |
processInfo | processInfo contains strings that describe the workflow used by Find Hot Spots when calculating the result. These strings are used for reporting by the Find Hot Spots tool in Map Viewer Classic. You can create your own custom reports for your application using these strings. There are four parts in the returned JSON:
Example:
|
The science behind Hot Spot analysis
The Find Hot Spots task calculates the Getis-Ord Gi* statistic (pronounced G-i-star) for each feature in a feature layer. The service works by looking at each feature within the context of neighboring features. To be a statistically significant hot spot, a feature will have a high value or incident count and will be surrounded by other features with high values or incident counts. The local sum for a feature and its neighbors is compared proportionally to the sum of all features; when the local sum is very different from the expected local sum, and when that difference is too large to be the result of random chance, a statistically significant z-score results.
Potential applications
Applications can be found in crime analysis, epidemiology, voting pattern analysis, economic geography, retail analysis, traffic incident analysis, and demographics. Some examples include the following:
- Where is the disease outbreak concentrated?
- Where are kitchen fires a larger than expected proportion of all residential fires?
- Where should the evacuation sites be located?
- Where do peak intensities occur?
- In which locations should we allocate more of our resources?
Hot spot analysis considerations
There are three things to consider when undertaking any hot spot analysis:
- What is the Analysis Field?
The hot spot analysis tool assesses whether high or low values (the number of crimes, accident severity, or dollars spent on sporting goods, for example) cluster spatially. The field containing those values is your Analysis Field. When the Analysis Layer represents incident points and you are only interested in locating high and low incident densities, select NO ANALYSIS FIELD. When you select NO ANALYSIS FIELD, the Find Hot Spots service will overlay the incidents points with a fishnet and count the number of incidents within each fishnet square. The incident count values will then be used as the Analysis Field.
- What is the question?
This may seem obvious, but how you construct the Analysis Field determines the types of questions you can answer. Are you most interested in determining where you have lots of incidents or where high/low values for a particular attribute cluster spatially? If so, run the Find Hot Spot service on the raw values or raw incident counts. This type of analysis is particularly helpful for resource allocation types of problems. Alternatively (or in addition), you may be interested in locating areas with unexpectedly high values in relation to some other variable. If you are analyzing foreclosures, for example, you probably expect more foreclosures in locations with more homes (said another way, at some level, you expect the number of foreclosures to be a function of the number of houses). For each Analysis Layer area, divide the number of foreclosures by the number of homes, then run the Find Hot Spots service on this ratio. For this analysis, you are no longer asking Where are there lots of foreclosures?; instead, you are asking Where are there unexpectedly high numbers of foreclosures, given the number of homes? By creating a rate or ratio prior to analysis, you can control for certain expected relationships (for example, the number of crimes is a function of population; the number of foreclosures is a function of housing stock) and will then be identifying unexpected hot/cold spots.
- Does the analysis layer contain at least 30 features?
Results aren't reliable with less than 30 features.
Calculations
Additional resources
Mitchell, Andy. The ESRI Guide to GIS Analysis, Volume 2.ESRI Press, 2005.
Getis, A. and J.K. Ord. 1992. "The Analysis of Spatial Association by Use of Distance Statistics" in Geographical Analysis 24(3).
Ord, J.K. and A. Getis. 1995. "Local Spatial Autocorrelation Statistics: Distributional Issues and an Application" in Geographical Analysis 27(4).
The spatial statistics resource page has short videos, tutorials, web seminars, articles and a variety of other materials to help you get started with spatial statistics.
Scott, L. and N. Warmerdam. Extend Crime Analysis with ArcGIS Spatial Statistics Tools in ArcUser Online, April–June 2005.