Project (Image Service)

Description

This operation is supported at 10.3 and later.

The project operation is performed on an image service resource. This operation projects an array of input geometries from the input spatial reference to the output spatial reference. The response order of geometries is in the same order as they were requested.

The project supports projecting geometries to different spatial references. This operation supports spatial references represented in the Image coordinate system, which is not available through the project operation of a geometry service.

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

Request parameters

Parameter

Details

f

Description:  (Optional) The response format. The default response format is html.
Values:   html | json

geometries

Description: The array of geometries to be projected. The structure of each geometry in the array is the same as the structure of the JSON geometry objects returned by the ArcGIS REST API.

JSON structures:

Syntax:

{
  "geometryType" : "<esriGeometryPoint | esriGeometryMultipoint | esriGeometryPolyline | esriGeometryPolygon>"
  "geometries" : [ <geometry1>, <geometry1>, ..., <geometryN> ]
}

The geometries parameter is an array of input geometries. All geometries in this array should be of the type defined by geometryType.

Example:

{
  "geometryType" : "esriGeometryPolyline",
    "geometries" : 
  [
    {
      "paths" : 
      [
        [[-117,34],[-116,34],[-117,33]],
        [[-115,44],[-114,43],[-115,43]]
      ]
    },
    {
      "paths" : 
      [
        [[32,17],[31,17],[30,17],[30,16]]
      ]
    }
  ]
}

inSR

Description: A well-known ID wkid of the spatial reference, an image coordinate system ID icsid, or a spatial reference JSON object for the input geometries. For a list of valid WKID values, see Projected coordinate systems and Geographic coordinate systems.

An image coordinate system ID can be specified using 0:icsid; for example, 0:64. The extra 0: is used to avoid conflicts with wkid

outSR

Description: A well-known ID wkid of the spatial reference, an image coordinate system ID icsid, or a spatial reference JSON object for the output geometries. For a list of valid WKID values, see Projected coordinate systems and Geographic coordinate systems.

An image coordinate system ID can be specified using 0:icsid; for example, 0:64. The extra 0: is used to avoid conflicts with wkid

Example usage

Example 1

This example projects an envelope into the image coordinate system represented using icsid. The projected envelope can be used to overlay with the image.

http://gisserver:6080/arcgis/rest/services/MyImageService/ImageServer/project?f=json&inSR=32611&outSR=0:64&geometries={"geometries": [{"xmin":376899.62711532967,"ymin":3773691.3005017433,"xmax":377475.15287916746,"ymax":3774194.0492160516}],"geometryType":"esriGeometryEnvelope"}

Example 2

This example projects an envelope represented in one image coordinate system (full ics json) to another image coordinate system (icsid). The projected envelope can be used to overlay with the image.

