Change Log
Help
Email: info@angrygoatapps.com
Web: www.angrygoatapps.com
Twitter: angrygoatapps

| General |  |  |

SimpleGPS Pro displays data from the GPS unit as soon as it gets it without any filtering and without waiting for the GPS unit to get a better fix on the location. As such, the first sets of data retrieved is not likely to have a high degree of accuracy. To get better accuracy, use the tracking function. The accuracy should improve over time as the GPS unit locks on to more satellites.

- "Get Position" displays the current position as soon as the data is available. It most likely will not have with a high degree of accuracy.
- "Start Tracking" continuously updates the display. The first sets of data will likely to NOT have a high degree of accuracy, but it should improve over time.
- "Copy to Clipboard" copies the displayed data to the system clipboard so that it can be pasted into another app.
- Altitude is based on sea level NOT ground level, so it is possible to have a negative altitude. Also a correct GPS altitude fix requires a very good connection to the satellites. To get a better fix, try to find open territory. A highly accurate altitude fix maybe beyond the capability of the phone hardware.

| Data Recording |  |  |

Data recording is only available with SimpleGPS Plus and SimpleGPS Pro.
The GPS data is recorded into a database and can be emailed or uploaded, please see the Upload/Email section for more details. The raw output of the GPS unit is recorded without any filtering or formatting.
Start/Stop a recording
There multiple ways to start or stop a recording.

- Select the "Start/Stop Recording" item in the Application Menu
- Tap the record button on the main screen.
- (SimpleGPS Pro only) If the app is not in the foreground and the dashboard is enabled, tap the record button on the dashboard.

When the app is recording, a red dot will appear in the upper right corner of most of the screens except for the 'Help' screen and the Google authorization screens. For the view screen of an individual record, the red dot will only appear if that record is the one currently being recorded.
Description of recorded data

- latitude - Number representing the location's latitude in degrees. Valid range: -90.0, 90.0.
- longitude - Number representing the location's longitude in degrees. Valid range: -180.0, 180.0.
- h_accu - Horizontal accuracy of the location in meters. If unknown, the value is -1.
- altitude - Number representing the altitude of the location in meters. If unknown, the value is -1.
- v_accu - Vertical accuracy of the location in meters. If unknown, the value is -1.
- heading - Number representing the compass azimuth in degrees. Valid range: 0.0, 360.0. If unknown, the value is -1.
- velocity - Number representing velocity in meters per second. If unknown, the value is -1.
- timestamp - The time (in milliseconds) when this location fix was created. This is in UTC time and represents the number of milliseconds since 1/1/1970 00:00:00. For display and email, you can set in the preferences to show this as a formatted date/time in local or UTC time.

Special Tip
The database is a SQLite database stored in the media partition, which is accessible when you connect the phone to your computer. You should be able to copy the database file onto your computer and operate on it directly. I have not tested this and cannot provide any support for it and I cannot guarantee that this will work with future versions of webOS. You can find the file in this folder on your phone:

    .app-storage/file_.media.cryptofs.apps.usr.palm.applications.com.angrygoat.simplegpsplus_0

.app-storage is a hidden folder so you will have to tell your computer to show hidden files to see it.

| Viewing Records |  |  |

Viewing records is only available with SimpleGPS Plus and SimpleGPS Pro.
To view your recordings, tap the 'View Records' item in the application menu to go to the 'View Records' screen.
View Records

- Tapping a record opens a menu of commands for that record:
  View - brings you to the Record View screen (see below)
  Rename - allows you to rename the record.
  Email - emails the record.
  Upload to Google Drive - uploads the record to Google Drive (see the Upload/Email section)
  View Map - (SimpleGPS Pro only) Displays the recorded data on a map (see below).
- Swiping a record deletes it.

Record View

