path: root/libmm-glib/generated/mm-gdbus-doc-org.freedesktop.ModemManager1.Modem.Location.xml

<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
               "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
]>
<refentry id="gdbus-org.freedesktop.ModemManager1.Modem.Location">
  <refmeta>    <refentrytitle role="top_of_page" id="gdbus-interface-org-freedesktop-ModemManager1-Modem-Location.top_of_page">org.freedesktop.ModemManager1.Modem.Location</refentrytitle>
  <indexterm zone="gdbus-interface-org-freedesktop-ModemManager1-Modem-Location.top_of_page"><primary sortas="Modem.Location">org.freedesktop.ModemManager1.Modem.Location</primary></indexterm>
  </refmeta>  <refnamediv>    <refname>org.freedesktop.ModemManager1.Modem.Location</refname>    <refpurpose>The ModemManager Location interface.</refpurpose>  </refnamediv>  <refsynopsisdiv role="synopsis">
    <title role="synopsis.title">Methods</title>
    <synopsis>
<link linkend="gdbus-method-org-freedesktop-ModemManager1-Modem-Location.Setup">Setup</link>                (IN  u     sources,
                      IN  b     signal_location);
<link linkend="gdbus-method-org-freedesktop-ModemManager1-Modem-Location.GetLocation">GetLocation</link>          (OUT a{uv} Location);
<link linkend="gdbus-method-org-freedesktop-ModemManager1-Modem-Location.SetSuplServer">SetSuplServer</link>        (IN  s     supl);
<link linkend="gdbus-method-org-freedesktop-ModemManager1-Modem-Location.InjectAssistanceData">InjectAssistanceData</link> (IN  ay    data);
<link linkend="gdbus-method-org-freedesktop-ModemManager1-Modem-Location.SetGpsRefreshRate">SetGpsRefreshRate</link>    (IN  u     rate);
</synopsis>
  </refsynopsisdiv>
  <refsect1 role="properties">
    <title role="properties.title">Properties</title>
    <synopsis>
<link linkend="gdbus-property-org-freedesktop-ModemManager1-Modem-Location.Capabilities">Capabilities</link>             readable   u
<link linkend="gdbus-property-org-freedesktop-ModemManager1-Modem-Location.SupportedAssistanceData">SupportedAssistanceData</link>  readable   u
<link linkend="gdbus-property-org-freedesktop-ModemManager1-Modem-Location.Enabled">Enabled</link>                  readable   u
<link linkend="gdbus-property-org-freedesktop-ModemManager1-Modem-Location.SignalsLocation">SignalsLocation</link>          readable   b
<link linkend="gdbus-property-org-freedesktop-ModemManager1-Modem-Location.Location">Location</link>                 readable   a{uv}
<link linkend="gdbus-property-org-freedesktop-ModemManager1-Modem-Location.SuplServer">SuplServer</link>               readable   s
<link linkend="gdbus-property-org-freedesktop-ModemManager1-Modem-Location.AssistanceDataServers">AssistanceDataServers</link>    readable   as
<link linkend="gdbus-property-org-freedesktop-ModemManager1-Modem-Location.GpsRefreshRate">GpsRefreshRate</link>           readable   u
</synopsis>
  </refsect1>
<refsect1 role="desc" id="gdbus-interface-org-freedesktop-ModemManager1-Modem-Location">
  <title role="desc.title">Description</title>
  <para>      The Location interface allows devices to provide location information to
      client applications. Not all devices can provide this information, or even
      if they do, they may not be able to provide it while a data session is
      active.
</para><para>      This interface will only be available once the modem is ready to be
      registered in the cellular network. 3GPP devices will require a valid
      unlocked SIM card before any of the features in the interface can be
      used (including GNSS module management).
</para>
</refsect1>
<refsect1 role="details" id="gdbus-methods-org.freedesktop.ModemManager1.Modem.Location">
  <title role="details.title">Method Details</title>
<refsect2 role="method" id="gdbus-method-org-freedesktop-ModemManager1-Modem-Location.Setup">
  <title>The Setup() method</title>
  <indexterm zone="gdbus-method-org-freedesktop-ModemManager1-Modem-Location.Setup"><primary sortas="Modem.Location.Setup">org.freedesktop.ModemManager1.Modem.Location.Setup()</primary></indexterm>
