Locator是一種高效定位技術(shù)，該功能通過(guò)移動(dòng)網(wǎng)絡(luò)小區(qū)的信息實(shí)現(xiàn)定位功能。

本文將以利爾達(dá)NT26U模組為例，詳細(xì)介紹Locator相關(guān)的AT命令。

Locator鑒權(quán)：使用Locator定位服務(wù)，需要用于身份驗(yàn)證的授權(quán)Token。重啟模組或關(guān)機(jī)后，授權(quán)Token仍然有效。AT+QLBSCFG="Token"用于查看首次使用該服務(wù)時(shí)是否已經(jīng)配置了Token值。若未配置，請(qǐng)輸入Token值。具體步驟如下圖所示。

Locator授權(quán)Token配置

注：為方便閱讀，本文AT示例省略了部分回車換行，實(shí)際返回值以《AT指令手冊(cè)》或模組實(shí)測(cè)為準(zhǔn)。

Locator相關(guān)AT命令詳解

01

AT命令說(shuō)明

1、定義

2、AT命令語(yǔ)句

前綴AT或at必須加在每個(gè)命令行的開頭。輸入將終止命令行。通常，命令后面跟隨形式為的響應(yīng)。在本文檔中表現(xiàn)命令和響應(yīng)的表格中，省略了，僅顯示命令和響應(yīng)。

AT命令及響應(yīng)類型

02

AT聲明

本文中的示例僅為方便用戶了解AT命令的使用方法，不構(gòu)成利爾達(dá)對(duì)終端流程設(shè)計(jì)的建議或意見，也不代表模組應(yīng)被設(shè)置成相應(yīng)示例中的狀態(tài)。某些AT命令存在多個(gè)示例，這些示例之間不存在承接關(guān)系或連續(xù)性。

03

Locator AT命令詳解

1、AT+QLBSCFG 配置Locator

該命令用于查詢/設(shè)置Locator AT相關(guān)配置信息。

注：

1.一般無(wú)需配置服務(wù)器域名/IP地址和端口，默認(rèn)地址為：“http://locator-aep.xiot.senthink.com/locator/v0.1/locate”。用戶如需使用其他服務(wù)器，可使用AT+QLBSCFG="server"配置服務(wù)器域名/IP地址和端口。和的值自動(dòng)保存，其他參數(shù)值不保存，重啟后丟失。

2.若需從Locator服務(wù)器獲取時(shí)間，可在模組開機(jī)時(shí)執(zhí)行AT+QLBSCFG="withTime"獲取時(shí)間信息。

3.若需要更新當(dāng)前ME時(shí)間，需在執(zhí)行AT+QLBS前執(zhí)行AT+QLBSCFG="timeUpdate",1。

2、AT+QLBS通過(guò)Locator獲取位置信息

該命令用于通過(guò)Locator獲取位置信息。

注：Locator支持Wi-Fi輔助定位。對(duì)于不支持自動(dòng)Wi-Fi掃描的模組，也可以通過(guò) AT 命令手動(dòng)輸入Wi-Fi信息以獲取位置信息。

平臺(tái)側(cè)操作

用戶在使用模組進(jìn)行Locator定位時(shí)，需要申請(qǐng)并配置Token值，這里給出利爾達(dá)X平臺(tái)定位服務(wù)器的環(huán)境搭建流程和使用指導(dǎo)。

01

平臺(tái)登錄

登陸利爾達(dá)X平臺(tái)：

https://account.xiot.senthink.com/，未注冊(cè)的用戶可使用手機(jī)號(hào)和郵箱進(jìn)行注冊(cè)，登錄后點(diǎn)擊“控制臺(tái)”。

控制臺(tái)

02

Token值獲取

模組定位服務(wù)

登陸后平臺(tái)界面如上圖所示，點(diǎn)擊“模組定位服務(wù)”進(jìn)入該窗口界面，開通服務(wù)后獲取Token值如下圖所示：

利爾達(dá)X平臺(tái)獲取Token值

使用LBS定位服務(wù)時(shí)，必須先申請(qǐng)并配置Token值后再使用，否則定位次數(shù)會(huì)受到限制。

模組側(cè)操作

01

上電流程檢查

AT//判斷模組是否上電開機(jī)成功
AT+CPIN?//判斷是否讀取SIM卡成功
AT+CEREG?//判斷PS域附著狀態(tài)，第二個(gè)參數(shù)為1或5表示附著正常

02

激活網(wǎng)絡(luò)

AT+CGACT=1//模組上電后，激活模組網(wǎng)絡(luò)

+CGACT: 1, 1, 100.87.213.174

OK

03

LBS定位示例

向上滑動(dòng)閱覽

AT+QLBSCFG="token"

+QLBSCFG: "token",""
OK
AT+QLBSCFG="token","B84E427D95B1DF4A3F49B18D

DF714C72"http://配置利爾達(dá)定位服務(wù)器Token值
OK

AT+QLBSCFG="token"http://查詢利爾達(dá)定位服務(wù)器的Token值
+QLBSCFG: "Token","****************"
OK

AT+QLBSCFG="latOrder",1//將位置輸出順序設(shè)置為：
+QLBS:,,
OK

AT+QLBS//通過(guò)(多基站)三角測(cè)量法獲取位置信息
+QLBS:0,119.98743569863267,30.27717016278133
OK

AT+QLBSCFG="asynch",1//配置為異步定位模式(該指令執(zhí)行后在定位結(jié)果回復(fù)前可發(fā)送其他指令)
OK

AT+QLBS//通過(guò)(多基站)三角測(cè)量法獲取位置信息
OK//返回OK后可執(zhí)行其他AT命令+QLBS:0,119.98743569863267,30.27717016278133

注：用戶使用AT指令進(jìn)行LBS定位配置時(shí)，所有參數(shù)部分的配置指令注意區(qū)分大小寫。

錯(cuò)誤碼

值描述

術(shù)語(yǔ)縮寫