====== Android Permissions ======

----

**Locus Map** is growing. Over the years of development, it contains more and more features that require permission from the Android Operation System. The same it is with apps related to it or built upon its base - **Locus GIS, Map4Trip and KiMaps**. The main reason for it is, of course, your protection as the user.

<WRAP center round info>
A list of all available permissions for Android platform is [[http://developer.android.com/reference/android/Manifest.permission.html|here]] - as you can see bellow, Locus Map group of apps uses only a few of them.
</WRAP>

A complete list of all the permissions and their explanation:

==== Basic permissions ====

  * //android.permission.ACCESS_COARSE_LOCATION//
    * allows **access to Wi-Fi, network location**

  * //android.permission.ACCESS_FINE_LOCATION//
    * allows to **acquire GPS location**

  * //android.permission.ACCESS_BACKGROUND_LOCATION//
    * allows to record tracks, navigate or use live tracking when **running in the background** - when the phone screen is off or when you use another app

  * //android.permission.ACCESS_LOCATION_EXTRA_COMMANDS//
    * allows **disabling the A-GPS data status and forcing system to load new**

  * //android.permission.ACCESS_MOCK_LOCATION//
    * allows **creating and receiving simulated locations**

  * //android.permission.ACCESS_NETWORK_STATE//
    * allows **testing if internet connection is available**

  * //android.permission.ACCESS_WIFI_STATE//
    * allows to **check Wi-Fi network state** (connected/disconnected)
  
  * //android.permission.BIND_DEVICE_ADMIN//
    * allows to **control screen on/off depending on various events** like near-point alerts, direction changes during navigation, etc.
    * enables to **control your screen with hardware buttons** of your device or with external controllers (e.g. Bluetooth) 

  * //android.permission.BLUETOOTH//
    * allows to **work with (connect to) a Bluetooth device**

  * //android.permission.BLUETOOTH_ADMIN//
    * allows to **search for and pair Bluetooth devices**

  * //android.permission.GET_ACCOUNTS//
    * allows reading the list of **available Google accounts** (for the possibility to enter **Locus Store** or launch **Live tracking**). Unfortunately, this permission is a part of a group **Contacts** which triggers a warning about the possibility of the app reading user's contacts - **none of it is allowed!**
     
  * //android.permission.MANAGE_ACCOUNTS//
    * allows **restoring expired access to a logged in account**. Each account has its validity time and when this expires a request for re-login has to be made.

  * //android.permission.USE_CREDENTIALS//
    * allows to **request auth_tokens from the AccountManager**. This means that Locus Map may request you to login to your account without writing any username/password information into the app.

  * //android.permission.INTERNET//
    * allows **downloading map tiles, address search** and more tools

  * //android.permission.KILL_BACKGROUND_PROCESSES//
    * allows to **restart the app and also kill it after exit**. Thanks to this Locus Map (and related apps) is removed from the system memory when closed

  * //android.permission.RECEIVE_BOOT_COMPLETED//
    * required for **automatic backup feature**

  * //android.permission.VIBRATE//
    * allows to **control the device's vibrator for notifications**

  * //android.permission.WAKE_LOCK//
    * allows to **keep Locus Map (and related apps) awake if required by user** for some demanding tasks like track recording etc.

  * //android.permission.WRITE_EXTERNAL_STORAGE// - <wrap important>limited in Android 4.4.2 and later</wrap>
    * allows **handling the external storage card** - for reading external maps, storing vector maps, backup and SRTM data
    * allows also **accessing your photos and videos** so that they are available as attachments to points

  * //android.permission.MANAGE_EXTERNAL_STORAGE// - <wrap important> from Android 11</wrap>
    * so called **all files access** - allows using the whole internal storage and SD card for Locus data

  * //android.permission.RECORD_AUDIO//
    * allows **access to microphone** for the recording of audio as an attachment to points

==== Google stuff ====

  * //com.android.vending.CHECK_LICENSE//
    * used to **verify your purchased license**

  * //com.android.vending.BILLING//
    * allows to **provide in-app billing**


  * //com.google.android.providers.gsf.permission.READ_GSERVICES//
    * allows **access to Google services** (for Locus Store, Google Analytics, planned Cloud to device messaging, etc.)

==== ANT+ support ====

  * //com.dsi.ant.permission.ANT//
  * //com.dsi.ant.permission.ANT_ADMIN//
    * allows to **connect and manage the connection to ANT+ sensors**

===== Locus Add-Ons =====
==== Locus Augmented Reality Add-On====
  * //android.permission.CAMERA// - this add-on enables **displaying selected points** according to their GPS coordinates on the **background recorded by the camera**. No image data are recorded nor shared.  [[manual:user_guide:add-ons:ar|See more >>]]

==== Locus Contacts Add-On ====
  * //android.permission.READ_CONTACTS// - this add-on enables **viewing your contacts' addresses on the map**. No contacts data are stored or shared. [[manual:user_guide:add-ons:contacts|See more >>]]