====== Public Intents ======

===== Basic information =====

[[http://developer.android.com/reference/android/content/Intent.html|Android Intent]] is mechanism through which applications in Android communicate. Almost every information that one application wants to send to another is distributed via Intent. But the Intent may also be used to start some action, e.g. to notify about some change and many other tasks.

===== How to =====

Locus Map currently supports a few actions that may help you control Locus from different applications. If you want to create more complex system and you're familiar with Android developing, we suggest to use Locus API integrated into your own program.

Otherwise, use Tasker or any other application, and use definitions below:


----

==== Track record ====

To control track recording, use **Actions** below. All actions have to be used as **Broadcast intent**.

=== Start recording ===

  locus.api.android.ACTION_TRACK_RECORD_START

== Additional parameters ==

  * Item Ability to set recording profile
    * key: INTENT_EXTRA_TRACK_REC_PROFILE
    * value: **String**, name of profile

----

=== Pause recording ===

  locus.api.android.ACTION_TRACK_RECORD_PAUSE

----

=== Stop recording ===

  locus.api.android.ACTION_TRACK_RECORD_STOP
  
== Additional parameters ==

  * Ability to save track automatically without asking for additional details
    * key: INTENT_EXTRA_TRACK_REC_AUTO_SAVE
    * value: **boolean**, true/false value, default //false//

----

=== Add waypoint ===

  locus.api.android.ACTION_TRACK_RECORD_ADD_WPT