Compute Control Points

URL:
https://<root>/System/OrthomappingTools/GPServer/ComputeControlPoints
Methods:
GET
Version Introduced:
10.6.1

Description

Compute Control Points diagram

The ComputeControlPoints operation is a service tool that's used to compute matching control points between images in an image collection, and for matching control points between the image collection's images and the reference image.

Request parameters

ParameterDetails

imageCollection

The image collection (mosaic dataset) name or URL. The image service must exist before calling ComputeControlPoints .

Syntax: A JSON object supports three keys: itemId, url, and uri. These keys are case sensitive.

Example:

Use dark colors for code blocksCopy
1
2
3
{"itemId": “<portal item id>”}
{“url”: “<image service url>”}
{“uri”: “<cloud raster uri or shared data path>”}

referenceImage

(Optional)

The reference image service that can be used to generate control points for rectifying the image service. This setting is optional. If not given, the service tool will compute matching control points among the overlapped images in the image collection.

Use dark colors for code blocksCopy
1
2
3
{"itemId": "<portal item id>"}
{"url": "<image service url>"}
{"uri": "<cloud raster uri or shared data path>"}

imageLocationAccuracy

(Optional)

Allows you to specify the location accuracy of your image. This option allows you to specify the GPS location accuracy level of the source image. It determines how far the tool will search for neighboring matching images for calculating tie points and block adjustments. The following are the available options:

  • High : GPS accuracy of 0 to 10 meters, and the tool uses a maximum of 4 by 3 images.
  • Medium : GPS accuracy of 10 to 20 meters, and the tool uses a maximum of 4 by 6 images.
  • Low : GPS accuracy of 20 to 50 meters, and the tool uses a maximum of 4 by 12 images.

context

(Optional)

Contains additional environment settings (pointSimilarity , pointDensity , pointDistribution ) that affect the generation of output control points.

  • pointSimilarity : Sets LOW , MEDIUM , or HIGH tolerance for computing control points with varying levels of potential error. LOW tolerance will produce the most control point, but may have a higher level of error. HIGH tolerance will produce the least number of control point, but each matching pair will have a lower level of error. MEDIUM tolerance will set the similarity tolerance to medium.
  • pointDensity : Sets the number of tie points (LOW , MEDIUM , or HIGH ), to be created. LOW point density will create the fewest number of tie points. MEDIUM point density will create a moderate number of tie points. HIGH point density will create the highest number of tie points.
  • pointDistribution : Randomly generates points that are better for overlapping areas with irregular shapes. RANDOM will generate points that are better for overlapping areas with irregular shapes. REGULAR will generate points based on a fixed pattern and uses the point density to determine how frequently to create points.
  • parallelProcessingFactor : The specified number or percentage of processes will be used for the analysis.
Use dark colors for code blocksCopy
1
2
3
4
5
{
"pointSimilarity": "MEDIUM",
"pointDensity": "MEDIUM",
"pointDistribution": "RANDOM"
}

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:

Use dark colors for code blocksCopy
1
2
3
4
{
"jobId": "<unique job identifier>",
"jobStatus": "<job status>"
}

After the initial request is submitted, you can use jobId to periodically review the status of the job and messages as described in Checking job status. Once the job has successfully completed, use jobId to retrieve the results. To track the status, you can make a request of the following form:

Use dark colors for code blocksCopy
1
https://<orthomapping tools url>/ComputeControlPoints/jobs/<jobId>

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:

Use dark colors for code blocksCopy
1
https://<orthomapping tolls url>/ComputeControlPoints/jobs/<jobId>/results/result?token=<your token>&f=json

The result will be the control points' JSON file.

Example usage

The following is a sample URL for ComputeControlPoints :

Use dark colors for code blocksCopy
1
https://services.myserver.com/arcgis/rest/services/System/OrthomappingTools/GPServer/ComputeControlPoints/submitJob

JSON Request example

Use dark colors for code blocksCopy
1
2
3
4
imageCollection={"itemId": "1780d648db3545bba8661ad98df824a4"}&
referenceImage={"itemId":"1780d648db3545bba8661ad98df824a4"}&
imageLocationAccuracy=High&
context={}

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