Summarize Elevation

Summarize Elevation task

The Summarize Elevation task calculates summary statistics for features you provide based on ArcGIS Online Elevation data. It accepts point, line, or polygon input and returns statistics for the elevation, slope, and aspect of the features.

Request URL


This task summarizes the elevation, slope, and aspect information for the input features.

Depending upon the DEM resolution selected, different data sources will be used by the task.

  • By default, this task currently works worldwide between 60 degrees north and 56 degrees south based on the 3 arc-second (approximately 90 meter) resolution SRTM dataset.
  • For 30m, the task will use 1 arc-second resolution data in North America (Canada, United States, and Mexico) from the USGS National Elevation Dataset (NED), SRTM DEM-S dataset from Geoscience Australia in Australia and SRTM data between 60 degrees north and 56 degrees south in the remaining parts of the world (Africa, South America, most of Europe and continental Asia, the East Indies, New Zealand, and islands of the western Pacific).
  • For 24m, the task will use 0.8 arc-second (approximately 24 meter) data from the global dataset WorldDEM4Ortho from Airbus Defence and Space GmbH, excluding the counties of Azerbaijan, DR Congo and Ukraine.
  • For 10m, the task will use 1/3 arc-second resolution data in the continental United States from USGS National Elevation Dataset (NED) and approximately 10 meter data covering Norway, Finland, Denmark, Austria, Spain and Japan from various authoritative sources.

Please refer to the locator map to see the areas covered and to learn more about the data sources currently available.


  • If the DEMResolution parameter is empty or not supplied, the resolution of 90 meters will be used.

  • The maximum number of input features is 1000. If additional input features are provided, the task will return an error and will not execute.

  • The task uses a single resolution elevation source for each input feature. The entire feature must fit into a single resolution, or the task will pick the highest resolution that can cover the entire feature.

  • The returned features are the same shape type as the input features. For example, if the input features are points, the returned features are also points.

  • The results are appended to the returned feature attribute table as fields. The MinElevation, MeanElevation, and MaxElevation fields summarize elevation. The MinSlope, MeanSlope, and MaxSlope fields summarize slope. The MeanAspect field summarizes aspect.

  • Oceans and other major water bodies are ignored in the calculations and do not affect the summary values.

Request Parameters




Input features to summarize the elevation for. The features can be point, line, or area.

  • Type: Feature Set

  • Syntax:



The unique ID field to use for the input features.

  • Type: String


The approximate spatial resolution (cell size) of the source elevation data used for the calculation.

The resolution values are an approximation of the spatial resolution of the digital elevation model. While many elevation sources are distributed in units of arc seconds, the keyword is an approximation of those resolutions in meters for easier understanding.

  • Type: String

  • Values: FINEST | 10m | 24m | 30m | 90m


Determines if slope and aspect for the input feature(s) will be included in the output. The slope and aspect values in the output are in degrees.

  • Type: Boolean

  • Values: true | false

  • Default: False


When you submit a request, the task assigns a unique job ID for the transaction.


"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 for Elevation services. 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:<jobId>

Accessing results

When the status of the job request is esriJobSucceeded, you can access the results of the analysis by making a request of the following form:<jobId>/results/OutputSummary?token=<your token>&f=json




The output features that contain the elevation summary information.

  • Type: Feature set