spatialReference

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
latestVcsWkid (Optional) The current wkid value of the vertical coordinate system.
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'.
vcsWkid (Optional) 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.

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

Using spatial references

wkid Example

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

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

You can no longer sign into this site. Go to your ArcGIS portal or the ArcGIS Location Platform dashboard to perform management tasks.

Your ArcGIS portal

Create, manage, and access API keys and OAuth 2.0 developer credentials, hosted layers, and data services.

Your ArcGIS Location Platform dashboard

Manage billing, monitor service usage, and access additional resources.

Learn more about these changes in the What's new in Esri Developers June 2024 blog post.

Close