<programlisting>
Setup (IN  u sources,
       IN  b signal_location);
</programlisting>
<para>        Configure the location sources to use when gathering location
        information. Also enable or disable location information gathering.
        This method may require the client to authenticate itself.
</para><para>        When signals are emitted, any client application (including malicious
        ones!) can listen for location updates unless D-Bus permissions restrict
        these signals from certain users. If further security is desired, the
        <parameter>signal_location</parameter> argument can be set to <constant>FALSE</constant> to disable location
        updates via D-Bus signals and require applications to call
        authenticated APIs (like
        <link linkend="gdbus-method-org-freedesktop-ModemManager1-Modem-Location.GetLocation">GetLocation()</link>
        ) to get
        location information.
</para><para>        The optional
        <link linkend="MM-MODEM-LOCATION-SOURCE-AGPS:CAPS">MM_MODEM_LOCATION_SOURCE_AGPS</link>
        allows to request A-GPS operation, and it must be given along with either
        <link linkend="MM-MODEM-LOCATION-SOURCE-GPS-RAW:CAPS">MM_MODEM_LOCATION_SOURCE_GPS_RAW</link>
        or
        <link linkend="MM-MODEM-LOCATION-SOURCE-GPS-NMEA:CAPS">MM_MODEM_LOCATION_SOURCE_GPS_NMEA</link>.
</para>
<variablelist role="params">
<varlistentry>
  <term><literal>IN u <parameter>sources</parameter></literal>:</term>
  <listitem><para>Bitmask of <link linkend="MMModemLocationSource">MMModemLocationSource</link> flags, specifying which sources should get enabled or disabled. <link linkend="MM-MODEM-LOCATION-SOURCE-NONE:CAPS">MM_MODEM_LOCATION_SOURCE_NONE</link> will disable all location gathering.</para></listitem>
</varlistentry>
<varlistentry>
  <term><literal>IN b <parameter>signal_location</parameter></literal>:</term>
  <listitem><para>Flag to control whether the device emits signals with the new location information. This argument is ignored when disabling location information gathering.</para></listitem>
</varlistentry>
</variablelist>
</refsect2>
<refsect2 role="method" id="gdbus-method-org-freedesktop-ModemManager1-Modem-Location.GetLocation">
  <title>The GetLocation() method</title>
  <indexterm zone="gdbus-method-org-freedesktop-ModemManager1-Modem-Location.GetLocation"><primary sortas="Modem.Location.GetLocation">org.freedesktop.ModemManager1.Modem.Location.GetLocation()</primary></indexterm>
<programlisting>
GetLocation (OUT a{uv} Location);
</programlisting>
<para>        Return current location information, if any. If the modem supports
        multiple location types it may return more than one. See the
        <link linkend="gdbus-property-org-freedesktop-ModemManager1-Modem-Location.Location">"Location"</link> property
        for more information on the dictionary returned at <parameter>location</parameter>.
</para><para>        This method may require the client to authenticate itself.
</para>
<variablelist role="params">
<varlistentry>
  <term><literal>OUT a{uv} <parameter>Location</parameter></literal>:</term>
  <listitem><para></para></listitem>
</varlistentry>
</variablelist>
</refsect2>
<refsect2 role="method" id="gdbus-method-org-freedesktop-ModemManager1-Modem-Location.SetSuplServer">
  <title>The SetSuplServer() method</title>
  <indexterm zone="gdbus-method-org-freedesktop-ModemManager1-Modem-Location.SetSuplServer"><primary sortas="Modem.Location.SetSuplServer">org.freedesktop.ModemManager1.Modem.Location.SetSuplServer()</primary></indexterm>
<programlisting>
SetSuplServer (IN  s supl);
</programlisting>
<para>        Configure the SUPL server for A-GPS.
</para>
<variablelist role="params">
<varlistentry>
  <term><literal>IN s <parameter>supl</parameter></literal>:</term>
  <listitem><para>SUPL server configuration, given either as IP:PORT or as FQDN:PORT.</para></listitem>
</varlistentry>
</variablelist>
</refsect2>
<refsect2 role="method" id="gdbus-method-org-freedesktop-ModemManager1-Modem-Location.InjectAssistanceData">
  <title>The InjectAssistanceData() method</title>
  <indexterm zone="gdbus-method-org-freedesktop-ModemManager1-Modem-Location.InjectAssistanceData"><primary sortas="Modem.Location.InjectAssistanceData">org.freedesktop.ModemManager1.Modem.Location.InjectAssistanceData()</primary></indexterm>
