public static enum CommonCRS.Vertical extends Enum<CommonCRS.Vertical>
Vertical
fallback on hard-coded values. Consequently, those methods never return null
.
Referencing objects are cached after creation. Invoking the same method on the same Vertical
instance twice will return the same IdentifiedObject
instance, unless the internal cache has been cleared
(e.g. the application is running in a container environment and some modules have been installed or uninstalled).
Example: the following code fetches a vertical Coordinate Reference System for heights above the Mean Sea Level (MSL):
Below is an alphabetical list of object names available in this enumeration:VerticalCRS crs = CommonCRS.Vertical.MEAN_SEA_LEVEL.crs();
Geodetic objects accessible by enumeration constants Name or alias Object type Enumeration value Barometric altitude CRS, Datum BAROMETRIC
Mean Sea Level Datum MEAN_SEA_LEVEL
Mean Sea Level depth CRS DEPTH
Mean Sea Level height CRS MEAN_SEA_LEVEL
Other surface CRS, Datum OTHER_SURFACE
GEOIDAL
value because its definition depends on the realization epoch.
For example EGM84, EGM96 and EGM2008 are applications of three different geoid models on the WGS 84 ellipsoid.
The MEAN_SEA_LEVEL
value can be used instead as an approximation of geoidal heights.Defined in the sis-referencing
module
Enum Constant and Description |
---|
BAROMETRIC
Height measured by atmospheric pressure in hectopascals (hPa).
|
DEPTH
Depth measured below the Mean Sea Level (MSL) in metres.
|
ELLIPSOIDAL
Height measured along the normal to the ellipsoid used in the definition of horizontal datum.
|
MEAN_SEA_LEVEL
Height measured above the Mean Sea Level (MSL) in metres.
|
OTHER_SURFACE
Height measured above other kind of surface, for example a geological feature.
|
Modifier and Type | Method and Description |
---|---|
VerticalCRS |
crs()
Returns the coordinate reference system associated to this vertical object.
|
VerticalDatum |
datum()
Returns the datum associated to this vertical object.
|
static CommonCRS.Vertical |
valueOf(String name)
Returns the enum constant of this type with the specified name.
|
static CommonCRS.Vertical[] |
values()
Returns an array containing the constants of this enum type, in
the order they are declared.
|
public static final CommonCRS.Vertical BAROMETRIC
VerticalDatumType.BAROMETRIC
public static final CommonCRS.Vertical MEAN_SEA_LEVEL
EPSG identifiers: 5714 (datum: 5100) Primary names: "MSL height" (datum: "Mean Sea Level") Abbreviations or aliases: "mean sea level height" (datum: "MSL") Direction: AxisDirection.UP
Unit: SI.METRE
VerticalDatumType.GEOIDAL
public static final CommonCRS.Vertical DEPTH
EPSG identifiers: 5715 (datum: 5100) Primary names: "MSL depth" (datum: "Mean Sea Level") Abbreviations or aliases: "mean sea level depth" (datum: "MSL") Direction: AxisDirection.DOWN
Unit: SI.METRE
VerticalDatumType.GEOIDAL
public static final CommonCRS.Vertical ELLIPSOIDAL
Ellipsoidal height is not part of ISO 19111 international standard.
Such vertical CRS is usually not recommended since ellipsoidal heights make little sense without
their (latitude, longitude) locations. The ISO specification defines instead
three-dimensional GeographicCRS
for that reason. Users are encouraged to avoid this orphan
ellipsoidal height as much as possible.
public static final CommonCRS.Vertical OTHER_SURFACE
VerticalDatumType.OTHER_SURFACE
public static CommonCRS.Vertical[] values()
for (CommonCRS.Vertical c : CommonCRS.Vertical.values()) System.out.println(c);
public static CommonCRS.Vertical valueOf(String name)
name
- the name of the enum constant to be returned.IllegalArgumentException
- if this enum type has no constant with the specified nameNullPointerException
- if the argument is nullpublic VerticalCRS crs()
Commonly used vertical CRS Name or alias Enum EPSG Barometric altitude BAROMETRIC
Mean Sea Level depth DEPTH
5715 Mean Sea Level height MEAN_SEA_LEVEL
5714 Other surface OTHER_SURFACE
DefaultVerticalCRS
public VerticalDatum datum()
Commonly used vertical datum Name or alias Enum EPSG Barometric altitude BAROMETRIC
Mean Sea Level MEAN_SEA_LEVEL
5100 Other surface OTHER_SURFACE
DefaultVerticalDatum
Copyright © 2010–2015 The Apache Software Foundation. All rights reserved.