- URL:
- https://<root>/System/OrthomappingTools/GPServer/MatchControlPoints
- Methods:
GET
- Version Introduced:
- 10.6.1
Description
The Match
operation is a service tool that computes matching tie points using a collection of ground control points having at least one tie point. The input collection of ground control points must be in JSON.
Request parameters
Parameter | Details |
---|---|
| The image collection (mosaic dataset) name or URL. The image service must exist before calling Syntax: A JSON object supports three keys: itemId, url, and uri. These keys are case sensitive. Example:
|
(Required) | The ground control points (GCP) sets written as a JSON object. The similarity tolerance for finding control points will be low. Syntax: The schema of the control points' JSON follows the schema of the mosaic dataset's control point table. The control points must contain one geometry and attribute set. There are two types of control points determined by the
|
(Optional) | Sets the similarity tolerance level for your matching control point. |
| Identifies additional settings such as the input control points spatial reference, which can be specified here. The
|
|
The response format. The default response format is html. Values: |
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 job
to periodically review the status of the job and messages as described in Checking job status. Once the job has successfully completed, use job
to retrieve the results. To track the status, you can make a request of the following form:
https://<orthomapping tools url>/MatchControlPoints/jobs/<jobId>
When the status of the job request is esri
, you can access the results of the analysis by making a request of the following form:
https://<orthomapping tools url>/MatchControlPoints/jobs/<jobId>/results/result?token=<your token>&f=json
The result will be a JSON file.
Example usage
Below is a sample URL for Match
.
https://services.myserver.com/arcgis/rest/services/System/OrthomappingTools/GPServer/MatchControlPoints/submitJob
JSON Request example
imageCollection={"itemId": "1780d648db3545bba8661ad98df824a4"}&
inputControlPoints={
{"geometry": {"x":-118.15,"y":33.80,"z":10.0,"spatialReference":{"wkid":4326}},
"attributes": {"imageID":22, "pointID":2, "type":2, "status":1}
}