A Swift implementation of the geo URI scheme.

The geo URI scheme is a Uniform Resource Identifier (URI) scheme defined by the Internet Engineering Task Force's RFC 5870.

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.

iOS 16, macOS 10.13, tvOS 16, watchOS 9

This package is available via Swift Package Manager.

To install it, simply add the repo URL to your project in the usual way, and import GeoURI where needed.

A GeoURI type can be created from its constituent components (latitude, longitude, and an optional altitude), or from a URL that conforms the geo URI scheme.

There are also CoreLocation extension to initialize a GeoURI from a CLLocation or CLLocationCoordinate2D.

An error will be thrown if any of the properties do not meet the specification.

See the documentation for a complete reference.

import GeoURI

let geoURI = try? GeoURI(latitude: 48.2010, longitude: 16.3695, altitude: 183)
let urlString = geoURI?.url.absoluteString // "geo:48.201,16.3695,183?crs=wgs84"

import GeoURI

if let let url = URL(string: "geo:-48.876667,-123.393333") {
    let geoURI = try? GeoURI(url: url)
}

import GeoURI

let geoURI = try GeoURI("geo:48.201,16.3695", format: GeoURI.FormatStyle)

geoURI.formatted()      // "geo:48.201,16.3695"
geoURI.formatted(.full) // "geo:48.201,16.3695;crs=wgs84"

import CoreLocation
import GeoURI

let coordinate = CLLocationCoordinate2D(latitude: 48.2010, longitude: 16.3695)
let geoURI = try? GeoURI(coordinate: coordinate)
let urlString = geoURI?.url.absoluteString // "geo:48.2010,16.3695?crs=wgs84"

import GeoURI

if let url = URL(string: "geo:-48.876667,-123.393333") {
    do {
        let geoURI = try GeoURI(url: url)
    } catch GeoURIParsingError {
        print("A parsing error occurred: \(parsingError.errorDescription)")
    }
}

Documentation of this package is provided via a DocC documentation catalog.

The official specification of RFC 5870 is the canonical reference for the GeoURI scheme.

To build the documentation from the command-line:

$ swift package generate-documentation

Add the --help flag to get a list of all supported arguments and options.

You can also build the documentation directly in Xcode from the Product menu:

Product > Build Documentation

The documentation can then be viewed in the documentation viewer.

Contributions are welcome! Please feel free to submit a pull request or open an issue on the GitHub repository.

GeoURI is available under the Unlicense. See the LICENSE file for more info.