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

http://elevation.arcgis.com/arcgis/rest/services/Tools/Elevation/GPServer/SummarizeElevation/submitJob

Description

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

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. In North America (Canada, United States, and Mexico), the task uses 1 arc-second (approximately 30 meter) resolution data from the USGS National Elevation Dataset (NED). In the continental United States, the task is also available based on the 1/3 arc-second (approximately 10 meter) resolution USGS National Elevation Dataset (NED). In Australia, the task is available based on the 1 arc-second (approximately 30 meter) resolution SRTM DEM-S dataset from Geoscience Australia. 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), the task is available based on the 1 arc-second (approximately 30 meter) resolution SRTM data between 60 degrees north and 56 degrees south.

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

Usage

  • 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.

  • Using this task consumes credits. The rate of use is 1 credit per 1000 input features.

    For more information, see the Service Credits Overview.

Request Parameters

ParameterDescription

InputFeatures

(Required)

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

  • Type: Feature Set

  • Syntax:

    {
    "geometryType":"geometryType",
    "spatialReference":<spatialReference>,
    "fields":<fields>,
    "features":<features>,
    }

FeatureIDField

The unique ID field to use for the input features.

  • Type: String

DEMResolution

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

The resolution keyword is 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 | 30m | 90m

IncludeSlopeAspect

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

Response

When you submit a request, the task 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 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:

http://elevation.arcgis.com/arcgis/rest/services/Tools/Elevation/GPServer/SummarizeElevation/jobs/<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:

http://elevation.arcgis.com/arcgis/rest/services/Tools/Elevation/GPServer/SummarizeElevation/jobs/<jobId>/results/OutputSummary?token=<your token>&f=json

ParameterDescription

OutputSummary

(Derived)

The output features that contain the elevation summary information.

  • Type: Feature set