.. _headlabel-refx-cmd-agps:

AGPS (Assisted GPS)
===================

The `AT@AGPS` command is used to control the AGPS function. Enabling AGPS can obtain location information faster but consumes a little wireless traffic.

.. code-block:: none

   Example:
   AT@AGPS=gl601###,0,,,,012F$
   +ACK:AGPS,123456789012345,C031,10,0,,012F,20210407101530,1234$
   AT@AGPS?gl601###,,0C37$
   +QRY:AGPS,123456789012345,C031,10,0,1,1,0,,,,0C37,20210407101530,1234$

.. tabularcolumns:: |p{2.2em}|p{7.2em}|p{5.8em}|p{19em}|p{4.8em}|

.. table::
   :width: 100%
   :widths: auto

   +-------+----------------------------------+---------------+--------------------------------------------------+---------------------+
   | Parts | Fields                           | Length (Byte) | Range/Format                                     | Default             |
   +=======+==================================+===============+==================================================+=====================+
   | Head  | Header                           | 3             | AT@                                              | AT@                 |
   +       +----------------------------------+---------------+--------------------------------------------------+---------------------+
   |       | Command Word                     | 4             | AGPS                                             | AGPS                |
   +       +----------------------------------+---------------+--------------------------------------------------+---------------------+
   |       | Leading Symbol                   | 1             | =                                                | =                   |
   +       +----------------------------------+---------------+--------------------------------------------------+---------------------+
   |       | Password                         | 8-16          |                                                  | gl601###            |
   +-------+----------------------------------+---------------+--------------------------------------------------+---------------------+
   | Body  | `Mode`                           | 1             | 0, 1                                             | 0                   |
   +       +----------------------------------+---------------+--------------------------------------------------+---------------------+
   |       | Reserved                         | 0             |                                                  |                     |
   +       +----------------------------------+---------------+--------------------------------------------------+---------------------+
   |       | Reserved                         | 0             |                                                  |                     |
   +       +----------------------------------+---------------+--------------------------------------------------+---------------------+
   |       | Reserved                         | 0             |                                                  |                     |
   +-------+----------------------------------+---------------+--------------------------------------------------+---------------------+
   | Tail  | Sequence Number                  | 4             | 0000-FFFF ('0'-'9', 'A'-'F')                     |                     |
   +       +----------------------------------+---------------+--------------------------------------------------+---------------------+
   |       | Tail                             | 1             | $                                                | $                   |
   +-------+----------------------------------+---------------+--------------------------------------------------+---------------------+

- `Mode`

  Specify whether to enable the AGPS function. Enable AGPS function will help to reduce Time To First Fix (TTFF), but it will also consume network data traffic.

  - **0** - Disable the AGPS function.

  - **1** - Enable as Offline mode. The terminal device will periodically download the assistance data over the network.