<programlisting>
InjectAssistanceData (IN  ay data);
</programlisting>
<para>        Inject assistance data to the GNSS module.
        The data files should be downloaded using external means from the URLs specified in
        the <link linkend="AssistanceDataServers">AssistanceDataServers</link> property.
</para><para>        The user does not need to specify the assistance data type being given.
</para><para>        There is no maximum <parameter>data</parameter> size limit specified, default DBus system bus limits apply.
</para>
<variablelist role="params">
<varlistentry>
  <term><literal>IN ay <parameter>data</parameter></literal>:</term>
  <listitem><para>assistance data to be injected to the GNSS module.</para></listitem>
</varlistentry>
</variablelist>
</refsect2>
<refsect2 role="method" id="gdbus-method-org-freedesktop-ModemManager1-Modem-Location.SetGpsRefreshRate">
  <title>The SetGpsRefreshRate() method</title>
  <indexterm zone="gdbus-method-org-freedesktop-ModemManager1-Modem-Location.SetGpsRefreshRate"><primary sortas="Modem.Location.SetGpsRefreshRate">org.freedesktop.ModemManager1.Modem.Location.SetGpsRefreshRate()</primary></indexterm>
<programlisting>
SetGpsRefreshRate (IN  u rate);
</programlisting>
<para>        Set the refresh rate of the GPS information in the API. If not explicitly
        set, a default of 30s will be used.
</para><para>        The refresh rate can be set to 0 to disable it, so that every update reported by
        the modem is published in the interface.
</para>
<variablelist role="params">
<varlistentry>
  <term><literal>IN u <parameter>rate</parameter></literal>:</term>
  <listitem><para>Rate, in seconds.</para></listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsect1>
<refsect1 role="details" id="gdbus-properties-org.freedesktop.ModemManager1.Modem.Location">
  <title role="details.title">Property Details</title>
<refsect2 role="property" id="gdbus-property-org-freedesktop-ModemManager1-Modem-Location.Capabilities">
  <title>The "Capabilities" property</title>
  <indexterm zone="gdbus-property-org-freedesktop-ModemManager1-Modem-Location.Capabilities"><primary sortas="Modem.Location:Capabilities">org.freedesktop.ModemManager1.Modem.Location:Capabilities</primary></indexterm>
<programlisting>
Capabilities  readable   u
</programlisting>
<para>        Bitmask of <link linkend="MMModemLocationSource">MMModemLocationSource</link>
        values, specifying the supported location sources.
</para>
</refsect2>
<refsect2 role="property" id="gdbus-property-org-freedesktop-ModemManager1-Modem-Location.SupportedAssistanceData">
  <title>The "SupportedAssistanceData" property</title>
  <indexterm zone="gdbus-property-org-freedesktop-ModemManager1-Modem-Location.SupportedAssistanceData"><primary sortas="Modem.Location:SupportedAssistanceData">org.freedesktop.ModemManager1.Modem.Location:SupportedAssistanceData</primary></indexterm>
<programlisting>
SupportedAssistanceData  readable   u
</programlisting>
<para>        Bitmask of <link linkend="MMModemLocationAssistanceDataType">MMModemLocationAssistanceDataType</link>
        values, specifying the supported types of assistance data.
</para>
</refsect2>
<refsect2 role="property" id="gdbus-property-org-freedesktop-ModemManager1-Modem-Location.Enabled">
  <title>The "Enabled" property</title>
  <indexterm zone="gdbus-property-org-freedesktop-ModemManager1-Modem-Location.Enabled"><primary sortas="Modem.Location:Enabled">org.freedesktop.ModemManager1.Modem.Location:Enabled</primary></indexterm>
<programlisting>
Enabled  readable   u
</programlisting>
<para>        Bitmask specifying which of the supported
        <link linkend="MMModemLocationSource">MMModemLocationSource</link>
        location sources is currently enabled in the device.
