Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/intere/geotrackkit

A Cocoapod for Geo Tracking.
https://github.com/intere/geotrackkit

cocoapods framework geo-tracking geolocation ios location location-services swift swift4 swift4-2 tracking

Last synced: 3 months ago
JSON representation

A Cocoapod for Geo Tracking.

Awesome Lists containing this project

README

        

![GeoTrackKit Logo](https://github.com/intere/GeoTrackKit/blob/develop/images/[email protected]?raw=true)
### An iOS Library for Geo Tracking

## Features
- Handles user authorization
- Handles track creation
- Handles track analyzing (for ascents, descents and other stats)
- Custom MKMapKit control for plotting your tracks on a map
- Pull tracks in from HealthKit (Activity App)
- `NOTE:` This is an iOS 11+ only feature and requires a physical device to test
- This capability is in a subspec: `HealthKit`
- Example App to demonstrate capabilities

## Project Status
This project is currently a work in progress.

[![Build Status](https://travis-ci.com/intere/GeoTrackKit.svg?branch=develop)](https://travis-ci.com/intere/GeoTrackKit)
[![Documentation](https://cdn.rawgit.com/intere/GeoTrackKit/master/docs/badge.svg)](https://intere.github.io/GeoTrackKit/docs/index.html)
[![Platform](https://img.shields.io/cocoapods/p/GeoTrackKit.svg)](http://cocoadocs.org/docsets/GeoTrackKit)
[![CocoaPods](https://img.shields.io/cocoapods/v/GeoTrackKit.svg)](https://cocoapods.org/pods/GeoTrackKit)
[![CocoaPods](https://cocoapod-badges.herokuapp.com/l/GeoTrackKit/badge.svg)](https://cocoapods.org/pods/GeoTrackKit)

### Initial Roadmap
- [x] Pull tracks from HealthKit (workouts)
- [x] CocoaPods support
- [x] Continuous integration (Travis CI)
- [x] Function documentation
- [x] Jazzy docs
- [x] SwiftLint integration
- [ ] Carthage support
- [ ] Swift Package Manager support
- [ ] Performance tests
- [ ] 90% Code coverage
- [ ] Danger support

### Example App
TODO:
- [x] Save tracks to disk
- [x] Provide a track list
- [x] Pull tracks in from HealthKit

### Installation

## Installation Instructions

### CocoaPods

Release from Cocoapods:
```ruby
pod 'GeoTrackKit'
```

Directly from Github:
```ruby
pod 'GeoTrackKit', :git => '[email protected]:intere/GeoTrackKit.git', :branch => 'develop'
```

## Example Usage

```
// This will either start tracking, or prompt the user for access to track their location
GeoTrackManager.shared.startTracking(type: .whileInUse)
```

This library also includes a map control that will map the GeoTrack:

## Inspiration
I've built a couple of variations of Geo Tracking applications, but I wanted to build a library for the community that I can share and get feedback and build better products.

## Created and maintained by
[Eric Internicola](http://intere.github.io)

## Key Classes

## Documentation
See the generated API Documentation in the [`docs`](https://intere.github.io/GeoTrackKit/docs/) folder
See the [GeoTrackKit Wiki](https://github.com/intere/GeoTrackKit/wiki)

## Credits / Attribution
- [Example App Icon](https://www.flaticon.com/free-icon/world-location_52177#term=globe&page=1&position=68)
-

Icons made by Freepik from www.flaticon.com is licensed by CC 3.0 BY

- [Terminal icon](https://www.flaticon.com/free-icon/terminal-server-session_523#term=terminal&page=1&position=60)
-
Icons made by Freepik from www.flaticon.com is licensed by CC 3.0 BY

- [Location on map icon](https://www.flaticon.com/free-icon/location-on-map_106165#term=gps&page=1&position=33)
-
Icons made by Freepik from www.flaticon.com is licensed by CC 3.0 BY

- [Map Location free icon](https://www.flaticon.com/free-icon/map-location_149985#term=gps&page=1&position=24)
-
Icons made by Smashicons from www.flaticon.com is licensed by CC 3.0 BY