.. _headlabel-refx-cmd-gms:

GMS (Google Maps Hyperlink for SMS)
===================================

The `AT@GMS` command is used to set the function of the terminal sending :ref:`Location SMS <headlabel-refx-frames-sms>` to respond the request SMS,
that is, when the terminal receives a **"get position"** SMS, it will respond the Location SMS to the phone.

.. code-block:: none

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

.. tabularcolumns:: |p{2.2em}|p{14.2em}|p{5.8em}|p{12em}|p{4.8em}|

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

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

- `Mode`

  - **0** - Disable this function.

  - **1** - Enable this function.

- `Location Request Number Limit`

  - **0** - No limit. No matter from which number the short message is received, it will be processed.

  - **1** - Allowlist only. Only if the received short message comes from the mobile phone allowlist (please see :ref:`AT@PWL <headlabel-refx-cmd-pwl>` command), it will be processed.