</para>
</refsect2>
<refsect2 role="property" id="gdbus-property-org-freedesktop-ModemManager1-Modem-Location.SignalsLocation">
  <title>The "SignalsLocation" property</title>
  <indexterm zone="gdbus-property-org-freedesktop-ModemManager1-Modem-Location.SignalsLocation"><primary sortas="Modem.Location:SignalsLocation">org.freedesktop.ModemManager1.Modem.Location:SignalsLocation</primary></indexterm>
<programlisting>
SignalsLocation  readable   b
</programlisting>
<para>        <constant>TRUE</constant> if location updates will be emitted via D-Bus signals, <constant>FALSE</constant> if
        location updates will not be emitted.
</para><para>        See the
        <link linkend="gdbus-method-org-freedesktop-ModemManager1-Modem-Location.Setup">Setup()</link>
        method for more information.
</para>
</refsect2>
<refsect2 role="property" id="gdbus-property-org-freedesktop-ModemManager1-Modem-Location.Location">
  <title>The "Location" property</title>
  <indexterm zone="gdbus-property-org-freedesktop-ModemManager1-Modem-Location.Location"><primary sortas="Modem.Location:Location">org.freedesktop.ModemManager1.Modem.Location:Location</primary></indexterm>
<programlisting>
Location  readable   a{uv}
</programlisting>
<para>        Dictionary of available location information when location information
        gathering is enabled. If the modem supports multiple location types it
        may return more than one here.
</para><para>        Note that if the device was told not to emit updated location
        information when location information gathering was initially enabled,
        this property may not return any location information for security reasons.
</para><para>        This dictionary is composed of a
        <link linkend="MMModemLocationSource">MMModemLocationSource</link>
        key, with an associated data which contains type-specific location
        information:
