🔍 The GraphHopper Geocoding API wrapped in an easy-to-use Swift framework.
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
GraphHopperGeocoder.playground
GraphHopperGeocoder.xcodeproj
GraphHopperGeocoder
GraphHopperGeocoderTests
images 📝 update readme with license and about section May 5, 2017
.gitignore
GraphHopperGeocoder.podspec :config: fix version for source May 11, 2017
LICENSE
README.md

README.md

GraphHopperGeocoder

🔍 The GraphHopper Geocoding API wrapped in an easy-to-use Swift framework.

The Geocoding API is part of the GraphHopper Directions API. Geocoding is the process of finding an address for your geo location or a coordinate for an address. With our API you have a fast and solid way to geocode.

Installation

Use CocoaPods to install the framework. Add this to your Podfile:

pod 'GraphHopperGeocoder'

Then run the following command:

$ pod install

In order to use the framework, you'll also need a GraphHopper Access Token. You can either set your access token in the Info.plist (Key is GraphHopperAccessToken) or pass it as an argument to the initializer of the Geocoder class.

Example

Basics

Setup the Geocoder class

import CoreLocation
import GraphHopperGeocoder

// use this
let geocoder = Geocoder(accessToken: "YOUR ACCESS TOKEN")
// or if you have set your access token in the Info.plist
let geocoder = Geocoder()

Forward geocoding options

Configure the forward geocoding options

let options = ForwardGeocodeOptions(query: "HSR Rapperswil")
options.limit = 3

Reverse geocoding options

Configure the reverse geocoding options

let coordinate = CLLocationCoordinate2D(latitude: 47.222943, longitude: 8.817238649765951)
let options = ReverseGeocodeOptions(coordinate: coordinate)

Geocode request

Make the async request by calling the calculate(_:completionHandler) method and passing the options.

let task = geocoder.geocode(options, completionHandler: { (placemarks, error) in
    placemarks?.forEach({ placemark in
        print(placemark.name)
        print("\(placemark.coordinate.latitude), \(placemark.coordinate.longitude)")
        print(placemark.street)
        print(placemark.postalCode)
        print(placemark.city)
        print(placemark.state)
        print(placemark.country)
    })
})

More Information

For more information, consider reading the official documentation to learn more about the options and the result.

License

This project is released under the MIT license.

About

​The GraphHopper Geocoder Swift Framework is crafted with ❤️ by @rmnblm and @iphilgood during the Bachelor thesis at HSR University of Applied Sciences in Rapperswil.