Upgrade from ISO 19111:2007 to 19111:2019

[desruisseaux]

Upgrade Java interfaces in the org.opengis.referencing package and sub-packages in conformance with 2019 revision of ISO 19111. The Python interfaces added by #55 may need to be upgraded as well.

[desruisseaux]

Omitted types and properties

The following elements were intentionally omitted because they overlap with Java standard API or other API:

• GeodeticCS, EngineeringCS and DerivedProjectedCS interfaces:
  omitted because they are union rather than interfaces.
• DerivedGeodeticCRS, DerivedGeographicCRS, DerivedVerticalCRS, DerivedParametricCRS, DerivedTemporalCRS, DerivedEngineeringCRS and DerivedProjectedCRS interfaces:
  replaced by multi-inheritance of interfaces in the implementer classes.
• TemporalMeasureCS, DateTimeTemporalCS, TemporalCountCS and OrdinalCS interfaces:
  omitted because they duplicate the TemporalCS.coordinateType property.
• TemporalDatum.calendar property:
  replaced by use of java.time API in the origin property.
• Calendar code list:
  omitted as a consequence of above replacement.
• DataEpoch interface:
  replaced by the java.time.Temporal interface.
• DefiningParameter interface:
  omitted because GeoAPI tries to use a unified parameter API.
• GeographicObject interface:
  we suggest to use org.opengis.geometry.Geometry instead, but this is not mandated by the API.

The following elements were omitted because we are not sure what is best way to integrate them. However, those elements will need to be integrated somehow in a future version:

• GeodeticCRS.definingTransformation
• GeodeticCRS.velocityModel
• VerticalCRS.geoidModel
• VerticalCRS.velocityModel

Non-conform types and properties

The following interfaces need to be renamed. This is not yet done for compatibility reason. A possible strategy would be to rename them in GeoAPI 4 only.

• TimeCS → TemporalCS.
• GeodeticDatum → GeodeticReferenceFrame
• VerticalDatum → VerticalReferenceFrame

The following are departures from ISO 19111:2019. Since they may need discussion in CRS SWG, it may be safer to omit then in a GeoAPI release:

• DynamicGeodeticReferenceFrame and DynamicVerticalReferenceFrame replaced by a single DynamicReferenceFrame interface.
• ObjectUsage interface omitted in favor of moving the domain property into IdentifiedObject.
• Datum.publicationDate property type set to ISO 19115 CitationDate instead of Date.