Geo URI

From Wikipedia, the free encyclopedia
Jump to: navigation, search

A 'geo' URI is a URI scheme defined by the Internet Engineering Task Force's RFC 5870 (published 8 June 2010)[1] as:

a Uniform Resource Identifier (URI) for geographic locations using the 'geo' scheme name. A 'geo' URI identifies a physical location in a two- or three-dimensional coordinate reference system in a compact, simple, human-readable, and protocol-independent way.[1]

The current revision of the vCard specification[2] supports 'geo' URIs in a vCard's "GEO" property, and the GeoSMS standard uses 'geo' URIs for geotagging SMS messages. Android based devices support 'geo' URIs,[3] although that implementation is based on a draft revision of the specification, and supports a different set of URI parameters and query strings.

A 'geo' URI is not to be confused with the site GeoUrl[4] (which implements ICBM address).

Example[edit]

A simple 'geo' URI might look like:

geo:37.786971,-122.399677

where the two numerical values represent latitude and longitude respectively,[1] and are separated by a comma.[1] If a third comma-separated value is present, it represents altitude.[1] The 'geo' URI also allows for an optional "uncertainty" value, separated by a semicolon, representing the uncertainty of the location in meters, and is described using the "u" URI parameter.[1] A 'geo' URI with an uncertainty parameter looks as follows:

geo:37.786971,-122.399677;u=35

A 'geo' URI may, for example, be included on a web page, as HTML:

<a href="geo:37.786971,-122.399677;u=35">Wikimedia Headquarters</a>

so that a 'geo' URI-aware user agent such as a web browser could launch the user's chosen mapping service; or it could be used in an Atom feed or other XML file.

Coordinate reference systems[edit]

The default coordinate reference system (CRS) used is the World Geodetic System 1984 (WGS-84),[1] for planet Earth although other CRS, once defined, may be specified, using the "crs" URI parameter,[5] also separated by a semicolon. Such CRSs may include both other terrestrial systems and those for non-terrestrial coordinates such as those on the Moon or Mars.

A 'geo' URI for a hypothetical lunar CRS created in 2011 might be:

geo:37.786971,-122.399677;crs=Moon-2011;u=35

The order in which the semicolon-separated parameters occur is partially significant.[1] Whilst the labeltext parameter and future parameters may be given in any order, the 'crs' and the 'u' parameters must come first. If both are used, the 'crs' must precede the 'u'.[1] All parameters are case-insensitive,[1] so the above example is exactly equivalent to:

geo:37.786971,-122.399677;crs=moon-2011;u=35

References[edit]

  1. ^ a b c d e f g h i j "RFC 5870 - A Uniform Resource Identifier for Geographic Locations ('geo' URI)". Internet Engineering Task Force. 2010-06-08. Retrieved 9 June 2010. 
  2. ^ "RFC 6350 - vCard Format Specification". Internet Engineering Task Force. 2011-08-11. Retrieved 19 Jun 2012. 
  3. ^ "Android Intents List". google.com. Retrieved 2012-06-19. 
  4. ^ "Geourl.org". Geourl.org. Retrieved 2011-12-24. 
  5. ^ RFC 5870, section 8.3

External links[edit]