playground GeoLabels [ ↗ ]

{S}[B] Status [i]
proposed
Provenance
Used by
Contributors
Source (v2021-04-14)

Attributes

Type: object
Description: GeoLabels represent an instance of the GeoJSON properties object. The parameters provide additional information for the interpretation of the location parameters, and also serve for optional “sanity checks” off the corresponding latitude, longitude (, altitude).

Properties

PropertyType
ISO3166alpha3string
citystring
countrystring
labelstring
latitudenumber (float)
longitudenumber (float)
precisionstring

ISO3166alpha3

ISO3166alpha3 Value Examples
"USA"
"CHE"

city

The optional name of the city the point location maps to. While this is a commonly used the point location, it should be considered secondary to the location values in interpreting the geographic location.

country

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

country Value Example
"Switzerland"

label

label Value Examples
"Heidelberg, Germany"
"Gainesville, United States of America"
"Zurich, Switzerland"
"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.55

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. The precision parameter can be used to indicate an obfuscation of the coordinates, e.g. for privacy protection.

precision Value Example
"city"