Distance Picker
===============

[![Build Status](https://travis-ci.org/qmathe/DistancePicker.svg?branch=master)](https://travis-ci.org/qmathe/DistancePicker)
[![Platforms iOS](https://img.shields.io/badge/Platforms-iOS-lightgray.svg?style=flat)](http://www.apple.com)
[![Language Swift 4](https://img.shields.io/badge/Language-Swift%204.2-orange.svg?style=flat)](https://swift.org)
[![License MIT](https://img.shields.io/badge/license-MIT-blue.svg?style=flat)](https://github.com/qmathe/DistancePicker/LICENSE)

DistancePicker is a custom UIKit control to select a distance with a pan gesture. It looks like a ruler with multiple distance marks and can be used to resize a map, set up a geofence or choose a search radius.

<img src="http://www.placeboardapp.com/images/Add%20Place%20with%20Search%20Radius%20-%20iPhone%205.jpg" height="700" alt="Screenshot" />

To see in action, take a look at [Placeboard](http://www.placeboardapp.com) demo video.

Compatibility
-------------

DistancePicker requires at least Xcode 9 and supports iOS 8 or higher.

| Swift   | DistancePicker                                                                                                                                                                                                                     |
| ------- |  -------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 5         | [0.8.4](https://github.com/qmathe/DistancePicker/releases/tag/0.8.4) or master                                                                                                               |
| 4.2      | [0.8.3](https://github.com/qmathe/DistancePicker/releases/tag/0.8.3) or branch [swift-4.2](https://github.com/qmathe/DistancePicker/tree/swift-4.2) |
| 4.X      | [0.8.2](https://github.com/qmathe/DistancePicker/releases/tag/0.8.2) or branch [swift-4.1](https://github.com/qmathe/DistancePicker/tree/swift-4.1) |
| 3.X      | [0.8.1](https://github.com/qmathe/DistancePicker/releases/tag/0.8.1) or branch [swift-3.2](https://github.com/qmathe/DistancePicker/tree/swift-3.2) |


Installation
------------

### Carthage

Add the following line to your Cartfile, run  `carthage update` to build the framework and drag the built DistancePicker.framework into your Xcode project.

    github "qmathe/DistancePicker"
	
### CocoaPods

Add the following lines to your Podfile and run `pod install` with CocoaPods 0.36 or newer.

	use_frameworks!
	
	pod "DistancePicker"

### Manually

If you don't use Carthage or CocoaPods, it's possible to drag the built framework or embed the source files into your project.

#### Framework

Build DistancePicker framework and drop it into your Xcode project.

#### Files

Drop DistancePicker.swift into your Xcode project and link MapKit.