http://gisserver:6080/arcgis/rest/services/MyImageService/ImageServer/project?f=json&outSR=0:25&inSR={"ics":{"name":"64","alias":"","abbreviation":"","remarks":"","geodataXform":{"xf_0":{"polynomialOrder":1,"spatialReference":{"wkid":null},"coeffX":[0,1,0],"coeffY":[0,0,1],"inverseCoeffX":[7360.006517203576,-0.9999999999964793,-2.6535897933527304E-6],"inverseCoeffY":[4911.990234780913,2.6535897933527304E-6,-0.9999999999964793],"name":"","type":"PolynomialXform"},"xf_1":{"polynomialOrder":1,"spatialReference":{"wkid":null},"coeffX":[0,1,0],"coeffY":[0,0,1],"inverseCoeffX":[7360.006517203576,-0.9999999999964793,-2.6535897933527304E-6],"inverseCoeffY":[4911.990234780913,2.6535897933527304E-6,-0.9999999999964793],"name":"","type":"PolynomialXform"},"xf_2":{"polynomialOrder":1,"spatialReference":{"wkid":null},"coeffX":[0,1,0],"coeffY":[0,0,1],"inverseCoeffX":[7360.006517203576,-0.9999999999964793,-2.6535897933527304E-6],"inverseCoeffY":[4911.990234780913,2.6535897933527304E-6,-0.9999999999964793],"name":"","type":"PolynomialXform"},"xf_3":{"polynomialOrder":1,"spatialReference":{"wkid":null},"coeffX":[0,1,0],"coeffY":[0,0,1],"inverseCoeffX":[7360.006517203576,-0.9999999999964793,-2.6535897933527304E-6],"inverseCoeffY":[4911.990234780913,2.6535897933527304E-6,-0.9999999999964793],"name":"","type":"PolynomialXform"},"xf_4":{"polynomialOrder":1,"spatialReference":{"wkid":null},"coeffX":[0,1,0],"coeffY":[0,0,1],"inverseCoeffX":[7360.006517203576,-0.9999999999964793,-2.6535897933527304E-6],"inverseCoeffY":[4911.990234780913,2.6535897933527304E-6,-0.9999999999964793],"name":"","type":"PolynomialXform"},"xf_5":{"polynomialOrder":1,"spatialReference":{"wkid":null},"coeffX":[0,1,0],"coeffY":[0,0,1],"inverseCoeffX":[7360.006517203576,-0.9999999999964793,-2.6535897933527304E-6],"inverseCoeffY":[4911.990234780913,2.6535897933527304E-6,-0.9999999999964793],"name":"","type":"PolynomialXform"},"xf_6":{"polynomialOrder":1,"spatialReference":{"wkid":null},"coeffX":[0,1,0],"coeffY":[0,0,1],"inverseCoeffX":[7360.006517203576,-0.9999999999964793,-2.6535897933527304E-6],"inverseCoeffY":[4911.990234780913,2.6535897933527304E-6,-0.9999999999964793],"name":"","type":"PolynomialXform"},"xf_7":{"polynomialOrder":1,"spatialReference":{"wkid":null},"coeffX":[0,1,0],"coeffY":[0,0,1],"inverseCoeffX":[7360.006517203576,-0.9999999999964793,-2.6535897933527304E-6],"inverseCoeffY":[4911.990234780913,2.6535897933527304E-6,-0.9999999999964793],"name":"","type":"PolynomialXform"},"xf_8":{"polynomialOrder":1,"spatialReference":{"wkid":null},"coeffX":[0,1,0],"coeffY":[0,0,1],"inverseCoeffX":[7360.006517203576,-0.9999999999964793,-2.6535897933527304E-6],"inverseCoeffY":[4911.990234780913,2.6535897933527304E-6,-0.9999999999964793],"name":"","type":"PolynomialXform"},"xf_9":{"polynomialOrder":1,"spatialReference":{"wkid":null},"coeffX":[0,1,0],"coeffY":[0,0,1],"inverseCoeffX":[7360.006517203576,-0.9999999999964793,-2.6535897933527304E-6],"inverseCoeffY":[4911.990234780913,2.6535897933527304E-6,-0.9999999999964793],"name":"","type":"PolynomialXform"},"xf_10":{"polynomialOrder":1,"spatialReference":{"wkid":null},"coeffX":[0,1,0],"coeffY":[0,0,1],"inverseCoeffX":[7360.006517203576,-0.9999999999964793,-2.6535897933527304E-6],"inverseCoeffY":[4911.990234780913,2.6535897933527304E-6,-0.9999999999964793],"name":"","type":"PolynomialXform"},"xf_11":{"polynomialOrder":1,"spatialReference":{"wkid":null},"coeffX":[0,1,0],"coeffY":[0,0,1],"inverseCoeffX":[7360.006517203576,-0.9999999999964793,-2.6535897933527304E-6],"inverseCoeffY":[4911.990234780913,2.6535897933527304E-6,-0.9999999999964793],"name":"","type":"PolynomialXform"},"xf_12":{"spatialReference":{"wkid":null},"coefficients":[1,0,-0.5,0,1,-4911.5],"cellsizeRatio":0,"type":"GeometricXform"},"xf_13":{"spatialReference":{"wkid":32611,"latestWkid":32611},"constantZ":0,"ZFactor":1,"ZOffset":0,"correctGeoid":false,"requireDEM":false,"interiorOrientation":{"polynomialOrder":1,"spatialReference":{"wkid":null},"coeffX":[-17955.96006895089,4.8800000187392,-1.0835776761950911E-15],"coeffY":[11982.840046014107,0,4.8800000187392],"inverseCoeffX":[3679.5,0.204918032,0],"inverseCoeffY":[-2455.5,0,0.204918032],"name":"","type":"PolynomialXform"},"konrady":true,"konradyParameters":[0,0,0,0,0],"konradyType":"esriRasterKonradyESRI","curvatureAndRefraction":true,"earthRadius":6370000,"averageZ":90,"principalPoint":{"x":-182.1847804,"y":88.01772991},"focalLength":84919.48966,"polarity":-1,"sensorPosition":{"x":377211.6395,"y":3774819.265,"z":891.827254},"exteriorOrientation":[0.9995544956154584,-0.029224409890167363,0.006061696255846665,0.02458829068481682,0.6911741282950284,-0.7222698528505856,0.016918222605392323,0.7220971252139001,0.6915847854758629],"clockwise":true,"type":"FrameXform"},"requireDEM":false,"type":"CompositeXform"},"extent":{"xmin":376899.62711532967,"ymin":3773691.3005017433,"xmax":377475.15287916746,"ymax":3774194.0492160516},"nativeExtent":{"xmin":0,"ymin":0,"xmax":7360,"ymax":4912},"dx":1,"dy":1,"type":"ImageCoordinateSystem"}}&geometries={"geometries":[{"xmin":3251.277750324316,"ymin":3900.6344562452155,"xmax":4105.275357155627,"ymax":4945.234427499745}],"geometryType":"esriGeometryEnvelope"}

JSON response syntax

{
  "geometries" : [ <geometry1>, <geometry1>, ..., <geometryN> ]
}

JSON response example

{"geometries":[{"xmin":5536.8295812712295,"ymin":717.24323632829237,"xmax":6816.8256927037392,"ymax":1247.0510883794909}]}

10/6/2017