.. _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 I1 S38.6

.. tabularcolumns:: |p{4.8em}|p{10.8em}|p{5.8em}|p{13.9em}|p{3.8em}|

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

   +------------+-----------------------+---------------+----------------------+---------+
   | 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 |         |
   +            +-----------------------+---------------+----------------------+---------+
   |            | Ignition Status       | 2             | I0 or I1             |         |
   +            +-----------------------+---------------+----------------------+---------+
   |            | 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.

  - **Ignition Status**

    The vehicle's current ignition status, 'I1' means ignition on, 'I0' means ignition off.

  - **Speed**

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