Documentation

Appearance

GNSS&LBS&Wi-Fi Positioning Example ​

Introduction ​

Currently, Developer Center location service supports GNSS positioning, LBS positioning, and Wi-Fi positioning to determine the specific location of the device. This section will introduce how to obtain and report location data to the Developer Center.

  • GNSS Positioning The module connects with an external GNSS module to realize satellite positioning.
  • LBS Positioning LBS Positioning is based on the station positioning system of communication operators.
  • Wi-Fi Positioning A location tracking system based on wireless router signal.
AT CommandDescription
AT+QIOTLOCINObtain/Report Location Data of Built-in Positioning Feature of Module
AT+QIOTLOCEXTReport Location Data Obtained from External GNSS Module

Note: See GNSS&LBS&Wi-Fi Positioning Commands for details.

Procedure ​

Operation on Developer Center ​

1. Log in to Developer Center ​

Log in to Developer Center. If you don't have an account click Register Now to register.

2. Create a Product ​

Creating a product is the first step in product development. A product is an abstract description of a class of devices defined by Developer Center, which is used to manage devices of the same category. For example, if you have an aromatherapy diffuser with LTE networking capability and you need to connect the aromatherapy diffuser to Developer Center to monitor it, you can define it as a product: "Smart Aromatherapy Diffuser".

Example 1 (Obtain location data of the module's built-in positioning feature) ​

  1. Obtain NMEA sentence type of the built-in positioning feature of the module.
c
[TX]AT+QIOTLOCIN?

[RX]+QIOTLOCIN: "AUTO","LBS"

[RX]OK
  1. Obtain the location data of the module through NMEA sentences.
c
[TX]AT+QIOTLOCIN=1,"LBS"

[RX]+QIOTLOCIN: "$LBS,460,02,0,455,-113,0*71"
[RX]+QIOTLOCIN: "$LBS,460,01,0,456,-100,0*69"


[RX]OK

Example 2 (Report location data of the built-in positioning feature of the module) ​

  1. Query the type of the built-in positioning feature of the module.
c
[TX]AT+QIOTLOCIN?

[RX]+QIOTLOCIN: "AUTO","LBS"

[RX]OK
  1. Report location data of the module's built-in positioning feature to Developer Center.
c
[TX]AT+QIOTLOCIN=0,"LBS"

[RX]OK

[RX]+QIOTEVT: 4,10220

Example 3 (Report location data obtained from external GNSS module) ​

  1. Obtain the location data from an external GNSS module b y connecting MCU with the external GNSS module, the GNSS module will print NMEA data to MCU after receiving the positioning data. For example, the NMEA data obtained by GNSS module is $GPGGA,042523.0,3116.552,N,12138.7385,E,1,05,2.6,438.5,M,-28.0,M,,*78" .

  2. Report the obtained location data to Developer Center.

Execute AT+QIOTLOCEXT to report the NMEA data obtained from the external GNSS module to Developer Center.

c
[TX]AT+QIOTLOCEXT="$GPGGA,042523.0,3116.552,N,12138.7385,E,1,05,2.6,438.5,M,-28.0,M,,*78"

[RX]OK

[RX]+QIOTEVT: 4,10220
  1. View device location on Developer Center. Open the "Device Details" page, and click "Location" to view the location data.

img

Example 4 (Obtain location data of the module's Wi-Fi positioning feature) ​

1. Obtain operation type and NMEA data type of the module's Wi-Fi positioning feature

c
[TX]AT+QIOTLOCIN?

[RX]+QIOTLOCIN: "AUTO","WIFI"

[RX]OK

2. Obtain NMEA location data of the module's Wi-Fi positioning feature

c
[TX]AT+QIOTLOCIN=1,"WIFI"

[RX]+QIOTLOCIN: "$WIFI,687724457D14,515545435F574946495F544553542C,-100*2A"


[RX]OK

3. View device location on Developer Center

Open the "Device Details" page, and click "Location" to view the location data.

img

Example 5 (Report location data of the module's Wi-Fi positioning feature) ​

1. Report location data of the module's Wi-Fi positioning feature to Developer Center

c
[TX]AT+QIOTLOCIN=0,"WIFI"

[RX]OK

[RX]+QIOTEVT: 4,10220

2. Developer Center queries the location data of the module's Wi-Fi positioning feature

Open the "Device Details" page, and click "Location" to view the location data.

img