holyturt / SwiftOverpassWrapper

A wrapper of the Overpass API for Swift.
MIT License
16 stars 2 forks source link

SwiftOverpass

This library aims to make a query for the Overpass API easily in Swift.

Usage

Let's say this is an Overpass XML collects nodes which have the key "name" that equals the value "Gielgen":

<osm-script>
  <query type="node">
    <bbox-query e="7.25" n="50.8" s="50.7" w="7.1"/>
    <has-kv k="name" v="Gielgen"/>
  </query>
  <print/>
</osm-script>

can be written like:

import SwiftOverpass

let query = NodeQuery()
query.setBoudingBox(s: 50.7, n: 50.8, w: 7.1, e: 7.25)
query.hasTag("name", equals: "Gielgen")

SwiftOverpass.api(endpoint: "http://overpass-api.de/api/interpreter")
  .fetch(query) { (response, error) in
    // do whatever you want
  }

Example

Overpass XML:

<union>
  <query type="node">
    <has-kv k="name" v="Schloss Neuschwanstein"/>
  </query>
  <recurse type="node-relation"/>
</union>
<print/>

Swift:

let nodeQuery = NodeQuery()
nodeQuery.hasTag("name", equals: "Schloss Neuschwanstein")
let relationQuery = nodeQuery.relation()

SwiftOverpass.api(endpoint: "http://overpass-api.de/api/interpreter")
  .fetch([nodeQuery, relationQuery]) { (response, error) in
    // do whatever you want
  }

Installation

CocoaPods:

pod 'SwiftOverpass'

Carthage:

github "holyturt/SwiftOverpassWrapper"

License

This software is freely distributable under the MIT License.