Skip To Content
ArcGIS Developer
Dashboard

Compute Tie Points

  • URL:https://<imageservice-url>/computeTiePoints
  • Required Capability:Catalog
  • Version Introduced:10.2

Description

License:

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

This operation is supported at 10.2 and later.

The computeTiePoints operation is performed on an image service resource.

This operation is supported by an image service published from mosaic datasets.

The result of this operation contains tie points that can be used to match the source image to the reference image. The reference image is configured by the image service publisher. For more information, see Fundamentals for georeferencing a raster dataset.

You can provide arguments to the computeTiePoints operation as query parameters defined in the following parameters table:

Request parameters

ParameterDetails
f

The response format. The default response format is html.

Values: html | json

rasterId

(Required)

Description: The source raster ID.

Syntax: rasterId=<rasterId1>

Example: rasterId=3

geodataTransforms

(Required)

Description: The geodata transformation that provides a rough fit of the source image to the reference image. For example, a first order polynomial transformation that fits the source image to the expected location. Following is the JSON representation of transformations:

Syntax:

[
  {
  "geodataTransform" : "<geodataTransformName1>",
  "geodataTransformArguments" : {<geodataTransformArguments1>}
  },
  {
  "geodataTransform" : "<geodataTransformName2>",
  "geodataTransformArguments" : {<geodataTransformArguments2>}
  }
]

The syntax of the geodataTransformArguments property varies based on the specified geodataTransform name. See Geodata transformations documentation for details.

JSON Response syntax

{
"tiePoints":  
  {
    "sourcePoints" : [<sourcePoint1>, <sourcePoint2>, <sourcePoint3> ...], //array of points
    "targetPoints" : [<targetPoint1>, <targetPoint2>, <targetPoint3> ...], //array of points
  }
}

JSON Response example

{
    "tiePoints": {
        "sourcePoints": [
            {
                "x": 182.13644151133485,
                "y": -10.639332980441395,
                "spatialReference": {
                    "wkid": 102100,
                    "latestWkid": 3857
                }
            },
            {
                "x": 398.1000212416984,
                "y": -172.72646918773535,
                "spatialReference": {
                    "wkid": 102100,
                    "latestWkid": 3857
                }
            },
            ...
        ],
        "targetPoints": [
            {
                "x": -12973096.609529195,
                "y": 4010142.1429209215,
                "spatialReference": {
                    "wkid": 102100,
                    "latestWkid": 3857
                }
            },
            {
                "x": -12969974.200600015,
                "y": 4007799.949344477,
                "spatialReference": {
                    "wkid": 102100,
                    "latestWkid": 3857
                }
            },
            ...
        ]
    }
}