Elevation analysis service

The elevation analysis service performs analyses on the elevation in Terrain data from the ArcGIS Living Atlas of the World in order to derive surface information, such as calculating visible areas, returning profile features, and summarizing elevation values for the input feature data. The elevation data used by these analyses is available at different spatial extents and resolutions. See the data coverage section for more information.

Key features

  • Create viewsheds to identify visible areas based on input observer locations
  • Find elevation values along input lines and return a profile feature
  • Calculate summary statistics for elevation values in areas covered by the input features

Access the services

To access the spatial analysis service, you need the following:

Example

This example shows how to calculate viewshed using the viewshed request.

1. Send a job request to calculate viewshed.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
POST https://elevation.arcgis.com/arcgis/rest/services/Tools/Elevation/GPServer/Viewshed/submitJob HTTP/1.1
content-type: application/x-www-form-urlencoded

f=json
&token=<ACCESS_TOKEN>
&InputPoints={"url":"https://sampleserver6.arcgisonline.com/arcgis/rest/services/Military/FeatureServer/2"}
&MaximumDistance=15
&MaximumDistanceUnits=Kilometers
&DEMResolution=90m
&ObserverHeight=2
&ObserverHeightUnits=Meters
&SurfaceOffset=0
&SurfaceOffsetUnits=Meters
&GeneralizeViewshedPolygons=true
&context={
  "extent":{
    "xmin":-13346035.5147852,
    "ymin":4158841.0975389,
    "xmax":-13313204.4419169,
    "ymax":4174735.07010641,
    "spatialReference":{
    "wkid":102100,
    "latestWkid":3857
    }
  }
}

2. Check the job status using the provided jobID until the job has succeeded or failed. Learn more about submitting GP Jobs.

1
2
3
4
5
POST https://elevation.arcgis.com/arcgis/rest/services/Tools/Elevation/GPServer/Viewshed/jobs/<jobID> HTTP/1.1
content-type: application/x-www-form-urlencoded

f=json
&token=<ACCESS_TOKEN>

3. Once the job has succeeded, get the results.

1
2
3
4
5
6
POST https://elevation.arcgis.com/arcgis/rest/services/Tools/Elevation/GPServer/Viewshed/jobs/<jobID>/results/OutputViewshed HTTP/1.1
content-type: application/x-www-form-urlencoded

f=json
&token=<ACCESS_TOKEN>
&returnType="data"

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.

You can no longer sign into this site. Go to your ArcGIS portal or the ArcGIS Location Platform dashboard to perform management tasks.

Your ArcGIS portal

Create, manage, and access API keys and OAuth 2.0 developer credentials, hosted layers, and data services.

Your ArcGIS Location Platform dashboard

Manage billing, monitor service usage, and access additional resources.

Learn more about these changes in the What's new in Esri Developers June 2024 blog post.

Close