TUM/2015/android

Display a notification on the headunit

In this task you have to create an android application which will use a geofence and the current location data in order to open/close a popup on the headunit.

Receive the current location

Use the android location manager to request location updates. If the location is retrieved correctly, then the following test will pass.

GeofenceAppTest.shouldReceiveTheLatestLocation()

Bind to a remote service to be able to display notifications

Use the AIDL to allow interprocess communication between your app and another service which will allow you to display notifications. The AIDL you will use is HeadUnit.aidl. You are on the client side. You will need to bind to the service using an intent and a ServiceConnection object (see here).

Intent headUnitServiceIntent = new Intent(HeadUnit.class.getName());
headUnitServiceIntent.setPackage("com.esrlabs.headunitservice");
bindService(headUnitServiceIntent, serviceConnection_object, BIND_AUTO_CREATE);

Implement a circle geofence object to tell if the current is inside a designated area or not

The first step is to implement a circle geofence. You cannot use the google API because that is part of the play API, and it is not supported by our android controller. You have included in the test suite a test class for the circle geofence to help you.

The second step is to display a popup if the current location is outside of a given geofence (alternatively to close if the location is inside). If this is correctly implemented than all the tests should be green (Note that unless you are going for the bonus you should disable the test in the PolygonGeofenceTest class with @Ignore in front of the @Test).

For the circle geofence you should use this location as the center and radius of :

(48.262596, 11.668720) and radius of 25 meters

Observations

In order to ease testing dependancy injection has been used. That means to pass the objects our class will use via a constructor. In android, services are not constructed by the user, instead they are built internally. The needed things for the service to run are instantated during the onCreate() call. The constructor in the code is there just for testing purposes. For the functioning of the service you should do the following:

if (locationManager == null) {
  locationManager = (LocationManager)
  this.getSystemService(Context.LOCATION_SERVICE);
}

and

if (geofence == null) {
  geofence = myGeofence(...);
}

Bonus Implement a polygon geofence instead

You can use the Ray-casting algorithm.

HINT

Use the slope of a straight line in order to tell if the ray starting from the given point and going in a fixed direction, intersects an edge of the polygon. Take care that Math.atan() return radians, and you will have to correct a negative angle:

90 + (90 - Math.abs(angle))

For the polygon geofence you should use the following locations as the polygon's cornerns:

(48.262739, 11.668393), (48.262674, 11.668956), (48.262100, 11.668419), (48.262324, 11.670174)