Skip To Content
ArcGIS Developer
Dashboard

Common Data Types

Image coordinate systems

Description

Starting at 10.3, spatial reference has been enhanced to support image coordinate systems. An image coordinate system defines the spatial reference in terms of a primary image. A primary image displayed in its own image coordinate system exhibits no distortions; other images and features can be projected to overlap with the primary image using its image coordinate system. Many imagery-centric workflows require displaying images in image coordinate systems instead of map coordinates (geographic or projected coordinate systems); for example, oblique images are distorted significantly when displayed in map coordinates but can be displayed nicely in a top-up view without distortions.

At 10.3, only image services support image coordinate systems. To get an image's image coordinate system, use Raster ICS; to project geometries between a geographic or projected coordinate system and an image coordinate system, use Project (Image Service). Image coordinate systems can be used in image service operations when spatial reference or geometry parameters are needed.

The syntax and examples are listed below.

icsid-based syntax

JSON syntax

{
 "icsid" : <icsid> //an ics id is the objectid of the image in a mosaic dataset.
 }

JSON example

{
 "icsid" : 9,
}

ics-based syntax

JSON syntax

{"ics" : <ics>} //the full ics json, which include transformations and map spatial reference information and specific to each image.

JSON example

{"ics":{"name":"AMD_MAMD_CAT\\Raster.OBJECTID = 9","alias":"","abbreviation":"","remarks":"","geodataXform":{"xf_0":{"polynomialOrder":1,"spatialReference":{"wkid":null},"coeffX":[9623.012693429835,-0.9999999999964793,-2.6535897933527304E-6],"coeffY":[9566.987232235868,2.6535897933527304E-6,-0.9999999999964793],"inverseCoeffX":[9623.012693429835,-0.9999999999964793,-2.6535897933527304E-6],"inverseCoeffY":[9566.987232235868,2.6535897933527304E-6,-0.9999999999964793],"name":"","type":"PolynomialXform"},"xf_1":{"spatialReference":{"wkid":null},"coefficients":[1,0,0,0,1,-9567],"cellsizeRatio":0,"type":"GeometricXform"},"xf_2":{"spatialReference":{"wkid":54004,"latestWkid":54004},"constantZ":355.956,"ZFactor":1,"ZOffset":0,"correctGeoid":false,"requireDEM":false,"interiorOrientation":{"polynomialOrder":1,"spatialReference":{"wkid":null},"coeffX":[-122009.1743773452,25.00342950222755,-0.0022927308709069037],"coeffY":[120345.98809819827,0.004618452740478162,24.9975640326764],"inverseCoeffX":[4879.256039082114,0.0399945128715,3.6682236000000004E-6],"inverseCoeffY":[-4815.210096242967,-7.3892307E-6,0.0400038972498],"name":"","type":"PolynomialXform"},"konrady":true,"konradyParameters":[-1.2603314589834097E-5,1.6224555868275652E-15,-3.6421117033555566E-26,0,0],"konradyType":"esriRasterKonradyESRI","curvatureAndRefraction":true,"earthRadius":6378137,"averageZ":355.956,"principalPoint":{"x":-7,"y":-9},"focalLength":153643,"polarity":-1,"sensorPosition":{"x":4490522.42482,"y":5479087.21653,"z":1124.11318},"exteriorOrientation":[-0.02457152019,-0.999287714912,0.028640936125,0.999696909733,-0.024517669223,0.002229925319,-0.001526127978,0.028687047991,0.999587276935],"clockwise":true,"type":"FrameXform"},"requireDEM":false,"type":"CompositeXform"},"extent":{"xmin":4489902.49613457,"ymin":5478442.107347395,"xmax":4491127.765586247,"ymax":5479675.116981766},"nativeExtent":{"xmin":-0.5,"ymin":-0.5,"xmax":9623.5,"ymax":9567.5},"dx":1,"dy":1,"type":"ImageCoordinateSystem"}}

In this topic
  1. Description