Job requests | ArcGIS REST APIs

The Spatial analysis service contains a number of tasks that you can access and use in your applications. These tasks are arranged below into categories; the categories match those that appear in the Analysis pane in Map Viewer. The categories are simply logical groupings and do not affect how you access or use the tasks in any way.

Tasks that summarize data

Tool name	Description
AggregatePoints	The `AggregatePoints` task works with a layer of point features and a layer of polygon features or bins. It first identifies which points fall within each polygon's area. After identifying this point-in-polygon spatial relationship, statistics for all points in the polygon are calculated and assigned to the area. The most basic statistic is the number of points within the polygon (count), but you can get other statistics as well.
JoinFeatures	The `JoinFeatures` task works with two layers and joins the attributes from one feature to another based on spatial and attribute relationships.
SummarizeCenterAndDispersion	The `SummarizeCenterAndDispersion` task finds central features and directional distributions.
SummarizeWithin	The `SummarizeWithin` task finds the point, line, or polygon features (or portions of these features) that are within the boundaries of polygons in another layer.
SummarizeNearby	The `SummarizeNearby` task finds features that are within a specified distance of features in the input layer. Distance can be measured as a straight-line distance or by a specified travel mode. Statistics are then calculated for the nearby features.

Tasks that find locations

Tool name	Description
ChooseBestFacilities	The `ChooseBestFacilities` task finds the set of facilities that will best serve demand from surrounding areas. Facilities might be public institutions that offer a service, such as fire stations, schools, or libraries, or they might be commercial ones such as drug stores or distribution centers for a parcel delivery service. Demand represents the need for a service that the facilities can meet. Demand is associated with point locations, with each location representing a given amount of demand.
CreateViewshed	The `CreateViewshed` task identifies visible areas based on the observer locations you provide. The results are areas where the observers can see the observed objects (and the observed objects can see the observers).
CreateWatersheds	The `CreateWatersheds` task determines the watershed, or upstream contributing area, for each point in your analysis layer. For example, suppose you have point features representing locations of waterborne contamination, and you want to find the likely sources of the contamination. Since the source of the contamination must be somewhere within the watershed upstream of the point, you would use this tool to define the watersheds containing the sources of the contaminant.
DeriveNewLocations	The `DeriveNewLocations` task creates new features from the input layers that meet a query you specify. A query is made up of one or more expressions. There are two types of expressions: attribute and spatial. An example of an attribute expression is that a parcel must be vacant, which is an attribute of the Parcels layer (`where STATUS = 'VACANT'`). An example of a spatial expression is that the parcel must also be within a certain distance of a river (`Parcels within a distance of 0.75 Miles from Rivers`).
FindCentroids	The `FindCentroids` task finds and generates points from the representative center (centroid) of each input multipoint, line, or area feature. Finding the centroid of a feature is common for many analytical workflows in which the resulting points can then be used in other analytic workflows.
FindExistingLocations	The `FindExistingLocations` task selects features in the input layer that meet a specified query. A query is composed of one or more expressions. There are two types of expressions: attribute and spatial. An example of an attribute expression is a parcel must be vacant, which is an attribute of the Parcels layer (`where STATUS = 'VACANT'`). An example of a spatial expression is the parcel must also be within a certain distance of a river (`Parcels within a distance of 0.75 Miles from Rivers`).
FindSimilarLocations	The `FindSimilarLocations` task measures the similarity of candidate locations to one or more reference locations.
TraceDownstream	The `TraceDownstream` task determines the trace, or flow path, in a downstream direction from the points in your analysis layer.

Tasks that enrich data

Tool name	Description
EnrichLayer	The `EnrichLayer` task enriches your data by getting facts about the people, places, and businesses that surround your data locations.

Tasks that analyze patterns

Tool name	Description
CalculateCompositeIndex	The `CalculateCompositeIndex` task combines multiple numeric variables to create a single index.
CalculateDensity	The `CalculateDensity` task creates a density map from point or line features by spreading known quantities of some phenomenon (represented as attributes of the points or lines) across the map. The result is a layer of areas classified from least dense to most dense.
EightyTwentyAnalysis	The `EightyTwentyAnalysis` task performs Pareto analysis and creates point clusters, lines, or polygons based on the number of associated incidents.
FindHotSpots	The `FindHotSpots` 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.
FindOutliers	The `FindOutliers` 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 and low values and statistically significant high or low spatial outliers within those clusters.
FindPointClusters	The `FindPointClusters` task finds clusters of point features within surrounding noise based on their spatial distribution.
InterpolatePoints	The `InterpolatePoints` task allows you to predict values at new locations based on measurements from a collection of points. The task takes point data with values at each point and returns areas classified by predicted values.

Tasks that use proximity

Tool name	Description
ConnectOriginsToDestinations	The `ConnectOriginsToDestinations` task measures the travel time or distance between pairs of points.
CreateBuffers	The `CreateBuffers` task creates polygons that cover a given distance from a point, line, or polygon feature. Buffers are typically used to create areas that can be further analyzed using a task such as `OverlayLayers`.
CreateDriveTimeAreas	The `CreateDriveTimeAreas` task creates areas that can be reached within a given drive time or drive distance.
CreateThresholdAreas	The `CreateThresholdAreas` task creates rings or drive-time areas based on the value for a threshold variable such as population, income, or any demographic variable.
FindNearest	The `FindNearest` task measures the straight-line distance, driving distance, or driving time from features in the analysis layer to features in the near layer, and copies the nearest features in the near layer to a new layer. Connecting lines showing the measured path are returned as well. Find Nearest also reports the measurement and relative rank of each nearest feature. There are options to limit the number of nearest features to find or the search range in which to find them.
PlanRoutes	The `PlanRoutes` task determines how to efficiently divide tasks among a mobile workforce.

Tasks that manage data

Tool name	Description
ExtractData	The `ExtractData` task is used to extract data from one or more layers within a given extent. The extracted data format can be CSV, KML, a file geodatabase, or a shapefile. File geodatabases and shapefiles are added to a `.zip` file that can be downloaded.
DissolveBoundaries	The `DissolveBoundaries` task finds polygons that overlap or share a common boundary and merges them together to form a single polygon.
FieldCalculator	Note The `FieldCalculator` task is no longer supported in ArcGIS Online as of March 2021. Learn more about how to calculate field values The `FieldCalculator` task updates values in one or more fields based on an expression you provide. The fields to update can be existing fields or a new fields that you create as part of the task request. The expression can use values from other fields. The result of this task is a new layer with all the fields from the input layer as well as any new fields you create. Field values are updated according to the expressions you provide.
GenerateTessellations	The `GenerateTessellations` task creates tessellations, or bins, determined by a specified extent, shape, and size.
MergeLayers	The `MergeLayers` task copies features from two layers into a new layer. The layers to be merged must all contain the same feature types (points, lines, or polygons). You can control how the fields from the input layers are joined and copied.
OverlayLayers	The `OverlayLayers` task combines two or more layers into a single layer. You can think of overlay as peering through a stack of maps and creating a single map containing all the information from the stack. Before the advent of GIS, cartographers would manually copy maps onto clear acetate sheets, overlay the sheets on a light table, and hand draw a new map from the overlaid data. Overlay is more than a merging of line work; all the attributes of the features in the overlay are carried through to the final product. Overlay is used to answer one of the most basic questions of geography: What is on top of what?