souravm84 / cordova-background-geolocation-SampleApp

Cordova Background Geolocation Sample Application

🔷 [Ionic 3] Cordova Background Geolocation — Demo

Fully-featured Ionic-based sample-application for Cordova Background Geolocation

🔷 Installation

Step 1: Start by cloning this repo

$ git clone https://github.com/transistorsoft/cordova-background-geolocation-SampleApp.git

---

Step 2: Building and Running the Ionic 3 App

$ npm install

$ npm install -g cordova ionic # you should have ionic and cordova installed

$ ionic cordova prepare android
$ ionic cordova run android --device

$ ionic cordova prepare ios
$ ionic cordova run ios --emulator
// opens a web console which receives all your locations
$ npm run open  

The quickest way to see the plugin in-action is to boot the iOS simulator and simulate location with Freeway Drive.

The demo is composed of three separate and indpendant sub-applications implemented as Ionic page-modules.

• Hello World
• Simple Map
• Advanced with complex settings screen and geofencing.

🔷 Tracking Server

The demo app is configured to post locations to Transistor Software's demo server, which hosts a web-application for visualizing and filtering your tracking on a map.

• After booting the app the first time, you'll be asked to enter a unique "Tracking Server Username" (eg: Github username) so the plugin can post locations to tracker.transistorsoft.com.

⚠️ Make your username unique and known only to you — if every one uses "test", you'll never find your device!)

• You can view the plugin's tracking history by visiting http://tracker.transistorsoft.com/username.

🔷 Debug Mode

The plugin has a debug mode for field-testing. The plugin will emit sounds during its life-cycle events:

Event	iOS	Android
Exit stationary-region	Dee-do Dee-do...Dee-do Dee-do	n/a
Location recorded	SMS-sent sound	"blip"
Aggressive geolocation engaged	SIRI listening sound	"doodly-doo"
Acquiring location	"tick, tick, tick"	dial-tone sound
Stationary state	"bloom"	long "beeeeeeep"
Geofence crossing	trumpets/fanfare	beep-beep-beep

NOTE: In order for debug sounds to operate when the app is in background, you must enable the Audio and Airplay Background Mode.

🔷 Adding Geofences

The Advanced app implements a longtap event on the map. Simply tap & hold the map to initiate adding a geofence.

Enter an identifier, radius, notifyOnExit, notifyOnEntry.