GlobeCoordinatesValue (Wikidata Toolkit Data Model 0.8.0 API)

All Superinterfaces:

Value

All Known Implementing Classes:

GlobeCoordinatesValueImpl, JacksonValueGlobeCoordinates
```
public interface GlobeCoordinatesValue
extends Value
```
Globe coordinates specify a position on some globe (usually Earth, but possibly also another celestial body, such as Mars).
Altitude is not supported in this value.
All numeric data in coordinates is represented by floating point numbers. The one general problem with any underlying number format is the conversion between degrees (with fraction) and a degrees-minute-second view, which will always lead to a loss in arithmetic precision that one has to live with.
Precision is measured in degrees, but must be a positive (non-zero) number.

Author:

Markus Kroetzsch

Field Summary

Fields
Modifier and Type	Field	Description
`static java.lang.String`	`GLOBE_EARTH`	IRI of the Earth.
`static java.lang.String`	`GLOBE_MOON`	IRI of the the Earth's Moon.
`static double`	`PREC_ARCMINUTE`	Precision constant for globe coordinates that are precise to the arcminute.
`static double`	`PREC_ARCSECOND`	Precision constant for globe coordinates that are precise to the arcsecond.
`static double`	`PREC_CENTI_ARCSECOND`	Precision constant for globe coordinates that are precise to the hundredth of an arcsecond.
`static double`	`PREC_CENTI_DEGREE`	Precision constant for globe coordinates that are precise to the hundredth of a degree.
`static double`	`PREC_DECI_ARCSECOND`	Precision constant for globe coordinates that are precise to the tenth of an arcsecond.
`static double`	`PREC_DECI_DEGREE`	Precision constant for globe coordinates that are precise to the tenth of a degree.
`static double`	`PREC_DEGREE`	Precision constant for globe coordinates that are precise to the degree.
`static double`	`PREC_HUNDRED_MICRO_DEGREE`	Precision constant for globe coordinates that are precise to the ten-thousandth of a degree.
`static double`	`PREC_MICRO_DEGREE`	Precision constant for globe coordinates that are precise to the millionth of a degree.
`static double`	`PREC_MILLI_ARCSECOND`	Precision constant for globe coordinates that are precise to the thousandth of an arcsecond.
`static double`	`PREC_MILLI_DEGREE`	Precision constant for globe coordinates that are precise to the thousandth of a degree.
`static double`	`PREC_TEN_DEGREE`	Precision constant for globe coordinates that are precise to ten degrees.
`static double`	`PREC_TEN_MICRO_DEGREE`	Precision constant for globe coordinates that are precise to the hundred-thousandth of a degree.

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method	Description
`java.lang.String`	`getGlobe()`	Get the IRI of the globe that these coordinates refer to.
`double`	`getLatitude()`	Get the latitude of this value in degrees.
`double`	`getLongitude()`	Get the longitude of this value in degrees.
`double`	`getPrecision()`	Get the precision of the value in degrees.

Methods inherited from interface org.wikidata.wdtk.datamodel.interfaces.Value
accept

- Field Detail
  - PREC_TEN_DEGREE
```
static final double PREC_TEN_DEGREE
```
    Precision constant for globe coordinates that are precise to ten degrees.
    
    See Also:
    
    Constant Field Values
  - PREC_DEGREE
```
static final double PREC_DEGREE
```
    Precision constant for globe coordinates that are precise to the degree.
    
    See Also:
    
    Constant Field Values
  - PREC_DECI_DEGREE
```
static final double PREC_DECI_DEGREE
```
    Precision constant for globe coordinates that are precise to the tenth of a degree.
    
    See Also:
    
    Constant Field Values
  - PREC_ARCMINUTE
```
static final double PREC_ARCMINUTE
```
    Precision constant for globe coordinates that are precise to the arcminute.
    
    See Also:
    
    Constant Field Values
  - PREC_CENTI_DEGREE
```
static final double PREC_CENTI_DEGREE
```
    Precision constant for globe coordinates that are precise to the hundredth of a degree.
    
    See Also:
    
    Constant Field Values
  - PREC_MILLI_DEGREE
```
static final double PREC_MILLI_DEGREE
```
    Precision constant for globe coordinates that are precise to the thousandth of a degree.
    
    See Also:
    
    Constant Field Values
  - PREC_ARCSECOND
