ttomasini/TUM
0
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

Update documentation for the android task

Browse source
This commit is contained in:
Andrei Bechet 2015-06-26 10:29:17 +02:00
parent 6b60ef8025
commit 13643cd6f0
1 changed files with 19 additions and 3 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

22
2015/android/README.md
View file

@ -7,12 +7,12 @@ In this task you have to create an android application which will use a geofence
Use the [android location manager](http://developer.android.com/reference/android/location/LocationManager.html) to request location updates. If the location is retrieved correctly, then the following test will pass. Use the [android location manager](http://developer.android.com/reference/android/location/LocationManager.html) to request location updates. If the location is retrieved correctly, then the following test will pass.
```java ```java
shouldReceiveTheLatestLocation() GeofenceAppTest.shouldReceiveTheLatestLocation()
``` ```
## Bind to a remote service to be able to display notifications ## Bind to a remote service to be able to display notifications
Use the [AIDL](http://developer.android.com/guide/components/aidl.html) 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 a **ServiceConnection** object ([like here](http://developer.android.com/guide/components/aidl.html#Expose)). Use the [AIDL](http://developer.android.com/guide/components/aidl.html) 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 a [ServiceConnection](http://developer.android.com/reference/android/content/ServiceConnection.html) object (like [here](http://developer.android.com/guide/components/aidl.html#Expose)).
```java ```java
Intent headUnitServiceIntent = new Intent(HeadUnit.class.getName()); Intent headUnitServiceIntent = new Intent(HeadUnit.class.getName());
@ -20,6 +20,22 @@ headUnitServiceIntent.setPackage("com.esrlabs.headunitinterface");
bindService(headUnitServiceIntent, serviceConnection_object, BIND_AUTO_CREATE); bindService(headUnitServiceIntent, serviceConnection_object, BIND_AUTO_CREATE);
``` ```
## Implement a geofence object to tell if the current is inside a designated area or not ## 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).
## **Bonus** Implement a polygon geofence instead
You can use the [Ray-casting algorithm](https://en.wikipedia.org/wiki/Point_in_polygon).
#### 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:
```java
90 + (90 - Math.abs(angle))
```