Locator是一種高效定位技術，該功能通過移動網絡小區(qū)的信息實現定位功能。

本文將以利爾達NT26U模組為例，詳細介紹Locator相關的AT命令。

Locator鑒權：使用Locator定位服務，需要用于身份驗證的授權Token。重啟模組或關機后，授權Token仍然有效。AT+QLBSCFG="Token"用于查看首次使用該服務時是否已經配置了Token值。若未配置，請輸入Token值。具體步驟如下圖所示。

Locator授權Token配置

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

Locator相關AT命令詳解

01

AT命令說明

1、定義

2、AT命令語句

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

AT命令及響應類型

02

AT聲明

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

03

Locator AT命令詳解

1、AT+QLBSCFG 配置Locator

該命令用于查詢/設置Locator AT相關配置信息。

注：

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

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

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

2、AT+QLBS通過Locator獲取位置信息

該命令用于通過Locator獲取位置信息。

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

平臺側操作

用戶在使用模組進行Locator定位時，需要申請并配置Token值，這里給出利爾達X平臺定位服務器的環(huán)境搭建流程和使用指導。

01

平臺登錄

登陸利爾達X平臺：

https://account.xiot.senthink.com/，未注冊的用戶可使用手機號和郵箱進行注冊，登錄后點擊“控制臺”。

控制臺

02

Token值獲取

模組定位服務

登陸后平臺界面如上圖所示，點擊“模組定位服務”進入該窗口界面，開通服務后獲取Token值如下圖所示：

利爾達X平臺獲取Token值

使用LBS定位服務時，必須先申請并配置Token值后再使用，否則定位次數會受到限制。

模組側操作

01

上電流程檢查

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

02

激活網絡

AT+CGACT=1//模組上電后，激活模組網絡

+CGACT: 1, 1, 100.87.213.174

OK

03

LBS定位示例

向上滑動閱覽

AT+QLBSCFG="token"

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

DF714C72"http://配置利爾達定位服務器Token值
OK

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

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

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

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

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

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

錯誤碼

值描述

術語縮寫