GeoLocation ga4gh

{S}[B] Status [i]
proposed
Provenance
Used by
Contributors
Source (v0.0.1)

Attributes

Type: object
Description: Geo_location provides information about a geographic position related to a record. Examples could be:

The geographic point object uses the default units from the DCMI point scheme and avoids optional representation in non-standard units.

Properties

Property Type
altitude number (float)
city string
country string
label string
latitude number (float)
longitude number (float)
precision string

altitude

height in meters above the WGS 84 reference ellipsoid; optional

altitude Value Example
8848

city

The optional name of the city the point location maps to. While this is a commonly used attribute and can save as sanity check for interpreting the point location, it should be considered secondary to the location values in interpreting the geographic location.

city Value Examples
"Timisoara"
"Heidelberg"
"Zurich"

country

The optional name of the country the location maps to, for sanity checks and procedural convenience (see notes for “city”).

country Value Examples
"Romania"
"Albania"

label

A text representation, preferably using standard geographic identification elements, of the corresponding latitude, longitude, (altitude). This representation serves the purposes to

label Value Example
"Str Marasesti 5, 300077 Timisoara, Romania"

latitude

signed decimal degrees (North, relative to Equator)

latitude Value Example
47.37

longitude

signed decimal degrees (East, relative to IERS Reference Meridian)

longitude Value Example
8.54

precision

Used together with coordinate annotation, precision represents an optional label describing the precision that can be inferred from the coordinates. For a precision level of “city””, coordinates would have to be interpreted as representing any possible location within the city’s administrative boundaries, not necessarily at the exact position of the point coordinates.

precision Value Example
"address"

GeoLocation Value Examples

{
   "altitude" : "47",
   "city" : "Timisoara",
   "country" : "Romania",
   "label" : "Str Marasesti 5, 300077 Timisoara, Romania",
   "latitude" : "47.37",
   "longitude" : "8.54"
}
{
   "label" : "Office at Institute of Molecular Life Sciences, University of Zurich",
   "latitude" : "47.39792",
   "longitude" : "8.54913",
   "precision" : "room"
}