URL:
https://<root>/System/RealitymappingTools/GPServer/DetectControlPoints
Methods:
GET
Version Introduced:
12.2

Describe

The DetectControlPoints operation is a service tool that automatically detect control points marks in the images of a collection of drone, aerial and satellite images managed by mosaic dataset or in a folder. The service tool takes an existing Ground Control Point feature layer as input, and output could either be a GeoJSON representation of the detected ground control point and image tie point set or a new feature layer containing the point sets.

Request parameters

ParameterDetails

imageCollection

(Required)

The image collection imagery layer item id or image service url. The input service must be dynamic imagery layer referencing mosaic dataset.

Syntax: JSON object.

Use dark colors for code blocksCopy
1
2
3
{"itemId": "<portal item id>"}
{"url": "<image service url>"}
{"uri": "<image collection dataset path>"}

inputControlPoints

(Required)

The input ground control coordinates given either as a feature layer or GeoJSON objects.

Example:

Use dark colors for code blocksCopy
1
2
3
4
{"itemId": "<portal item id>"}
{"url": "<image service url>"}
{"uri": "<image collection dataset path>"}
{<GeoJSON object of the input ground control point>}

outputControlPoints

(Required)

The output control points that will be automatically detected.

Example:

Use dark colors for code blocksCopy
1
2
3
4
{"itemId": <portal item id>}
{"url": <hosted feature service url>}
{"uri": <feature class local output path>}
{"serviceProperties":{"name":"detected_control_points","serviceUrl":"https://<server name>/server/rest/services/Hosted/controlpoints /FeatureServer"},"itemProperties":{"itemId":"8cfbd3ec25584d0d8fed23b8ff7c43b", "folderId":"sdfwerfbd3ec25584d0d8f4"}}

outputImageChips

Optionally the system service can also output image chips used in control point detection to data store.

Example:

Use dark colors for code blocksCopy
1
{"uri": "/cloudStores/bucket/detectgcp/output"}

cropedImageSize

The tile size of the output image chips.

The default tile size is 1024.

numberOfTiePoints

The number of tie points for each ground control point.

The default is 5.

context

Contains additional settings that affect task execution. The following setting is available:

  • Output Spatial Reference (outSR ) - The image collection will be projected into the output spatial reference. The outSR setting is required if you want the service to create the mosaic dataset and hosted image service.

  • Parallel Processing Factor — The specified number or percentage of processes will be used for the analysis.

  • Processor Type - You can process your data using the computer central processing unit (CPU) or the graphics processing unit (GPU).

Use dark colors for code blocksCopy
1
{"outSR": {spatial reference}}

f

The response format. The default response format is html.

Values: html | json | pjson

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://<realitymapping tools url>/DetectControlPoints/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://<realitymapping tools url>/DetectControlPoints/jobs/<jobId>/results/outProducts?token=<your token>&f=json

Example usage

The following is a sample URL for DetectControlPoints :

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

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