- Tapping on the header allows you to edit the name of the record. The default name is the time the record was created. If you delete the custom name, the name will automatically be changed back to the default.
- The text of the data can be scrolled left and right
- The email and upload button performs the same functions as the corresponding menu items described above.
- The copy button copies the data displayed to the system clipboard so you can paste it into another app.

View Map

- This feature requires an internet connection to work. Maps are created using Bing Maps.
- Selecting 'View Map' on a record menu will open a new card with the recorded data displayed on a map.
- Tapping the 'gear' icon allows you to show/hide the pins and/or the line.
- The button on the bottom left shows you the type of map currently in use. Tapping on it allows you to choose a different type of map.
- Tapping the name header will center the map on your data.
- The +/- button adjusts the zoom level of the map. You can also adjust the zoom level using the two finger pinch/spread gesture.
- Tapping a pin will show an info box containing the data associated with that pin. Tapping the info box or moving the map will hide the info box.
- In 'Preferences' you have the option to filter the data by accuracy and to detect stationery periods like you can with KML. Both of these options have to be adjusted before openning a record to see the effects.
- You can open mulitple records as maps at the time. A separate card will be launched for each map.
- Closing the main app will automatically close all the map cards.

| Upload/Email |  |  |

Uploading or emailing records is only available with SimpleGPS Plus and SimpleGPS Pro.
Email

- Choosing to email a record will bring up a dialog for choosing the type of file to email. The available types are: CSV, GPX, or (SimpleGPS Pro only) KML
- Trying to email a very large record will seem to freeze this app, but the problem is actually the phone's email app having trouble accepting really long messages. If you wait a while the email app will eventually launch or instead, you can use to upload to Google Drive option.

Upload
Uploading requires you to have a Google account, please see the 'Google Account' section on how to authorize this app to use your Google account.

- Choosing to upload a record to Google Drive will bring up a dialog for choosing the type of file to upload. The available types are: CSV, GPX, or (SimpleGPS Pro only) KML. KML file types have additional options that can be set in preferences (see below). You can access your uploaded recordings here: http://drive.google.com
- A notification will signal the start of the upload. A second notification will signal either a successful upload or an error.
- Uploaded recordings will never overwrite previous uploads, even if you upload the same recording twice.
- Even with a fast connection, sometimes the upload to Google can be slow.
- Google Drive has a limit on how large an upload can be. Of the three available formats, the KML output from this app contains the most amount of data, so it will be the easiest to exceed the limit. The limit for KML files seems to be around 600-700 data points. If you have trouble uploading a KML file try using one of the other formats. For CSV files the limit is very high (around 50000 data points).
- When uploading KML or GPX formats, this app will automatically change impossible altitude data of less than -15000m to the altitude of the previous waypoint or zero if it is the first waypoint.
- (SimpleGPS Pro only) You can choose to automatically upload a record whenever it stops recording. This is controlled in the 'Recording Options' section in Preferences.

Important Note: Uploaded GPX and KML files do not work if downloaded from Google Drive as plain text files. This is a problem with Google Drive, it converts the '<' and '>' symbols to something else when you download a text file. Download it is as OpenOffice, Word, or RTF instead, then open it with the corresponding program and re-save it as text. Alternatively, you can open the file in Google Drive, select all the text, and cut and paste it into a new text file.
KML options
This is only available in SimpleGPS Pro.

- Use Altitude - normally the waypoints and route line are automatically placed at ground level. When this option is turned on, the waypoints and route line will be placed at the recorded altitude.
- Stationary Threshold - When creating a KML file, this app can analyze the recorded data to combine consecutive data points that are close together in location into one waypoint with an approximate duration attached to it. This setting determines the maximum distance between two points for those points to be considered close together

Auto Upload
This is only available in SimpleGPS Pro.
This app can automatically upload the most recent record to Google Drive at regular intervals.

- Picking an available interval will start the countdown to the next upload. Every time you pick a different interval will reset the countdown. If 'Background Upload' is off, the interval will reset every time the app launches.
- Picking the Daily interval allows you to also pick the time of day for the upload to occur.
- File Type is the type of file to upload.
- Normally, the uploads will only occur when this app is open. If 'Background Upload' is on, the uploads will occur even if the app is closed.

