org.opengis.geometry.coordinate
Interface Position

All Known Subinterfaces:

DirectPosition, Point

@UML(identifier="GM_Position",
     specification=ISO_19107)
public interface Position

A type consisting of either a direct position or of a point from which a direct position shall be obtained. The use of this data type allows the identification of a position either directly as a coordinate (variant direct) or indirectly as a point (variant indirect).

Since:

GeoAPI 1.0

Version:

ISO 19107

Departure from ISO specification:

ISO 19111 defines Position like a C/C++ union of DirectPosition and Point. Since unions are not allowed in Java, GeoAPI defines Position as the base interface of the above. This leads to a slightly different semantic since ISO defines getDirectPosition() as conditional, while GeoAPI defines it as mandatory by allowing the method to return this.

Method Summary

DirectPosition	getDirectPosition() Returns the direct position.
DirectPosition	getPosition() Deprecated. Renamed as getDirectPosition() for avoiding ambiguity.

Method Detail

getPosition

@Deprecated
@UML(identifier="direct",
     obligation=CONDITIONAL,
     specification=ISO_19107)
DirectPosition getPosition()

Deprecated. Renamed as getDirectPosition() for avoiding ambiguity.

Returns:

The direct position.

getDirectPosition

@UML(identifier="direct",
     obligation=CONDITIONAL,
     specification=ISO_19107)
DirectPosition getDirectPosition()

Returns the direct position. This method shall never returns null, but may returns this if invoked on an object which is already a DirectPosition instance.

Returns:

The direct position (may be this).

Since:

GeoAPI 2.2