</para><para>        <variablelist>
        <varlistentry><term><link linkend="MM-MODEM-LOCATION-SOURCE-3GPP-LAC-CI:CAPS">MM_MODEM_LOCATION_SOURCE_3GPP_LAC_CI</link></term>
          <listitem>
            <para>
              Devices supporting this
              capability return a string in the format <literal>"MCC,MNC,LAC,CI,TAC"</literal> (without the
              quotes of course) where the following applies:
            </para>
            <variablelist>
              <varlistentry><term><literal>MCC</literal></term>
                <listitem>
                  This is the three-digit ITU E.212 Mobile Country Code of the
                  network provider to which the mobile is currently registered.
                  e.g. <literal>"310"</literal>.
                </listitem>
              </varlistentry>
              <varlistentry><term><literal>MNC</literal></term>
                <listitem>
                  This is the two- or three-digit GSM Mobile Network Code of the
                  network provider to which the mobile is currently registered.
                  e.g. <literal>"26"</literal> or <literal>"260"</literal>.
                </listitem>
              </varlistentry>
              <varlistentry><term><literal>LAC</literal></term>
                <listitem>
                  This is the two-byte Location Area Code of the GSM/UMTS base
                  station with which the mobile is registered, in upper-case
                  hexadecimal format without leading zeros, as specified in
                  3GPP TS 27.007. E.g. <literal>"84CD"</literal>.
                </listitem>
              </varlistentry>
              <varlistentry><term><literal>CI</literal></term>
                <listitem>
                  This is the two- or four-byte Cell Identifier with which the mobile
                  is registered, in upper-case hexadecimal format without leading
                  zeros, as specified in 3GPP TS 27.007.
                  e.g. <literal>"2BAF"</literal> or <literal>"D30156"</literal>.
                </listitem>
              </varlistentry>
              <varlistentry><term><literal>TAC</literal></term>
                <listitem>
                  This is the two-byte Location Area Code of the LTE base
                  station with which the mobile is registered, in upper-case
                  hexadecimal format without leading zeros, as specified in
                  3GPP TS 27.007. E.g. <literal>"6FFE"</literal>.
                </listitem>
              </varlistentry>
            </variablelist>
            <para>
              The entire string may only be composed of the ASCII digits <literal>[0-9]</literal>,
              the alphabetical characters <literal>[A-F]</literal>, and the comma (<literal>,</literal>) character.
              No other characters are allowed.  For example: <literal>"310,260,8BE3,2BAF"</literal> or
              <literal>"250,40,CE00,1CEAD8F0"</literal>.
            </para>
            <para>
              If any of these four items (<literal>MCC</literal>, <literal>MNC</literal>,
              <literal>LAC</literal>, <literal>CI</literal>) is unknown or the
              mobile is not registered with a network, then the
              <link linkend="MM-MODEM-LOCATION-SOURCE-3GPP-LAC-CI:CAPS">MM_MODEM_LOCATION_SOURCE_3GPP_LAC_CI</link>
              location
              information item should not be provided as a returned value from the
              <link linkend="gdbus-method-org-freedesktop-ModemManager1-Modem-Location.GetLocation">GetLocation()</link>
              method or in the <link linkend="gdbus-property-org-freedesktop-ModemManager1-Modem-Location.Location">"Location"</link> property.
            </para>
          </listitem>
        </varlistentry>
        <varlistentry><term><link linkend="MM-MODEM-LOCATION-SOURCE-GPS-RAW:CAPS">MM_MODEM_LOCATION_SOURCE_GPS_RAW</link></term>
          <listitem>
            <para>
              Devices supporting this
              capability return a D-Bus dictionary (signature <literal>"a{sv}"</literal>) mapping well-known
              keys to values with defined formats.
            </para>
            <para>
              The allowed key/value pairs and their formats are:
            </para>
            <variablelist>
              <varlistentry><term><literal>"utc-time"</literal></term>
                <listitem>
                  (Required) UTC time in ISO 8601 format, given as a string value (signature <literal>"s"</literal>). e.g. <literal>203015</literal>.
                </listitem>
              </varlistentry>
              <varlistentry><term><literal>"latitude"</literal></term>
                <listitem>
                  (Required) Latitude in Decimal Degrees (positive numbers mean N quadrasphere, negative mean S quadrasphere), given as a double value (signature <literal>"d"</literal>). e.g. <literal>38.889722</literal>, meaning 38d 53' 22" N.
                </listitem>
              </varlistentry>
              <varlistentry><term><literal>"longitude"</literal></term>
                <listitem>
                  (Required) Longitude in Decimal Degrees (positive numbers mean E quadrasphere, negative mean W quadrasphere), given as a double value (signature <literal>"d"</literal>). e.g. <literal>-77.008889</literal>, meaning 77d 0' 32" W.
                </listitem>
              </varlistentry>
              <varlistentry><term><literal>"altitude"</literal></term>
                <listitem>
                  (Optional) Altitude above sea level in meters, given as a double value (signature <literal>"d"</literal>). e.g. <literal>33.5</literal>.
                </listitem>
              </varlistentry>
            </variablelist>
          </listitem>
        </varlistentry>
        <varlistentry><term><link linkend="MM-MODEM-LOCATION-SOURCE-GPS-NMEA:CAPS">MM_MODEM_LOCATION_SOURCE_GPS_NMEA</link></term>
          <listitem>
            <para>
              Devices supporting this capability return
              a string containing one or more NMEA sentences (D-Bus signature <literal>'s'</literal>).
              The manager will cache the most recent NMEA sentence of each type for
              a period of time not less than 30 seconds.  When reporting multiple
              NMEA sentences, sentences shall be separated by an ASCII Carriage
              Return and Line Feed (<literal>&lt;CR&gt;&lt;LF&gt;</literal>) sequence.
            </para>
            <para>
              For example, if the device sends a <literal>$GPRMC</literal> sentence immediately
              followed by a <literal>$GPGGA</literal> sentence, the reported location string would be
              (where of course the <literal>&lt;CR&gt;&lt;LF&gt;</literal> is replaced with the actual
              ASCII <literal>CR</literal> (0x0D) and <literal>LF</literal> (0x0A) control characters):
              <para><literal>
                $GPRMC,134523.92,V,,,,,,,030136,,,N*73&lt;CR&gt;&lt;LF&gt;$GPGGA,,,,,,0,00,0.5,,M,0.0001999,M,0.0000099,0000*45
              </literal></para>
              If the device sends a new <literal>$GPRMC</literal> three seconds later, the new <literal>$GPRMC</literal>
              replaces the previously received <literal>$GPRMC</literal> sentence, and the updated
              string would be:
              <para><literal>
                $GPRMC,134526.92,V,,,,,,,030136,,,N*76&lt;CR&gt;&lt;LF&gt;$GPGGA,,,,,,0,00,0.5,,M,0.0001999,M,0.0000099,0000*45
              </literal></para>
              If the device then sends a <literal>$GPGSA</literal> sentence about 5 seconds later, the
              <literal>$GPGSA</literal> sentence is added to the string (since no <literal>$GPGSA</literal> sentence was
              obviously received in this session), the updated string would be:
              <para><literal>
                $GPRMC,134526.92,V,,,,,,,030136,,,N*76&lt;CR&gt;&lt;LF&gt;$GPGGA,,,,,,0,00,0.5,,M,0.0001999,M,0.0000099,0000*45&lt;CR&gt;&lt;LF&gt;$GPGSA,A,1,,,,,,,,,,,,,1.1,0.5,1.0*34
              </literal></para>
              The manager may discard any cached sentences older than 30 seconds.
            </para>
            <para>
              This allows clients to read the latest positioning data as soon as
              possible after they start, even if the device is not providing
              frequent location data updates.
            </para>
          </listitem>
        </varlistentry>
        <varlistentry><term><link linkend="MM-MODEM-LOCATION-SOURCE-CDMA-BS:CAPS">MM_MODEM_LOCATION_SOURCE_CDMA_BS</link></term>
          <listitem>
            <para>
              Devices supporting this
              capability return a D-Bus dictionary (signature <literal>"a{sv}"</literal>) mapping well-known
              keys to values with defined formats.
            </para>
            <para>
              The allowed key/value pairs and their formats are:
            </para>
            <variablelist>
              <varlistentry><term><literal>"latitude"</literal></term>
                <listitem>
                  (Required) Latitude in Decimal Degrees (positive numbers mean N quadrasphere, negative mean S quadrasphere), given as a double value (signature <literal>"d"</literal>). e.g. <literal>38.889722</literal>, meaning 38d 53' 22" N.
                </listitem>
              </varlistentry>
              <varlistentry><term><literal>"longitude"</literal></term>
                <listitem>
                  (Required) Longitude in Decimal Degrees (positive numbers mean E quadrasphere, negative mean W quadrasphere), given as a double value (signature <literal>"d"</literal>). e.g. <literal>-77.008889</literal>, meaning 77d 0' 32" W.
                </listitem>
              </varlistentry>
            </variablelist>
          </listitem>
        </varlistentry>
        </variablelist>
