The spatialReference object is located at the top level of the JSON hierarchy. In addition to this, it is also available within the operationalLayer and basemap objects.
Many predefined spatial references have already been defined and are available for use. A spatial reference can be defined using a well-known ID (WKID) or well-known text (WKT). The default tolerance and resolution values for the associated coordinate system are used.
A spatial reference can optionally include a definition for a vertical coordinate system (VCS), which is used to interpret the z values of a geometry.
Referenced by: extent, Georeference, layerDefinition, multipointGeometry, pointGeometry, polygonGeometry, polylineGeometry, Query Table DataSource, tileInfo, Webscene
Properties
| Property | Details |
|---|---|
| falseM | The false origin of coordinate M values. The default is determined by the spatial reference. |
| falseX | The false origin of coordinate X values. The default is determined by the spatial reference. |
| falseY | The false origin of coordinate Y values. The default is determined by the spatial reference. |
| falseZ | The false origin of coordinate Z values. The default is determined by the spatial reference. |
| latestVcsWkid | The current wkid value of the vertical coordinate system. |
| latestWkid | Identifies the current wkid value associated with the same spatial reference. For example a WKID of '102100' (Web Mercator) has a latestWKid of '3857'. |
| mTolerance | The tolerance value reflects the accuracy of coordinates. If one coordinate is within the tolerance value of another, they are interpreted as being at the same location. This value is used in relational and topological operations when determining whether two points are close enough to be given the same coordinate value or they are far enough apart to each have their own coordinate value. The default tolerance is set to 0.001 meters or its equivalent in map units. |
| mUnits | The number of distinct values that can be represented per one unit of floating point coordinates. The resolution for M is 1/mUnits. The default resolution is set to 0.0001 meters or its equivalent in map units. |
| vcsWkid | The wkid value of the vertical coordinate system. |
| wkid | The well-known ID (WKID) of the coordinate system. Specify either WKID or the well-known text (WKT) of the coordinate system. |
| wkt | The well-known text (WKT) of the coordinate system. Specify either WKT or WKID of the coordinate system. |
| xyTolerance | The tolerance value reflects the accuracy of coordinates. If one coordinate is within the tolerance value of another, they are interpreted as being at the same location. This value is used in relational and topological operations when determining whether two points are close enough to be given the same coordinate value or they are far enough apart to each have their own coordinate value. The default tolerance is set to 0.001 meters or its equivalent in map units. |
| xyUnits | The number of distinct values that can be represented per one unit of floating point coordinates. The resolution for X and Y is 1/xyUnits. The default resolution is set to 0.0001 meters or its equivalent in map units. |
| zTolerance | The tolerance value reflects the accuracy of coordinates. If one coordinate is within the tolerance value of another, they are interpreted as being at the same location. This value is used in relational and topological operations when determining whether two points are close enough to be given the same coordinate value or they are far enough apart to each have their own coordinate value. The default tolerance is set to 0.001 meters or its equivalent in map units. |
| zUnits | The number of distinct values that can be represented per one unit of floating point coordinates. The resolution for Z is 1/zUnits. The default resolution is set to 0.0001 meters or its equivalent in map units. |
Additional information
All operational layers in the scene are drawn or requested in the spatial reference of the basemap layers.
The basemap defines the spatial reference and tiling scheme of the scene. Each baseMapLayer must be in the same spatial reference and tiling scheme.
For a complete list of supported IDs and their corresponding definition strings, see Coordinate Systems Listings.
For additional information regarding how web scenes work with geometry and spatial reference, see:
ArcGIS Server REST API Geometry object
wkid Example
{
"wkid": 102100,
"latestWkid": 3857
}wkid with precision Example
{
"wkid": 27700,
"latestWkid": 27700,
"xyTolerance": 0.0002,
"zTolerance": 0.0002,
"mTolerance": 0.001,
"falseX": -5220400,
"falseY": -15524400,
"falseZ": -100000,
"falseM": -100000,
"xyUnits": 10000,
"zUnits": 10000,
"mUnits": 10000
}wkt Example
{
"wkt": "PROJCS[\"WGS_1984_Web_Mercator_Auxiliary_Sphere\",GEOGCS[\"GCS_WGS_1984\",DATUM[\"D_WGS_1984\",SPHEROID[\"WGS_1984\",6378137.0,298.257223563]],PRIMEM[\"Greenwich\",0.0],UNIT[\"Degree\",0.0174532925199433]],PROJECTION[\"Mercator_Auxiliary_Sphere\"],PARAMETER[\"False_Easting\",0.0],PARAMETER[\"False_Northing\",0.0],PARAMETER[\"Central_Meridian\",0.0],PARAMETER[\"Standard_Parallel_1\",0.0],PARAMETER[\"Auxiliary_Sphere_Type\",0.0],UNIT[\"Meter\",1.0]]"
}