Hide Table of Contents
View Geoprocessing - Viewshed sample in sandbox
Geoprocessing - Viewshed


This sample demonstrates using the geoprocessor to calculate a viewshed. Click any point on the map to see all areas that are visible within 5 miles of that point. It may take a few seconds for the model to run and send back the results.

The viewshed calculation is accomplished through an ArcGIS Server geoprocessing service. The service provides access to a model (task) on the server that includes the viewshed tool. The constructor to the Geoprocessor requires the URL of the task (http://sampleserver1.arcgisonline.com/ArcGIS/rest/services/Elevation/ESRI_Elevation_World/GPServer/Viewshed).

When the map is clicked, an event listener calls the function computeViewShed, which adds a SimpleMarkerSymbol at the location of the click. The function also sets up the two parameters for the task. The first parameter is the clicked point and the second is a buffer distance that keeps the viewshed a reasonable size. In this example the viewshed is calculated up to 5 miles beyond the clicked point.

The first line below sets up the parameters in the correct format for the Geoprocessor task and the second line executes the task. The execute method is used here because the task is synchronous, meaning that the user waits for the results to appear before doing anything else. For large jobs, you can call submitJob to run the task asynchronously, allowing you to get the results later.

var params = { "Input_Observation_Point": featureSet, "Viewshed_Distance": vsDistance };
gp.execute(params, drawViewshed);

The execute method above names a callback function, drawViewshed that is called when the results are available. This function defines a symbol for the results and adds them to the map. The loop below is necessary in case the results are returned as a multi-part feature. This is very likely to happen with a viewshed layer because rough terrain can leave separate patches of visible area.

for (var f=0, fl=features.length; f < fl; f++) { 
  var feature = features[f]; 


<!DOCTYPE html>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
    <meta name="viewport" content="initial-scale=1, maximum-scale=1, user-scalable=no">
    <title>GP Viewshed Task</title>

    <link rel="stylesheet" href="https://js.arcgis.com/3.20/esri/css/esri.css">
      html, body, #mapDiv {
        height: 100%;
        margin: 0;
        padding: 0;
        width: 100%;
      #info {
        bottom: 20px;
        color: #444;
        height: auto;
        font-family: arial;
        left: 20px;
        margin: 5px;
        padding: 10px;
        position: absolute;
        text-align: left;
        width: 200px;
        z-index: 40;

    <script src="https://js.arcgis.com/3.20compact/"></script>
        function(dom, array, Color, Map, Graphic, graphicsUtils, Geoprocessor, FeatureSet, LinearUnit, SimpleMarkerSymbol, SimpleLineSymbol, SimpleFillSymbol){

          var map, gp;

          /*Initialize map, GP*/

            map = new Map("mapDiv", {
              basemap: "streets",
              center: [-122.436, 37.73],
              zoom: 12

            gp = new Geoprocessor("https://sampleserver6.arcgisonline.com/ArcGIS/rest/services/Elevation/ESRI_Elevation_World/GPServer/Viewshed");
              wkid: 102100
            map.on("click", computeViewShed);

          function computeViewShed(evt) {
            var pointSymbol = new SimpleMarkerSymbol();
            pointSymbol.setOutline(new SimpleLineSymbol(SimpleLineSymbol.STYLE_SOLID, new Color([255, 0, 0]), 1));
            pointSymbol.setColor(new Color([0, 255, 0, 0.25]));

            var graphic = new Graphic(evt.mapPoint, pointSymbol);

            var features = [];
            var featureSet = new FeatureSet();
            featureSet.features = features;
            var vsDistance = new LinearUnit();
            vsDistance.distance = 5;
            vsDistance.units = "esriMiles";
            var params = {
              "Input_Observation_Point": featureSet,
              "Viewshed_Distance": vsDistance
            gp.execute(params, drawViewshed);

          function drawViewshed(results, messages) {
            var polySymbol = new SimpleFillSymbol();
            polySymbol.setOutline(new SimpleLineSymbol(SimpleLineSymbol.STYLE_SOLID, new Color([0, 0, 0, 0.5]), 1));
            polySymbol.setColor(new Color([255, 127, 0, 0.7]));
            var features = results[0].value.features;
            for (var f = 0, fl = features.length; f < fl; f++) {
              var feature = features[f];
            map.setExtent(graphicsUtils.graphicsExtent(map.graphics.graphics), true);

    <div id="mapDiv"></div>
    <div id="info" class="esriSimpleSlider">
      Click on map to execute ViewShed GP Task.