Compute Tie Points

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

Description

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

Parameter Details

Parameter	Details
`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: Use dark colors for code blocksCopy `1 2 3 4 5 6 7 8 9 10 [ { "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.

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:

Use dark colors for code blocksCopy
[
  {
  "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

Use dark colors for code blocksCopy
{
"tiePoints":
  {
    "sourcePoints" : [<sourcePoint1>, <sourcePoint2>, <sourcePoint3> ...], //array of points
    "targetPoints" : [<targetPoint1>, <targetPoint2>, <targetPoint3> ...], //array of points
  }
}

JSON Response example

Use dark colors for code blocksCopy
{
    "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
                }
            },
            ...
        ]
    }
}