<?xml version="1.0"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"
   [<!ENTITY appname          "Viking">]
>

<section id="GeoClue" xreflabel="GeoClue"><title>GeoClue Layer</title>
<para>
  Enable following and/or creating a track from the position returned by the
  <ulink url="https://www.freedesktop.org/wiki/Software/GeoClue">GeoClue</ulink> service.
</para>
<para>
  On some systems you will need to enable location services, otherwise &appname; will encounter errors along the lines of <emphasis role="italic">"GDBus.Error:org.freedesktop.DBus.Error.AccessDenied: Geolocation disabled for UID ..."</emphasis>
</para>
<para>
 For the Ubuntu Linux distribution this is in the System Settings: Settings->Privacy->Location Services
</para>
<note>
<para>
  GeoClue runs using the <ulink url="https://www.freedesktop.org/wiki/Software/dbus/">dbus</ulink> messaging service.
  This is currently disabled in the <trademark>Windows</trademark> build of &appname; due to system distribution complexities.
</para>
</note>

<section><title>Layer Properties</title>
<para>
Configurable properties:
</para>
<variablelist>
<varlistentry>
<term><guilabel>Auto Connect</guilabel></term>
<listitem>
	<para>Whether to automatically connect or not. </para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Recording tracks</guilabel></term>
<listitem>
	<para>Whether to form a track on the location updates.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Jump to current position on start</guilabel></term>
<listitem>
	<para>Whether to move the viewport on first location report.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Moving method</guilabel></term>
<listitem>
	<para>How the viewport is moved upon location updates: centered, keep the position in the viewport or none.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Update Statusbar</guilabel></term>
<listitem>
	<para>Whether the Statusbar is also updated on location updates.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Colour</guilabel></term>
<listitem>
	<para>Set the colour of the position indicator.</para>
</listitem>
</varlistentry>
</variablelist>
</section><!-- Prop END -->

<section><title>Layer Operations</title>

<section><title>Start / Stop Tracking</title>
<para>
Offers manual control over the start or stop tracking as appropriate.
</para>
</section>

<section><title>Empty</title>
<para>
Quick access to remove all data from the tracking layer.
</para>
</section>

</section><!-- End Layer Ops -->

</section><!-- End GeoClue -->
