.. _headlabel-refx-frames-sms:

Location SMS
============

The terminal supports sending short message with Google Maps Hyperlink (called Location SMS) to mobile phones. The format of Location SMS is as follows:

.. code-block:: none

   Example:
   LBS:123456789012345
   http://maps.google.com/maps?q=22.538503,114.017054
   F1 D2020/10/31T17:20:45 B100% S38.6

.. table::
   :width: 100%
   :widths: 13 25 16 30 16

   +------------+-----------------------+---------------+---------------------------+-----------------+
   | Parts      | Fields                | Length (Byte) | Range/Format              | Default         |
   +============+=======================+===============+===========================+=================+
   | Head       | SMS Type              | <=15          |                           |                 |
   +            +-----------------------+---------------+---------------------------+-----------------+
   |            | Leading Symbol        | 1             | :                         | :               |
   +            +-----------------------+---------------+---------------------------+-----------------+
   |            | IMEI                  | 15            |                           |                 |
   +            +-----------------------+---------------+---------------------------+-----------------+
   |            | LF                    | 1             | \\n                       | \\n             |
   +------------+-----------------------+---------------+---------------------------+-----------------+
   | Location   | Google Maps Hyperlink | N             |                           |                 |
   +            +-----------------------+---------------+---------------------------+-----------------+
   |            | LF                    | 1             | \\n                       | \\n             |
   +------------+-----------------------+---------------+---------------------------+-----------------+
   | Parameters | GNSS Fix State        | 2             | F0 or F1                  |                 |
   +            +-----------------------+---------------+---------------------------+-----------------+
   |            | GNSS UTC Time         | 20            | Dyyyy/mm/ddThh:mm:ss      |                 |
   +            +-----------------------+---------------+---------------------------+-----------------+
   |            | Battery Percentage    | 3-5           | BXX%                      |                 |
   +            +-----------------------+---------------+---------------------------+-----------------+
   |            | Speed                 | 4-6           | SXXX.X                    |                 |
   +------------+-----------------------+---------------+---------------------------+-----------------+

- `SMS Type`

  Used to indicate the cause of the Location SMS, which includes the following types:

  - **LBS**

    Location by SMS. When receiving a **"get position"** command from the SMS, the terminal will respond to this type of Location SMS. This feature can be enabled or disabled by the :ref:`AT@GMS <headlabel-refx-cmd-gms>` command.

  - **IN GEO-i** (i means the ID of Geo-fence)

    When entering a specified Geo-fence, the terminal will send this type of Location SMS to the phone number preset using the :ref:`AT@GML <headlabel-refx-cmd-gml>` command. This feature can be enabled or disabled by the :ref:`AT@GEO <headlabel-refx-cmd-geo>` command.

  - **OUT GEO-i** (i means the ID of Geo-fence)

    When exiting a specified Geo-fence, the terminal will send this type of Location SMS to the phone number preset using the :ref:`AT@GML <headlabel-refx-cmd-gml>` command. This feature can be enabled or disabled by the :ref:`AT@GEO <headlabel-refx-cmd-geo>` command.

- `Leading Symbol`

  1 byte, ASCII character ':'.

- `IMEI`

  The IMEI of the terminal device.

- `LF`

  1 byte. Line Feed, ASCII character '\\n'.

- `Google Maps Hyperlink`

  A Google Maps hyperlink representing the current location.

  For example, `http://maps.google.com/maps?q=22.538503,114.017054` represents a position of 22.538503 degrees latitude and 114.017054 degrees longitude.

- `Parameters`

  The last line contains the following parameters, separated by spaces:

  - **GNSS Fix State**

    Indicates the GNSS fix state. 'F1' means fix, 'F0' means no fix.

  - **GNSS UTC Time**

    20 bytes, the format is 'Dyyyy/mm/ddThh:mm:ss', for example, "D2019/10/26T08:12:00" indicates October 26,2019,08:12:00.

  - **Battery Percentage**

    The current volume of the internal battery in percentage, 'BXX%' format, for example, B90% means 90%.

  - **Speed**

    The current speed. Unit: km/h. Format is 'SXXX.X', for example, S38.6 means 38.6 km/h.