Documentation: update "Web Service and Companion App"

Signed-off-by: Dirk Hohndel <dirk@hohndel.org>
This commit is contained in:
Dirk Hohndel 2013-05-13 17:17:13 -05:00
parent ca0bad84f8
commit 95f9ba800b

View file

@ -1180,21 +1180,37 @@ Web Service and Companion App
-----------------------------
This part of Subsurface is a bit of 'work in progress'. We are
developing a companion application for Android that will allow you to
track dive sites from your GPS-enabled Android device; at the time of
the Subsurface 3.0 release the app wasn't ready to be submitted to the
Google Play store, but since it is mostly usable when built form
source we left the server side integration in Subsurface.
developing a companion application for Android that allows you to
track dive sites from your GPS-enabled Android device.
Assuming you have used the companion app to name and locate dive sites
you can use this menu item to connect to our back-end server and
download this data. Enter your userid (you got this when registering
with the web service) and click 'Download'. If the data was
successfully downloaded you can click apply and Subsurface will match
the time stamps of the downloaded location and site name information
with the dives in your log and will add the GPS locations and dive
site names to your dives.
The Subsurface app is available for free in the Google Play store (and
sources are available from our git server). A server side webservice
is running on our infrastructure to capture and store the data
transmitted by the application. An interested user could also run
their own web service (the sources for the web service are also
available).
The Android companion app allows you to store the GPS location and
name of specific dive sites as their name is entered into the
application. It can also operate as a background service and record
positions at regular intervals (this is especially useful when on a
dive boat).
After downloading your dives from your dive computer (or manually
adding them in the Subsurface desktop application) you can then use
this menu item to connect to our back-end server and download the
related location data (and dive site names). Enter your userid (you
got this when registering with the web service) and click
'Download'. If the data was successfully downloaded you can click
apply and Subsurface will match the time stamps of the downloaded
location and site name information with the dives in your log and will
add the GPS locations and dive site names to your dives.
[NOTE]
At this point you can not use the Android Subsurface companion app to
enter dives and then download these dives into the desktop
application. The companion up and webservice can only be used to add
GPS location (and dive site name) to an existing dive in the dive log.
[[S_Menu]]
The Menu and Sub-Menus