MapQuest Observer

package com.mapquest.tracking.example;

import android.app.Application;

import com.mapquest.tracking.AdditionalObservationProvider;
import com.mapquest.tracking.LocationTracker;

import java.util.Collections;
import java.util.Map;
import java.util.concurrent.TimeUnit;

public class ExampleTrackingApplication extends Application {
    @Override
    public void onCreate() {
        super.onCreate();

        initializeTracker();
    }

    private void initializeTracker() {
        new LocationTracker.Builder(this, "") // TODO Update with your access key
                .withActiveLocationUpdatesDuringPassiveListening(TimeUnit.SECONDS.toMillis(15), true)
                .withPassiveListeningMinimumLocationUpdateIntervalDuration(TimeUnit.MINUTES.toMillis(3))
                .withPassiveListeningMinimumLocationUpdateDistance(0)
                .withProperty("deliveryNumber", 1L)
                .withProperty("driverEmployeeId", "ABC123")
                .withAdditionalObservationProvider(new AdditionalObservationProvider() {
                    @Override
                    public Map<String, Double> getAdditionalObservationData() {
                        return Collections.singletonMap("temperature", 23.4);
                    }
                }).buildAndInitialize();
    }
}

package com.mapquest.tracking.example;

import android.os.Bundle;
import android.support.v7.app.AppCompatActivity;
import android.view.WindowManager;
import android.widget.CompoundButton;
import android.widget.CompoundButton.OnCheckedChangeListener;
import android.widget.Toast;
import android.widget.ToggleButton;

import com.mapquest.tracking.LocationTracker;
import com.mapquest.tracking.LocationTracker.TrackingStateListener;

public class MainActivity extends AppCompatActivity {
    private ToggleButton mTrackingToggle;
    private TrackingStateListener mTrackingStateListener;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);

        setContentView(R.layout.activity_main);
        mTrackingToggle = (ToggleButton)findViewById(R.id.trackingToggle);

        mTrackingStateListener = buildTrackingStateListener();
    }

    @Override
    protected void onStart() {
        super.onStart();

        // Update toggle to reflect whether tracking is in progress
        mTrackingToggle.setChecked(LocationTracker.getInstance().isTracking());

        mTrackingToggle.setOnCheckedChangeListener(new OnCheckedChangeListener() {
            @Override
            public void onCheckedChanged(CompoundButton toggle, boolean checked) {
                if (checked) {
                    startTracking();
                } else {
                    stopTracking();
                }
            }
        });

        LocationTracker.getInstance().addTrackingStateListener(mTrackingStateListener);
    }

    @Override
    protected void onStop() {
        // Because LocationTracker exists as a singleton, if you use TrackingStateListeners, be sure
        // to unregister any that might leak a reference to something like an Activity.
        LocationTracker.getInstance().removeTrackingStateListener(mTrackingStateListener);

        // Clear listener
        mTrackingToggle.setOnCheckedChangeListener(null);

        super.onStop();
    }

    private void startTracking() {
        LocationTracker.getInstance().startTrackingActively();

        // Keep the screen on while tracking
        getWindow().addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON);
    }

    private void stopTracking() {
        LocationTracker.getInstance().stopTracking();

        // Allow the screen to turn off again
        getWindow().clearFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON);
    }

    private TrackingStateListener buildTrackingStateListener() {
        return new TrackingStateListener() {
            @Override
            public void onTrackingStopped(final boolean userInitiated) {
                if(!userInitiated) {
                    runOnUiThread(new Runnable() {
                        @Override
                        public void run() {
                            mTrackingToggle.setChecked(false);
                            mTrackingToggle.setEnabled(false); // No use in letting a user try again if their key wasn't valid.

                            Toast.makeText(MainActivity.this,
                                    R.string.tracking_disabled_message,
                                    Toast.LENGTH_LONG).show();
                        }
                    });
                }
            }
        };
    }
}

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.mapquest.tracking.example">

    <application
        android:name=".ExampleTrackingApplication"
        android:label="@string/app_name"
        android:theme="@style/AppTheme">

        <activity
            android:name=".MainActivity"
            android:label="@string/app_name">

            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>

        <receiver android:name="com.mapquest.tracking.core.receiver.ActiveLocationUpdateAlarmReceiver"
            android:exported="false"
            android:enabled="false">
            <intent-filter>
                <action android:name="com.mapquest.tracking.intent.action.REQUEST_ACTIVE_LOCATION_UPDATE" />
                <category android:name="com.mapquest.tracking.example" />
            </intent-filter>
        </receiver>

        <receiver android:name="com.mapquest.tracking.core.receiver.LocationReportingAlarmReceiver"
            android:exported="false"
            android:enabled="false">
            <intent-filter>
                <action android:name="com.mapquest.tracking.intent.action.REPORT_LOCATIONS" />
                <category android:name="com.mapquest.tracking.example" />
            </intent-filter>
        </receiver>
    </application>
</manifest>