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

https://github.com/map-ir/mapir-ios-tracker

Map.ir iOS SDK for live tracking service.
https://github.com/map-ir/mapir-ios-tracker

Last synced: 12 months ago
JSON representation

Map.ir iOS SDK for live tracking service.

Awesome Lists containing this project

README

          


Map.ir Logo



Swift 5.1




Carthage Compatible

# MapirLiveTracker

## Features

- Map.ir Live Tracker uses MQTT protocol which has low data usage.
- Easy configuration.
- Complete and expressive documentation.
- You can use both Swift and Objective-C languages.

## Example

The example applications are the best way to see `MapirLiveTracker` in action. Simply open the `MapirLiveTracker.xcodeproj` and run the `Swift Example` scheme.
There is also an Objective-C Example that is still being developed.

## Installation

### CocoaPods
This SDK will be available on CocoaPods soon.

### Carthage

[Carthage](https://github.com/Carthage/Carthage) is a decentralized dependency manager that builds your dependencies and provides you with binary frameworks.

To integrate MapirLiveTracker into your Xcode project using Carthage, specify it in your `Cartfile`:

```ogdl
github "map-ir/mapir-ios-tracker"
```

Run `carthage update` to build the framework and drag the built `MapirLiveTracker.framework` into your Xcode project.

On your application targets’ “Build Phases” settings tab, click the “+” icon and choose “New Run Script Phase” and add the Framework path as mentioned in [Carthage Getting started Step 4, 5 and 6](https://github.com/Carthage/Carthage/blob/master/README.md#if-youre-building-for-ios-tvos-or-watchos)

## Usage

1. Add your API Key to Info.plist with `MAPIRAccessToken` key or simply use Publisher/Subscriber initializers with accessToken argument.
2. use `start(withTrackingIdentifier:)` and pass in your tracking identifier.

## Contributing
Contributions are very welcome 🙌

## License
License is available in LICENSE file.