zenkhas / hypertrack-placeline-android

Build placeline in your app

Placeline

Placeline is useful in tracking your daily activity. We automagically use the combination of device sensors - GPS, WiFi, network, accelerometer, pedometer, gyroscope, compass - to deliver accurate movement data (location + activity) with near-zero battery usage. Placeline is powered by the HyperTrack SDK which collects location and activity data for your users. It includes segments like stop 🛑, walk 🚶‍♀️,run 🏃‍♀️,drive 🏎️ and cycle 🚴.

Developers also use Placeline to record & visualize movement of their sales team, delivery & service fleet, and on-ground operations team. It helps them provide visibility when their workforce is out in the field.

Use this open source repo of the Hypertrack Placeline app to build Placeline within your app within a few hours. The repo uses HyperTrack APIs and SDKs.

In case you are using iOS, refer to our open source iOS repository.

• Clone the repo
• Build placeline within your app
• Release to playstore
• Dependencies
• Documentation
• Contribute
• Support

Clone the repo

1. Clone this repository

$ git clone https://github.com/hypertrack/hypertrack-placeline-android.git

2. Signup to get your HyperTrack API keys(Publishable key).

   Create two new files with name key.properties one at app/src/release/java/io/hypertrack/placeline/ and second at app/src/debug/java/io/hypertrack/placeline/.

   Add this content to above created file.

       HYPERTRACK_PUBLISHABLE_KEY="ADD_YOUR_PUBLISHABLE_KEY_HERE"

   Now replace ADD_YOUR_PUBLISHABLE_KEY_HERE with the publishable key.

HyperTrack.initialize(this.getApplicationContext(), BuildConfig.HYPERTRACK_PK);

3. To track your users through the day, set up a rule that auto-creates an action at the start of the day and auto-completes it at the end of the day. Visit HyperTrack Dashboard settings to set up the rule.

4. Get the Google Maps API key and add it to api-keys.xml.

Build within your app

Follow this step-by-step tutorial to track your users through the day, and show a placeline view within your app.

Release to Playstore

Following these steps to release the app on the Play Store.

1. Change the package name in the AndroidManifest.xml file.

2. Refactor the name of your package. Right click → Refactor → Rename in the tree view. Android Studio will display a window. Select "Rename package" option.

3. Change the application id in build.gradle file. Once done, clean and rebuild the project.

   • Add release key store file in app level folder.
   • Create a keystore.properties file in root or project level folder with key-values pair.

       storeFile=<File path of keystore file>
       storePassword=<Key Store Password>
       keyAlias=<Key Alias>
       keyPassword=<Key Password>

Dependencies

• Google v7 appcompat library
• Google Design Support Library
• Google libphonenumber library
• Square Retrofit
• Square Picasso
• Android Ripple Background
• Scrolling Image View
• RecylcerView Snap
• Leak Canary
• Crashlytics

Documentation

For detailed documentation of the HyperTrack APIs and SDKs, customizations and what all you can build using HyperTrack, please visit the official docs.

Contribute

Feel free to clone, use, and contribute back via pull requests. We'd love to see your pull requests - send them in! Please use the issues tracker to raise bug reports and feature requests.

We are excited to see what live location feature you build in your app using this project. Do ping us at [e-mail] once you build one, and we would love to feature your app on our blog!

Support

Join our Slack community for instant responses. You can also email us at [e-mail].