Skip to content

intere/GeoTrackKit

Repository files navigation

GeoTrackKit Logo

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 Documentation Platform CocoaPods CocoaPods

Initial Roadmap

  • Pull tracks from HealthKit (workouts)
  • CocoaPods support
  • Continuous integration (Travis CI)
  • Function documentation
  • Jazzy docs
  • SwiftLint integration
  • Carthage support
  • Swift Package Manager support
  • Performance tests
  • 90% Code coverage
  • Danger support

Example App

TODO:

  • Save tracks to disk
  • Provide a track list
  • Pull tracks in from HealthKit

Installation

Installation Instructions

CocoaPods

Release from Cocoapods:

pod 'GeoTrackKit'

Directly from Github:

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

Key Classes

Documentation

See the generated API Documentation in the docs folder See the GeoTrackKit Wiki

Credits / Attribution