Package org.opengis.referencing.crs
A coordinate reference system (CRS) consists of one coordinate system (CS) that is related to the earth or platform through one datum. The coordinate system is composed of a set of coordinate axes with specified units of measure. This concept implies the mathematical rules that define how coordinate values are calculated from distances, angles and other geometric elements and vice versa.
A datum specifies the relationship of a coordinate system to the object, thus ensuring that the abstract mathematical concept “coordinate system” can be applied to the practical problem of describing positions of features on or near the earth's surface by means of coordinates. The object will generally, but not necessarily, be the earth; for certain coordinate reference systems, the object may be a moving platform.
CoordinateReferenceSystem
instances and their components shall be immutable.
For CRS defined on moving platforms such as cars, ships, aircraft and spacecraft,
transformation to an earthfixed coordinate reference system may include a time element.
Timevariability of coordinate reference systems may be covered by creating different
CoordinateReferenceSystem
instances, each with a different datum, for consecutive epochs.
The date of realization of the datum shall then be included in its definition.
Furthermore, it is recommended that the date of realization be included in the names of those datums
and coordinate reference systems.
Subtypes of coordinate reference system
Geodetic survey practice usually divides coordinate reference systems into a number of subtypes. The common classification criterion for subtyping of coordinate reference systems can be described as the way in which they deal with earth curvature. This has a direct effect on the portion of the earth's surface that can be covered by that type of CRS with an acceptable degree of error. Thus the following principal subtypes of coordinate reference system are distinguished:
Geocentric: Type of coordinate reference system that deals with the earth's curvature by taking the 3D spatial view, which obviates the need to model the earth's curvature. The origin of a geocentric CRS is at the approximate centre of mass of the earth.
Geographic: Type of coordinate reference system based on an ellipsoidal approximation of the geoid. This provides an accurate representation of the geometry of geographic features for a large portion of the earth's surface. Geographic coordinate reference systems can be 2D or 3D. A 2D Geographic CRS is used when positions of features are described on the surface of the reference ellipsoid; a 3D Geographic CRS is used when positions are described on, above or below the reference ellipsoid.
Projected: Type of coordinate reference system that is based on an approximation of the shape of the earth's surface by a plane. The distortion that is inherent to the approximation is carefully controlled and known. Distortion correction is commonly applied to calculated bearings and distances to produce values that are a close match to actual field values.
Engineering: Type of coordinate reference system that is that is used only in a contextually local sense. This subtype is used to model two broad categories of local coordinate reference systems:
 earthfixed systems, applied to engineering activities on or near the surface of the earth;
 coordinates on moving platforms such as road vehicles, vessels, aircraft or spacecraft.
Image: An Image CRS is an Engineering CRS applied to images. Image CRSs are treated as a separate subtype because a separate user community exists for images with its own vocabulary. The definition of the associated Image Datum contains two data attributes not relevant for other datums and coordinate reference systems.
Vertical: Type of coordinate reference system used for the recording of heights or depths. Vertical CRSs make use of the direction of gravity to define the concept of height or depth, but its relationship with gravity may not be straightforward. By implication ellipsoidal heights (h) cannot be captured in a vertical CRS. Ellipsoidal heights cannot exist independently, but only as inseparable part of a 3D coordinate tuple defined in a geographic 3D coordinate reference system.
Temporal: Used for the recording of time in association with any of the listed spatial coordinate reference systems. Any CRS can be associate with a temporal CRS to form a spatiotemporal compound CRS. More than one temporal CRS may be included if these axes represent different time quantities.
In addition to the above principal subtypes, so called because they represent concepts generally known in geodetic practice, two more subtypes have been defined to permit modelling of certain relationships and constraints that exist between the principal subtypes.
Compound: The traditional separation of horizontal and vertical position has resulted in coordinate reference systems that are horizontal (2D) in nature and vertical (1D). It is established practice to combine the horizontal coordinates of a point with a height or depth from a different CRS. The coordinate reference system to which these 3D coordinates are referenced combines the separate horizontal and vertical coordinate reference systems of the horizontal and vertical coordinates. Such a CRS is called a compound CRS. It consists of an ordered sequence of the two or more single coordinate reference systems.
Derived: Some coordinate reference systems are defined by applying a coordinate conversion to another CRS. Such a CRS is called a derived CRS and the coordinate reference system it was derived from by applying the conversion is called the source or base CRS. A coordinate conversion is an arithmetic operation with zero or more parameters that have defined values. The base CRS and derived CRS have the same datum.
 Since:
 1.0

ClassDescriptionA coordinate reference system describing the position of points through two or more independent coordinate reference systems.Base type of all Coordinate Reference Systems (CRS).Creates coordinate reference systems using authority codes.Builds up complex coordinate reference systems from simpler objects or values.A coordinate reference system that is defined by its coordinate conversion from another CRS but is not a projected CRS.A 1, 2 or 3dimensional contextually local coordinate reference system.A coordinate reference system that is defined by its coordinate conversion from another coordinate reference system.A 3dimensional coordinate reference system with the origin at the approximate centre of mass of the earth.A 2 or 3dimensional coordinate reference system associated with a geodetic datum.A 2 or 3dimensional coordinate reference system based on an ellipsoidal approximation of the geoid.A 2dimensional engineering coordinate reference system applied to locations in images.A 1dimensional coordinate reference system which uses parameter values or functions.A 2dimensional coordinate reference system used to approximate the shape of the earth on a planar surface.Base type of coordinate systems related to an object by a datum.A 1dimensional coordinate reference system used for the recording of time.A 1dimensional coordinate reference system used for recording heights or depths.