```
static final double PREC_ARCSECOND
```
    Precision constant for globe coordinates that are precise to the arcsecond.
    
    See Also:
    
    Constant Field Values
  - PREC_HUNDRED_MICRO_DEGREE
```
static final double PREC_HUNDRED_MICRO_DEGREE
```
    Precision constant for globe coordinates that are precise to the ten-thousandth of a degree.
    
    See Also:
    
    Constant Field Values
  - PREC_DECI_ARCSECOND
```
static final double PREC_DECI_ARCSECOND
```
    Precision constant for globe coordinates that are precise to the tenth of an arcsecond.
    
    See Also:
    
    Constant Field Values
  - PREC_TEN_MICRO_DEGREE
```
static final double PREC_TEN_MICRO_DEGREE
```
    Precision constant for globe coordinates that are precise to the hundred-thousandth of a degree.
    
    See Also:
    
    Constant Field Values
  - PREC_CENTI_ARCSECOND
```
static final double PREC_CENTI_ARCSECOND
```
    Precision constant for globe coordinates that are precise to the hundredth of an arcsecond.
    
    See Also:
    
    Constant Field Values
  - PREC_MICRO_DEGREE
```
static final double PREC_MICRO_DEGREE
```
    Precision constant for globe coordinates that are precise to the millionth of a degree.
    
    See Also:
    
    Constant Field Values
  - PREC_MILLI_ARCSECOND
```
static final double PREC_MILLI_ARCSECOND
```
    Precision constant for globe coordinates that are precise to the thousandth of an arcsecond.
    
    See Also:
    
    Constant Field Values
  - GLOBE_EARTH
```
static final java.lang.String GLOBE_EARTH
```
    IRI of the Earth. Used frequently to specify the globe.
    
    See Also:
    
    Constant Field Values
  - GLOBE_MOON
```
static final java.lang.String GLOBE_MOON
```
    IRI of the the Earth's Moon.
    
    See Also:
    
    Constant Field Values
- Method Detail
  - getLatitude
```
double getLatitude()
```
    Get the latitude of this value in degrees. For Earth, the latitude value is generally the geographic latitude (as opposed to the geocentric latitude etc.). For other celestial bodies, the meaning of the latitude can vary. It is part of the semantics of the property to specify which coordinate system should be assumed for each globe (possibly depending on further information, such as qualifiers).
    
    Returns:
    
    latitude in degrees
  - getLongitude
```
double getLongitude()
```
    Get the longitude of this value in degrees. For celestial bodies other than Earth, the meaning of the longitude can vary. It is part of the semantics of the property to specify which coordinate system should be assumed for each globe (possibly depending on further information, such as qualifiers).
    
    Returns:
    
    longitude in degrees
  - getPrecision
```
double getPrecision()
```
    Get the precision of the value in degrees. This value indicates that both latitude and longitude might be off by that precision. Obviously, since the absolute distance of one degree may vary depending on the coordinates, this leads to a non-uniform notion of precision. For example, precision of one whole degree at coordinates 80N, 145E is a much smaller distance from the spot than the same precision at 10N, 145E.
    
    Returns:
    
    precision in degrees
  - getGlobe
```
java.lang.String getGlobe()
```
    Get the IRI of the globe that these coordinates refer to. In most cases this is GLOBE_EARTH.
    
    Returns:
    
    IRI of a globe.

Interface GlobeCoordinatesValue

Field Summary

Method Summary

Methods inherited from interface org.wikidata.wdtk.datamodel.interfaces.Value

Field Detail

PREC_TEN_DEGREE

PREC_DEGREE

PREC_DECI_DEGREE

PREC_ARCMINUTE

PREC_CENTI_DEGREE

PREC_MILLI_DEGREE

PREC_ARCSECOND

PREC_HUNDRED_MICRO_DEGREE

PREC_DECI_ARCSECOND

PREC_TEN_MICRO_DEGREE

PREC_CENTI_ARCSECOND

PREC_MICRO_DEGREE

PREC_MILLI_ARCSECOND

GLOBE_EARTH

GLOBE_MOON

Method Detail

getLatitude

getLongitude

getPrecision

getGlobe