User Tools

Site Tools


manual:advanced:locus_api:geocaching_field_notes

This is an old revision of the document!


Geocaching Field Notes

Basic information

Since version 3.2.0, Locus offer full access to user's field notes. For this access, is used system called Content provider. You don't have to be too skilled with it. Most of required work is already done in Locus API and you may (and it's suggested) use already pre-prepared functions.

How to

To access field notes in read or write mode, you need

  • Installed Locus API in your IDE and added dependency to your new/existing project. More in Installation manual.
  • Permission in your AndroidManifest.xml file.

For read only access

<uses-permission android:name=“com.asamm.locus.permission.READ_GEOCACHING_DATA” />

For read/write access

<uses-permission android:name=“com.asamm.locus.permission.WRITE_GEOCACHING_DATA” />

Possibilities

Field notes are in Locus stored in SQLite databases, so all queries send over Locus API to content provider, may be defined in probably well known way for you - same as a query to SQLite database.

What is possible

  • GET, INSERT, UPDATE, DELETE queries on FieldNotes
  • GET, INSERT, UPDATE, DELETE queries on FieldNote images

To use basic features, check FieldNotesHelper.java class.

Here are three very important parts

  • Static classes that contains names of possible field notes columns. These are used in all specific requests.
  • Static helper functions, for basic operations over content provider. You may write own functions if you require more specific requests of course.
  • Static functions for some other tasks. For example request on log certain field notes over Groundspeak Live API.
manual/advanced/locus_api/geocaching_field_notes.1432215279.txt.gz · Last modified: 2015/05/21 16:34 (external edit)