Module org.opengis.geoapi

Package org.opengis.referencing

Interface ReferenceSystem

All Superinterfaces:

IdentifiedObject

All Known Subinterfaces:

CompoundCRS, CoordinateReferenceSystem, DerivedCRS, EngineeringCRS, GeneralDerivedCRS, GeocentricCRS, GeodeticCRS, GeographicCRS, ImageCRS, ParametricCRS, ProjectedCRS, SingleCRS, TemporalCRS, VerticalCRS

@UML(identifier="RS_ReferenceSystem",
     specification=ISO_19115,
     version=2003)
public interface ReferenceSystem
extends IdentifiedObject

Base interface of reference systems by coordinates or by identifiers. A reference system contains the metadata required to interpret spatial location information unambiguously. Two methods to describe spatial location are distinguished:

• Spatial referencing by geographic identifier. Geographic identifiers are location descriptors such as addresses and grid indexes.
• Spatial referencing by coordinates. This specialized case is handled by the CoordinateReferenceSystem subtype.

Reference systems contain the following properties (including those inherited from the IdentifiedObject parent interface):

• A name (e.g. WGS 84 / World Mercator).
• Alternative names or aliases, sometimes used for abbreviations.
• Identifiers allocated by authorities (e.g. “EPSG:3395”).
• The domain of validity in which this reference system is valid (e.g. World - between 80°S and 84°N).
• The scope or intended usage for this reference system (e.g. Very small scale mapping).
• Remarks about this object, including data source information (e.g. Euro-centric view of world excluding polar areas).

Since:

1.0

See Also:

• CoordinateReferenceSystem

Departure from OGC/ISO standard for harmonization between different specifications

The type defined in ISO 19115 has no relationship with ISO 19111. GeoAPI redefines this type as a subtype of IdentifiedObject and the common parent for org.opengis.referencing.crs.CoordinateReferenceSystem and org.opengis.referencing.gazetteer.ReferenceSystemUsingIdentifiers. This change makes this interface closer to the legacy ISO 19115:2003 RS_ReferenceSystem than to ISO 19115:2015 MD_ReferenceSystem.

Field Summary

Fields

Modifier and Type	Field	Description
static final String	DOMAIN_OF_VALIDITY_KEY	Deprecated. Moved to ObjectDomain as of ISO 19111:2019.
static final String	SCOPE_KEY	Deprecated. Moved to ObjectDomain as of ISO 19111:2019.

Fields inherited from interface org.opengis.referencing.IdentifiedObject

ALIAS_KEY, DOMAINS_KEY, IDENTIFIERS_KEY, NAME_KEY, REMARKS_KEY

Method Summary

Modifier and Type	Method	Description
default Extent	getDomainOfValidity()	Deprecated. Replaced by IdentifiedObject.getDomains() as of ISO 19111:2019.
default InternationalString	getScope()	Deprecated. Replaced by IdentifiedObject.getDomains() as of ISO 19111:2019.

Methods inherited from interface org.opengis.referencing.IdentifiedObject

getAlias, getDomains, getIdentifiers, getName, getRemarks, toWKT

Field Details

DOMAIN_OF_VALIDITY_KEY

@Deprecated(since="3.1")
static final String DOMAIN_OF_VALIDITY_KEY

Deprecated.

Moved to ObjectDomain as of ISO 19111:2019.

Key for the "domainOfValidity" property to be given to the ObjectFactory.createFoo(Map, ...) methods.

See Also:

• ObjectFactory
• ObjectDomain.getDomainOfValidity()
• Constant Field Values

SCOPE_KEY

@Deprecated(since="3.1")
static final String SCOPE_KEY

Deprecated.

Moved to ObjectDomain as of ISO 19111:2019.

Key for the "scope" property to be given to the ObjectFactory.createFoo(Map, ...) methods.

See Also:

• ObjectFactory
• ObjectDomain.getScope()
• Constant Field Values

Method Details

getDomainOfValidity

@Deprecated(since="3.1")
@UML(identifier="SC_CRS.domainOfValidity",
     obligation=OPTIONAL,
     specification=ISO_19111,
     version=2007)
default Extent getDomainOfValidity()

Deprecated.

Replaced by IdentifiedObject.getDomains() as of ISO 19111:2019.

Area or region or timeframe in which this (coordinate) reference system is valid.

Returns:

the reference system valid domain, or null if not available.

getScope

@Deprecated(since="3.1")
@UML(identifier="SC_CRS.scope",
     obligation=OPTIONAL,
     specification=ISO_19111,
     version=2007)
default InternationalString getScope()

Deprecated.

Replaced by IdentifiedObject.getDomains() as of ISO 19111:2019.

Description of domain of usage, or limitations of usage, for which this Reference System object is valid.

Returns:

the domain of usage, or null if none.