spatialReference

The spatialReference object is located at the top level of the web map 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. It is required to have this property saved within the web map.

Referenced by: anchorPoint, centerPoint, extent, Georeference, layerDefinition, mapLocation, multipointGeometry, pointGeometry, polygonGeometry, polylineGeometry, Query Table DataSource, tileInfo, Web Link Chart, Webmap

Properties

Property Details
latestWkid (Optional) Identifies the current wkid value associated with the same spatial reference. For example a WKID of '102100' (Web Mercator) has a latestWKid of '3857'.
wkid The well-known ID (WKID) of the coordinate system.
wkt The well-known text (WKT) of the coordinate system.
wkt2 The well-known text of the coordinate system as defined by OGC standard for well-known text strings.

Can be one of the following:

Additional information

All operational layers in the map are drawn or requested in the spatial reference of the basemap layers.

The basemap defines the map spatial reference and tiling scheme. 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:

Projected Coordinate Systems Listing

Geographic Coordinate Systems Listing

Vertical Coordinate Systems Listing

Additional information regarding how web maps work with geometry and spatial reference can be found on the Resource Center:

ArcGIS Server REST API Geometry object

Using spatial references

Working with Geometry Objects

wkid Example

{
  "wkid": 102100,
  "latestWkid": 3857
}

wkt & wkt2 - can be represented as wkt (transitioning to wkt2 and hence both) 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]]",
  "wkt2": "PROJCRS[\"WGS_1984_Web_Mercator_Auxiliary_Sphere\",BASEGEOGCRS[\"GCS_WGS_1984\",DYNAMIC[FRAMEEPOCH[1990.5],MODEL[\"AM0-2\"]],DATUM[\"D_WGS_1984\", ELLIPSOID[\"WGS_1984\",6378137.0,298.257223563,LENGTHUNIT[\"Meter\",1.0]]],PRIMEM[\"Greenwich\",0.0,ANGLEUNIT[\"Degree\",0.0174532925199433]],CS[ellipsoidal,2],AXIS[\"Latitude (lat)\",north,ORDER[1]],AXIS[\"Longitude (lon)\",east,ORDER[2]],ANGLEUNIT[\"Degree\",0.0174532925199433]],CONVERSION[\"Mercator_Auxiliary_Sphere\",METHOD[\"Mercator_Auxiliary_Sphere\"],PARAMETER[\"False_Easting\",0.0,LENGTHUNIT[\"Meter\",1.0]],PARAMETER[\"False_Northing\",0.0,LENGTHUNIT[\"Meter\",1.0]],PARAMETER[\"Central_Meridian\",0.0,ANGLEUNIT[\"Degree\",0.0174532925199433]],PARAMETER[\"Standard_Parallel_1\",0.0,ANGLEUNIT[\"Degree\",0.0174532925199433]],PARAMETER[\"Auxiliary_Sphere_Type\",0.0]],CS[Cartesian,2],AXIS[\"Easting (X)\",east,ORDER[1]],AXIS[\"Northing (Y)\",north,ORDER[2]],LENGTHUNIT[\"Meter\",1.0]]"
}

wkt - all versions 2.28 and earlier. 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]]"
}

wkt2 - can be represented only as wkt2, so will not contain wkt Example

{
  "wkt2": "PROJCRS[\"WGS_1984_Web_Mercator_Auxiliary_Sphere\",BASEGEOGCRS[\"GCS_WGS_1984\",DYNAMIC[FRAMEEPOCH[1990.5],MODEL[\"AM0-2\"]],DATUM[\"D_WGS_1984\", ELLIPSOID[\"WGS_1984\",6378137.0,298.257223563,LENGTHUNIT[\"Meter\",1.0]]],PRIMEM[\"Greenwich\",0.0,ANGLEUNIT[\"Degree\",0.0174532925199433]],CS[ellipsoidal,2],AXIS[\"Latitude (lat)\",north,ORDER[1]],AXIS[\"Longitude (lon)\",east,ORDER[2]],ANGLEUNIT[\"Degree\",0.0174532925199433]],CONVERSION[\"Mercator_Auxiliary_Sphere\",METHOD[\"Mercator_Auxiliary_Sphere\"],PARAMETER[\"False_Easting\",0.0,LENGTHUNIT[\"Meter\",1.0]],PARAMETER[\"False_Northing\",0.0,LENGTHUNIT[\"Meter\",1.0]],PARAMETER[\"Central_Meridian\",0.0,ANGLEUNIT[\"Degree\",0.0174532925199433]],PARAMETER[\"Standard_Parallel_1\",0.0,ANGLEUNIT[\"Degree\",0.0174532925199433]],PARAMETER[\"Auxiliary_Sphere_Type\",0.0]],CS[Cartesian,2],AXIS[\"Easting (X)\",east,ORDER[1]],AXIS[\"Northing (Y)\",north,ORDER[2]],LENGTHUNIT[\"Meter\",1.0]]"
}

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.