opengeospatial / geoapi

GeoAPI provides a set of interfaces in programming languages (currently Java and Python) for geospatial applications. The GeoAPI interfaces closely follow OGC specifications, adaptated to match the expectations of programmers.
http://www.geoapi.org
Apache License 2.0
118 stars 37 forks source link

Partial replacement of ISO 19108 by `java.time` API #94

Closed desruisseaux closed 4 months ago

desruisseaux commented 4 months ago

The following interfaces were derived from ISO 19108:2002 (Temporal Schema), but only empty place-holders were released in GeoAPI 3.0. Since that time, the Java standard library got a new java.time package. Given that ISO 19108 has not been used a lot in GeoAPI and that the java.time package is quite advanced, the Java profile of GeoAPI should use the standard Java library instead of ISO 19108 when a correspondence exists. The following mapping can apply:

ISO identifier GeoAPI interface (Java) Java standard API
TM_Duration org.opengis.temporal.Duration java.time.temporal.TemporalAmount
TM_IntervalLength org.opengis.temporal.IntervalLength java.time.Duration
TM_PeriodDuration org.opengis.temporal.PeriodDuration java.time.Period

The following sub-sections compare the ISO and Java specifications:

TM_Duration → TemporalAmount

TM_IntervalLength → Duration

TM_PeriodDuration → Period

desruisseaux commented 4 months ago

This task is related to #79.

desruisseaux commented 4 months ago

The mapping has been documented in the package Javadoc and in Metanorma.