Below you'll find information about accessing and using the analysis tools. This information applies to all tools.
The administrator of your organization needs to grant you certain privileges for you to perform analysis. To use any of the analysis tools, you need the following privileges:
- Create, update, and delete content
- Publish hosted feature layers
- Spatial Analysis
If you do not have these privileges, you will not see the Perform Analysis option as described below.
Certain tools need additional privileges such as Network Analysis and GeoEnrichment. See Perform analysis for more information about these tools.
Access the tools
To access and use analysis tools in Map Viewer, follow these steps:
- Open a web map containing the feature layer or layers you want to analyze in Map Viewer.
- Click the Contents button in the Details pane.
- Do one of the following:
- Click the Analysis button on the map menu bar.
- Hover over the layer you want to analyze and click the Analysis button .
Both actions open the Perform Analysis pane.
Explore the Perform Analysis pane
The Perform Analysis pane is illustrated below. This pane contains a number of categories and each category contains tools. To view the tools within a category, click the expand or collapse button on the left side of the category.
Return to the Details pane.
Expand the category to view the tools it contains.
View help about the category.
View help for the tool.
Work with a tool pane
To open an analysis tool pane, click the tool icon. This opens the tool's pane as illustrated below with the Aggregate Points tool.
Close the tool pane without running the analysis and return to the Perform Analysis pane.
Get help about a parameter.
The result of running the analysis is saved to Content using this name.
You can specify a folder in Content in which to save the result.
Show how many credits will be used if you run the analysis.
If checked, only the data visible in the current map will be analyzed.
When running an analysis, the credit estimator in ArcGIS Online will calculate the expected number of credits that will be used and compare it to the number of credits you have available. If you or your organization do not have enough credits, an error message will be displayed. For more on credit allocation and consumption, see Understand credits.
Each tool has a different set of parameters. You can always view help for a parameter by clicking the help icon next to the parameter as illustrated above. All tools have a Result layer name parameter where the results of running the analysis are written. You can change this name or use the default value.
Use current map extent
It is recommended that you always check Use current map extent and that you zoom in to the area you want analyzed. Doing so limits the number of features the tool needs to examine when performing analysis as well as limiting the number of credits used by the tool. If you uncheck Use current map extent, all features in the analysis layer will potentially be analyzed, and credits used by the tool will be based on the number of features in the layer.
Rerun analysis tools
Analysis tools can be rerun by clicking the Rerun Analysis button for a result layer. Rerun Analysis will open the tool that was used to create the layer and repopulate all of the parameters. The tool can be rerun with the same parameters, or the parameters, including inputs, can be updated before the tool is run.
When rerunning analysis tools, the state of the current map will be honored, including filters, extent, input layers, and output folder. If you want to ensure that an analysis is rerun at a specific extent, create a bookmark. If you share your results with the intention of allowing other users to rerun your analysis, you may need to share your input layers as well. If you open a tool using Rerun Analysis and the input layers are not available, a warning will be displayed but the tool can still be run with different inputs.
Analysis tools can only be rerun for result layers created after June 26, 2017.
The Result layer name from the previous iteration will be used when you open an analysis tool using Rerun Analysis. You must create a unique name before rerunning a tool.
Layers and data you can analyze
Some tools only work on certain kinds of feature types; for example, Aggregate Points requires an input layer containing point features.
In addition to choosing a layer from your map, you can choose a layer from a gallery of Living Atlas analysis layers or from a custom gallery by your organization. To access a gallery from an analysis tool, click the drop-down arrow next to the input parameters and click Choose Living Atlas Analysis Layer or Choose Analysis Layer. You will only see one of these options.
You can perform analysis on the following types of layers and data:
The feature service must be publically accessible; that is, the URL to the service must be a public URL, not one only accessible behind a firewall. Layers based on nonaccessible feature services will not have the Perform Analysis menu choice.
- Map service
As with feature services, the map service must be publically accessible.
- Hosted feature layers
- Hosted WFS layers
- Hosted tile layers
The layer must have the query capability enabled.
- Comma-separated values (CSV) file (.csv)
- KML layers
- GPS exchange format file (.gpx)
- Shapefile (.zip)
- GeoRSS web feed
- Map notes
- Route layers
- WFS layers