</para>
</refsect2>
<refsect2 role="property" id="gdbus-property-org-freedesktop-ModemManager1-Modem-Location.SuplServer">
  <title>The "SuplServer" property</title>
  <indexterm zone="gdbus-property-org-freedesktop-ModemManager1-Modem-Location.SuplServer"><primary sortas="Modem.Location:SuplServer">org.freedesktop.ModemManager1.Modem.Location:SuplServer</primary></indexterm>
<programlisting>
SuplServer  readable   s
</programlisting>
<para>        SUPL server configuration for A-GPS, given either as IP:PORT or FQDN:PORT.
</para>
</refsect2>
<refsect2 role="property" id="gdbus-property-org-freedesktop-ModemManager1-Modem-Location.AssistanceDataServers">
  <title>The "AssistanceDataServers" property</title>
  <indexterm zone="gdbus-property-org-freedesktop-ModemManager1-Modem-Location.AssistanceDataServers"><primary sortas="Modem.Location:AssistanceDataServers">org.freedesktop.ModemManager1.Modem.Location:AssistanceDataServers</primary></indexterm>
<programlisting>
AssistanceDataServers  readable   as
</programlisting>
<para>        URLs from where the user can download assistance data files to inject with
        <link linkend="gdbus-method-org-freedesktop-ModemManager1-Modem-Location.InjectAssistanceData">InjectAssistanceData()</link>.
</para>
</refsect2>
<refsect2 role="property" id="gdbus-property-org-freedesktop-ModemManager1-Modem-Location.GpsRefreshRate">
  <title>The "GpsRefreshRate" property</title>
  <indexterm zone="gdbus-property-org-freedesktop-ModemManager1-Modem-Location.GpsRefreshRate"><primary sortas="Modem.Location:GpsRefreshRate">org.freedesktop.ModemManager1.Modem.Location:GpsRefreshRate</primary></indexterm>
<programlisting>
GpsRefreshRate  readable   u
</programlisting>
<para>        Rate of refresh of the GPS information in the interface.
</para>
</refsect2>
</refsect1>
</refentry>