| Google Account |  |  |

Only available in SimpleGPS Plus and SimpleGPS Pro
Uploading recordings to Google Drive requires a valid Google account.
Setup

- Open Preferences and tap 'Authorize' in the Google Account section. This will bring up a login page to your Google account.
- After you log in, a page will come up saying that this app is requesting access to 'Google Drive'. Tap the 'Grant Access' button.
- After you grant access you be brought back to the Preferences screen and either a notification will show up at the bottom saying the authorization was successful or a dialog will inform you that authorization has failed. If authorization fails, try again later the Google authorization servers may be busy.
- After you are authorized, the 'Authorize' button will change to say 'Reauthorize'. Normally you shouldn't need to reauthorize this app unless you want to change to a different Google account or the app tells you there is an authorization problem during upload. If that's the case tap this button to go through the authorization process again.
- The 'Revoke Authorization' button revokes this app's right to access your Google Drive account.
- Folder is the folder in Google Drive where the recordings will be uploaded to. You can set this to anything you like except for leaving it blank. If the folder doesn't exist in Google Drive, it will be created automatically.

| Dashboard |  |  |

Only available in SimpleGPS Pro
If 'Use Dashboard' is turned on in Preferences, a dashboard display will appear (after a short delay) every time this app is pushed to the background. The dashboard display contains three parts:

- The main display in the center shows the current GPS coordinates and status indicators for recording and uploading. Tapping in this area will reactivate the main app and close the dashboard.
- The record button on the left starts or stops a recording.
- The tracking button on the right starts or stops tracking.
- The dashboard controls are functional even when the phone is locked. As mentioned above, tapping the main display area of the will close the dashboard. This will happen even when the phone is locked. This is not the ideal behaviour, but unfortunately HP/Palm does not yet provide a way for third party apps the determine if the phone is locked.

| Error Log |  |  |

The Error Log is only available with SimpleGPS Plus and SimpleGPS Pro.

- Tap the 'Error Log' item in the application menu to access this screen.
- The error log shows a list of any errors that have occurred during the operation of the app. The errors that may occur are generally limited to either database errors or Google uploading errors. This log is persistent, but is automatically limited to the last 100 entries.

| Troubleshoot |  |  |

- It takes a long time for data to show up.

Your phone gets it's location using Assisted GPS, which means that it first acquires a rough location from the cell phone tower before getting a more accurate fix from the satellites. This allows for a much faster initial position retrieval as well as working better indoors. Unfortunately not every phone carrier allows third party apps access to the 'assisted' feature, which means that getting an initial location would take longer. For example, Verizon is one such carrier. One workaround is to first launch VZ Navigator before getting a position.

- The display shows zeros for every field.

  (Please see above for an explanation of Assisted GPS) A display of all zeros means that the cell tower is sending erroneous location data or the phone is having trouble getting location data from the cell tower. Use the tracking function and wait for the phone to acquire a fix from the satellites. Make sure your phone has a clear view of the sky to get a good satellite fix.

- Altitude is negative. Altitude is highly inaccurate.

  Altitude is based on sea level NOT ground level, so it is possible to have a negative altitude. A correct GPS altitude fix requires a very good connection to the satellites. To get a better fix, try to find open territory. A highly accurate altitude fix maybe beyond the capability of the phone hardware.

- Google Authorization fails

  Try again later. The Google authorization servers maybe busy.

- Uploading to Google Drive fails

  Check the error log for details of the failure. If the error is something about 'Cannot convert file', your upload maybe too large for Google Drive to accept. Try uploading a more compact format. KML is the largest format. CSV is the most compact.

- GPX or KML files downloaded from Google Drive as text files do not work

  Please see the 'Important Note' under 'Upload' in the 'Upload/Email' section