ruleant / getback_gps Goto Github PK

Replace the refresh text in the menu with the Android refresh icon

info like, status of the provider, number of sattelites (in case of GPS)

Use the remembered last location if it is better/more recent than the current location, regardless of the active location provider.

Create a better app icon, fe. a spindle of wire

Find out how to store a location (or multiple ones) persistently, even after the app is restarted.

Rotating an image is only available from SDK API level 11, use prerotated images instead, or draw a dynamic pointer on screen.

'How to use' page :

• On wiki
• In the app (separate help page? Integrated in About Activity?)

• adjust AriadneLocation to have a name
• adjust StoredLocation to also save a location name
• Ask for a name when storing a location
• display the location/destination name in the interface
  • in DetailsActivity : AriadneLocation.toFormattedString()
  • in MainActivity
• rearrange MainActivity layout
• limit number of characters displayed, to avoid messing up the layout
• change name of a stored location #162

display Action asking for confirmation : 'Are you sure you want to store this location?'

When only relying on the location data (GPS/network), the actual bearing can be inaccurate, f.e. when you turn around, the change in bearing will only be apparent by the GPS location after having moved in the new direction.
Using internal gyroscope and/or electronic compass, the current bearing can be detected faster and more accurately.

TODO :

• LocationService is not unregistered when Activity loses focus.
• add unit tests for Navigator class
• add unit tests for Orientation Tools and LowPassFilter classes
• finetune updateRate (currently set to 200 ms), to avoid too much CPU activity -> limit number of updates
• only update UI when a new rotation value is calculated.
• filter accelerator/gravity sensors, using a low-pass filter, see Accelerometer Example
• calculate average value of last x orientation values, to make value less 'jumpy', see #147
• implement hasOrientation
• update check for inaccurateBearing : accurate, if hasOrientation is true
• if present, use 'Google Inc.' sensor that returns a calculated gravity
• move isTimestampRecent to Tools class
• add unit tests for isTimestampRecent() methods -> instrument Test
• rename Orientation class to GeoOrientation #140

When getting closer to a stored location, give a warning when the current altitude is significantly different from the destination location.
Required : #31

generated code : BuildConfig and R classes

• cobertura : http://mojo.codehaus.org/cobertura-maven-plugin/usage.html
• JavaDoc

• Create a settings screen, using PreferenceFragment, see https://developer.android.com/guide/topics/ui/settings.html
• Call it from the action bar (menu is deprecated since Android 3.0)

This screen/activity uses the getLocation, savedLocation and getRelativeDistance classes to display the right distance and direction to the saved location

to resolve issue https://github.com/nijel/weblate/issues/286

see : http://blog.octo.com/en/add-lint-checks-to-android-maven-builds/

• enable in maven
• use in Jenkins

Format longitude and latitude :

• detect segment
• convert number (depending on segment)
• format number
• add N(orth), S(outh), E(ast), W(est)
• use localized units
• add unit tests

Add an option to preferences to choose prefered system (metric, imperial)
Applies to :

• accuracy
• speed
• altitude
• distance

Refactor AbstractAriadneActivity and limit access to private properties, using getter methods.
Some methods (like update LocationProvider and updateLocation) can be moved from the child classes to the abstract parent class.

• mBound -> isBound()
• mService -> getService()
• mCurrentLocation
• mStoredLocation
• mProviderName

The sole purpose of the 'saved' property is to be sure that an actual location was saved in sharedpreferences.

• distance based location update setting
• time based location update setting

https://developer.android.com/guide/topics/resources/string-resource.html#Plurals

• create FormatAngle method
• use methods formatting Direction and bearing angels
• format long/latitude as HH:MM:SS

See Checkstyle warnings for occurences that should use the actual current Locale

One pointer pointing up, and also a rotated version for 45°, 90°, ..., 270°, 315° (to be used in issue #43)

Calculate distance and direction from the current location to a stored location.
To get a relative direction, the current direction in which the user is moving is needed, thus at least two location points.
Don't calculate distance/direction when no location is stored.

• getCurrentBearing()
  Calculate bearing from active sensors (if present) :
  • get bearing from electronic compass, TODO, see issue #41
  • if location has a bearing (fe. locationprovider = gps), use bearing from location
  • if bearing is not definied for the current location (fe. because locationprovider does not provide it), calculate it from previous and current location
• getCurrentSpeed()
  Calculate bearing from active sensors :
  • if location has a speed, use speed from location
  • if speed is not definied for the current location (fe. because locationprovider does not provide it), calculate it from previous and current location, and both timestamps.
• getDistance()
  Calculate distance between current location and stored location
• getAbsoluteDirection()
  Calculate absolute direction based on bearing from current location to stored location.
• getRelativeDirection()
  Calculate relative direction based on getAbsoluteDirection() and getCurrentBearing()
• add tests

When clicking the store location button, the entire location object is copied, also speed, accuracy, timestamp, ... This messes up the layout of the MainActivity.

BTW : This issues resolves itself when the activity is restarted, and the saved location is retrieved from local storage, because only long/latitude is stored in local storage.

Add a function to clear a stored location. this means removing the data from the SharedPreferences file and removing the current location from the object.

find a way to refresh the data on the acitivity display when the location is updated by the location provider

Convert current project to use Maven2 for Android

• check this value to enable/disable DEBUG mode -> commit f097608
• don't display debug mode settings when BuildConfig.DEBUG is false -> depends on issue 25

change LocationStore class to store more than one location

When getting closer to a destination, it makes sense to have more frequent updates, and thus getting a higher location accuracy.
-> Add option to automatically adjust location update intervals based on distance from chosen location.
f.e. 1 sec, 5m when closer than 100m; 10sec, 10m when 100m-1000m; ...

Stored longitude/latitude string (in SharedPreferences) contains a comma as a decimal separator. This crashes the Location.convert method
-> find out why a comma is stored
possible solutions :

• use a different type to store in SharedPreferences
• use a different conversion mechanism

• AboutActivity
• MainActivity

• Add an about activity (screen), displaying
• brief description of the app
• version
• author names
• license info
• link to website/wiki
• Call it from the action bar (menu is deprecated since Android 3.0)

• save altitude in StoredDestination
• calculate height difference between destination and current location
• display height difference on Main and Details activity

replace the Location objects by the Ariadne_Location object that will override the getString() method, outputting the object in a better format

fe. m -> km or ft -> mi

For location -> when timestamp of current location is too old, when accuracy is too big, when there are not enough satellites (in case of GPS)

For bearing -> when timestamp is too old, or location has no bearing and (prev. loc = curr. loc. or no previous location)

When loc_update_time and loc_update_dist preferences are changed, registering with LocationManager in LocationService should be updated.

button redirects to config section of android to enable/disable gps

translate interface to Dutch and write tests that check it is actually translated in the appropriate places.
Try setting up weblate for the translation.

Create class to retrieve location data from a location provider (gps, cell, network, ...), either continuously or at a one time request, if necessary using a background task, it should also check the accuracy of the location and try to find a better signal if available (fe. if no gps signal is available, take a location based on wifi or cell network info)