Skip To Content ArcGIS for Developers Sign In Dashboard

Detect Change Using Change Analysis Raster

Description

Detect Change Using Change Analysis Raster

The DetectChangeUsingChangeAnalysisRaster task generates a raster containing pixel change information using the output change analysis raster from the Analyze Changes Using CCDC tool.

License:
As of 10.5.1, you must license your ArcGIS Server as an ArcGIS Image Server to use this resource.

Request parameters

ParameterDetails
inputChangeAnalysisRaster

(Required)

The Portal Item ID, Image Service URL, cloud multidimensional raster dataset or shared multidimensional raster dataset generated from the AnalyzeChangesUsingCCDC tool.

Syntax: JSON object describes the input multidimensional raster. At least one type of input needs to be provided in the JSON object. If multiple inputs are given. The itemid takes the priority.

Example:

{"itemId": <portal item id>} 
{“url”: <image service url>}
{“uri”: <cloud raster uri or shared data path>}

outputName

(Required)

Output hosted image service properties. If the hosted image service is already created, the portal item ID or service URL can be given to the service tool. The output path of the multidimensional raster dataset generated in the raster store will be used to update the existing service definition. The service tool can also generate new hosted image service with the given service properties.

The output hosted image service is stored in raster store and shared on either the Raster Analysis Image Server or Image Hosting Image Server depending on the Enterprise configuration.

Syntax: JSON object describes the output multidimensional raster. At least one type of input needs to be provided in the JSON object. If multiple inputs are given, the itemId takes priority.

Note:

Set image,metadata as image service capabilities to make sure the output image service can be recognized as multidimensional by other raster analysis tools.

Example

outputName={"itemId": <portal item id>}
outputName={“url”: <image service url>}
outputName={“uri”: <cloud raster uri or shared data path>}
or
{"serviceProperties": {“name”: ”changes_detected”}}

changeType

(Required)

Specifies the change information to calculate.

  • TIME_OF_LATEST_CHANGE—Each pixel will contain the date of the most recent change for that pixel in the time series.
  • TIME_OF_EARLIEST_CHANGE—Each pixel will contain the date of the earliest change for that pixel in the time series.
  • TIME_OF_LARGEST_CHANGE—Each pixel will contain the date of the most significant change for that pixel in the time series.
  • NUM_OF_CHANGES—Each pixel will contain the total number of times the pixel changed in the time series.

Syntax: A string representing the changeType

Example

changeType = TIME_OF_LATEST_CHANGE

maxNumberOfChanges

(Optional)

Value representing the maximum number of changes.

Example

maxNumberOfChanges=3

context

(Optional)

Contains additional settings that affect task execution. This task has the following settings:

  • Extent (extent)—A bounding box that defines the analysis area.
  • Output Spatial Reference(outSR)—The output raster will be projected into the output spatial reference.
  • Snap Raster (snapRaster)—The output raster will have its cells aligned with the specified snap raster.
  • Cell Size (cellSize)—The output raster will have the resolution specified by cell size.
  • Parallel Processing Factor (parallelProcessingFactor)—The specified number or percentage of processes will be used for the analysis.

Example

context={"cellSize": "20", "parallelProcessingFactor": "4"}

f

The response format. The default response format is html.

Values: html | json

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 Checking job status. 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:

https://<analysis-url>/DetectChangeUsingChangeAnalysisRaster/jobs/<jobId>

Accessing results

When the status of the job request is esriJobSucceded, you can access the results of the analysis by making a request of the following form.

https://<raster analysis url>/DetectChangeUsingChangeAnalysisRaster/jobs/<jobId>/results/outputRaster?token=<your token>&f=json

ParameterDescription
outputRaster

The output multidimensional raster itemId and URL

Example:

{"url": "https://rasteranalysis-url>/DetectChangeUsingChangeAnalysisRaster/jobs/<jobId>/results/outputMultidimensionalRaster"}

{"url":
"http://<raster analysis url>/DetectChangeUsingChangeAnalysisRaster/jobs/<jobId>/results/outputRaster"}

The result has properties for parameter name, data type, and value. The content of the value is always the output raster dataset's itemId and image service URL.

{
 "paramName": "outputRaster",
 "dataType": "GPString",
 "value": {
  "itemId": "c267610d0feb4370bf38cc6e2c4ac261",
  "url": "https://<server name>/arcgis/rest/services/Hosted/<service name>/ImageServer"
 }
}