https://github.com/rmnblm/graphhoppergeocoder
🔍 The GraphHopper Geocoding API wrapped in an easy-to-use Swift framework.
https://github.com/rmnblm/graphhoppergeocoder
geocoding graphhopper openstreetmap swift
Last synced: about 1 month ago
JSON representation
🔍 The GraphHopper Geocoding API wrapped in an easy-to-use Swift framework.
- Host: GitHub
- URL: https://github.com/rmnblm/graphhoppergeocoder
- Owner: rmnblm
- License: mit
- Created: 2017-04-27T07:15:16.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2017-05-11T15:51:58.000Z (about 9 years ago)
- Last Synced: 2025-03-04T11:40:16.258Z (over 1 year ago)
- Topics: geocoding, graphhopper, openstreetmap, swift
- Language: Swift
- Homepage: https://www.graphhopper.com
- Size: 49.8 KB
- Stars: 1
- Watchers: 2
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# GraphHopperGeocoder
[]()
[]()
[](https://github.com/cocoapods/cocoapods)
[](http://mit-license.org)
🔍 The GraphHopper Geocoding API wrapped in an easy-to-use Swift framework.
The Geocoding API is part of the [GraphHopper Directions API](https://graphhopper.com/#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](http://cocoapods.org/) to install the framework. Add this to your Podfile:
``` ruby
pod 'GraphHopperGeocoder'
```
Then run the following command:
```
$ pod install
```
In order to use the framework, you'll also need a [GraphHopper Access Token](https://graphhopper.com/dashboard/#/api-keys). 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
``` swift
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
``` swift
let options = ForwardGeocodeOptions(query: "HSR Rapperswil")
options.limit = 3
```
### Reverse geocoding options
Configure the reverse geocoding options
```swift
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.
```swift
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](https://graphhopper.com/api/1/docs/#geocoding-api) to learn more about the options and the result.
## License
This project is released under the [MIT license](LICENSE).
## About
The GraphHopper Geocoder Swift Framework is crafted with :heart: by [@rmnblm](https://github.com/rmnblm) and [@iphilgood](https://github.com/iphilgood) during the Bachelor thesis at [HSR University of Applied Sciences](https://www.hsr.ch) in Rapperswil.