Name: w3w-swift-wrapper
Owner: what3words
Description: Swift library for what3words REST API.
Created: 2017-03-15 09:56:42.0
Updated: 2018-02-02 17:23:31.0
Pushed: 2017-03-22 12:28:12.0
Homepage: http://developer.what3words.com
Size: 21
Language: Swift
GitHub Committers
User | Most Recent Commit | # Commits |
---|
Other Committers
User | Most Recent Commit | # Commits |
---|
A swift library to use the what3words REST API.
The what3words Swift library gives you programmatic access to convert a 3 word address to coordinates (forward geocoding), to convert coordinates to a 3 word address (reverse geocoding), and to determine the currently support 3 word address languages.
To use this library you?ll need a what3words API key, which can be signed up for here.
You can use CocoaPods to install w3w-swift-wrapper
by adding it to your Podfile
:
form :ios, '8.0'
frameworks!
et 'MyApp' do
pod 'what3words', :git => 'https://github.com/what3words/w3w-swift-wrapper.git'
You can use Carthage to install w3w-swift-wrapper
by adding it to your Cartfile
:
ub "what3words/w3w-swift-wrapper"
You can use The Swift Package Manager to install w3w-swift-wrapper
by adding the proper description to your Package.swift
file:
rt PackageDescription
package = Package(
name: "YOUR_PROJECT_NAME",
targets: [],
dependencies: [
.Package(url: "https://github.com/what3words/w3w-swift-wrapper.git", versions: Version(1,0,0)..<Version(1, .max, .max)),
]
Note that the Swift Package Manager is still in early design and development, for more information checkout its GitHub Page
To use this library in your project manually just drag W3wGeocoder.swift to the project tree
Forward geocodes a 3 word address to a position, expressed as coordinates of latitude and longitude.
This function takes the words parameter as a string of 3 words 'table.book.chair'
The returned payload from the forwardGeocode
method is described in the what3words REST API documentation.
Reverse geocodes coordinates, expressed as latitude and longitude to a 3 word address.
This function takes the latitude and longitude as a CLLocationCoordinate2D object
The returned payload from the reverseGeocode
method is described in the what3words REST API documentation.
Returns a list of 3 word addresses based on user input and other parameters.
This method provides corrections for the following types of input error:
The autoSuggest
method determines possible corrections to the supplied 3 word address string based on the probability of the input errors listed above and returns a ranked list of suggestions. This method can also take into consideration the geographic proximity of possible corrections to a given location to further improve the suggestions returned.
You will only receive results back if the partial 3 word address string you submit contains the first two words and at least the first character of the third word; otherwise an error message will be returned.
We provide various clip
policies to allow you to specify a geographic area that is used to exclude results that are not likely to be relevant to your users. We recommend that you use the clip
parameter to give a more targeted, shorter set of results to your user. If you know your user?s current location, we also strongly recommend that you use the focus
to return results which are likely to be more relevant.
In summary, the clip
policy is used to optionally restrict the list of candidate AutoSuggest results, after which, if focus has been supplied, this will be used to rank the results in order of relevancy to the focus.
http://docs.what3words.local/api/v2/#autosuggest-clip
The returned payload from the autosuggest
method is described in the what3words REST API documentation.
Retrieves a list of the currently loaded and available 3 word address languages.
The returned payload from the languages
method is described in the what3words REST API documentation.
rt what3words
eocoder.setup(with: "<Secret API Key>")
eocoder.shared.forwardGeocode(addr: "index.home.raft") { (result, error) in
print(result)
coords = CLLocationCoordinate2D(latitude: 51.4243877, longitude: -0.34745)
eocoder.shared.reverseGeocode(coords: coords) { (result, error) in
print(result)
eocoder.shared.autosuggest(addr: "index.home.raft") { (result, error) in
print(result)
eocoder.shared.multilingualAutosuggest(addr: "index.home.raft") { (result, error) in
print(result)
eocoder.shared.voiceAutosuggest(json: <json>) { (result, error) in
print(result)
eocoder.shared.standardBlend(addr: "plan.clips.a", completion: { (result, error) in
print(result)
eocoder.shared.multilingualStandardBlend(addr: "plan.clips.a", completion: { (result, error) in
print(result)
eocoder.shared.voiceStandardBlend(json: <json>, completion: { (result, error) in
print(result)
eocoder.shared.languages { (result, error) in
print(result)