76 lines
3.6 KiB
Markdown
76 lines
3.6 KiB
Markdown
# Prerequisites
|
|
|
|
To be able to develop for android and run it in the simulator, you will need the following:
|
|
|
|
- android studio
|
|
- latest android sdk
|
|
|
|
You can find both [here](https://developer.android.com/studio/index.html)
|
|
|
|
# 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](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
|
|
GeofenceAppTest.shouldReceiveTheLatestLocation()
|
|
```
|
|
|
|
## 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 an intent and a [ServiceConnection](http://developer.android.com/reference/android/content/ServiceConnection.html) object (see [here](http://developer.android.com/guide/components/aidl.html#Expose)).
|
|
|
|
```java
|
|
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:
|
|
|
|
```java
|
|
if (locationManager == null) {
|
|
locationManager = (LocationManager)
|
|
this.getSystemService(Context.LOCATION_SERVICE);
|
|
}
|
|
```
|
|
and
|
|
```java
|
|
if (geofence == null) {
|
|
geofence = myGeofence(...);
|
|
}
|
|
```
|
|
|
|
|
|
|
|
## **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))
|
|
```
|
|
|
|
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)
|