Skip To Content
ArcGIS Developer

Match Control Points


Match Control Points diagram

The MatchControlPoints 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.

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

Request parameters


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

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


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



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 type attribute: tie points and ground control points.

  "pointId": <id>,
  "spatialReference":{<spatialReference>}, //default WGS84
  "imagePointSpatialReference": {}, // default ICS
  "imagePoints": [



Sets the similarity tolerance level for your matching control point. Low tolerance will produce the most control points, but some may have a higher level of error. Medium tolerance will produce a medium amount of control points. High tolerance will produce the least number of control points, but each matching pair will have a lower level of error. High tolerance is the default value.


Identifies additional settings such as the input control points spatial reference, which can be specified here. The context parameter is used to define both groundControlPointsSpatialReference and imagePointsSpatialReference. If these two parameters are not defined, the tool will use the spatial reference defined in the input point set. If no spatial reference is defined in the input point set, the default ground control point coordinates are in longitude-latitude, and the image points coordinates are in the image coordinate system.

{"groundControlPointsSpatialRefrence": {"wkid": 3459},
"imagePointSpatialReference": {"wkid": 3459}}


The response format. The default response format is html.

Values: html | json


When you submit a request, the task assigns a unique job ID for the transaction.


"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:

https://<orthomapping tools url>/MatchControlPoints/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:

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 MatchControlPoints.

JSON Request example

imageCollection={"itemId": "1780d648db3545bba8661ad98df824a4"}&
{"geometry": {"x":-118.15,"y":33.80,"z":10.0,"spatialReference":{"wkid":4326}},
 "attributes": {"imageID":22, "pointID":2, "type":2, "status":1}

Related topics