🥇Сэрвіс GSM Location модуляў SIM800x і яго праца з API Яндэкс.Лакатар

Google, нажаль для шматлікіх карыстачоў GSM-модуляў, 2-3 месяца назад заблакаваў і перавёў на платную аснову API для вызначэння месцазнаходжання па каардынатах бачных модулем сотавых вышак. З-за гэтага, на модулях серыі SIM800 вытворчасці SIMCom Wireless Solutions, перастаў працаваць функцыянал каманды AT+CIPGSMLOC. У гэтым артыкуле я раскажу Вам як можна вырашыць гэтую праблему скарыстаўшыся аналагічным сэрвісам, які прадастаўляецца Яндэкс – Яндэкс.Лакатар.

Апусцім тое, як Яндэкс атрымлівае каардынаты сотавых вышак, галоўнае, што мы можам скарыстацца гэтым бясплатным сэрвісам і атрымаць наступныя дадзеныя: Latitude, Longitude, Altitude, а таксама прыкладную хібнасць па кожным параметры. Асноўная мэта артыкула - даць невялікі тутарыял па хуткім пераходзе на API ад Яндэкс, замест больш не даступнага сэрвісу ад Google.

Ніжэй, у якасці прыкладу, будзе прыведзена атрыманне толькі шыраты і даўгаты размяшчэння модуля.

Такім чынам, прыступім

Спачатку неабходна прачытаць карыстальніцкае пагадненне, размешчанае па адрасе: yandex.ru/legal/locator_api. Трэба асабліва звярнуць увагу на п.3.6. дадзенага карыстацкага пагаднення, у якім гаворыцца аб тым, што Яндэкс пакідаюць за сабой права змяняць/выпраўляць ці абнаўляць API Яндэкс.Лакатар у любы момант, без папярэдняга паведамлення.

Перайсці па адрасе yandex.ru/dev/locator/keys/get і дадаць свой раней створаны акаўнт Яндэкс да групы распрацоўшчыкаў. Гэтыя дзеянні дазволяць атрымаць ключ для доступу да дадзенага сэрвісу.

Запішыце ці іншым чынам захавайце атрыманы ключ.

Пасля выканання гэтых дзеянняў будзе атрыманы доступ да старонкі yandex.ru/dev/locator/doc/dg/api/geolocation-api-docpage дзе прыведзены асноўныя звесткі аб механізме працы сэрвісу Яндекс.Лакатар.

Для фарміравання XML-запыту ў фармаце cURL да сэрвісаў Яндекс.Лакатар спатрэбіцца атрымаць інфармацыю па «бачным» модулем вышкам сотавай сувязі:

countrycode - код краіны
operatorid – код сеткі моб.сувязі
cellid - ідэнтыфікатар соты
lac - код месцазнаходжання

Дадзеную інфармацыю можна атрымаць ад модуля з дапамогай адпраўкі каманды 'AT+CNETSCAN'.

Інфармацыя атрыманая ад модуля

Operator:"MegaFon",MCC:250,MNC:02,Rxlev:59,Cellid:2105,Arfcn:96,Lac:1E9E,Bsic:31<CR><LF>
Operator:"MegaFon",MCC:250,MNC:02,Rxlev:54,Cellid:2107,Arfcn:18,Lac:1E9E,Bsic:3A<CR><LF>
Operator:"MegaFon",MCC:250,MNC:02,Rxlev:45,Cellid:10A9,Arfcn:97,Lac:1E9E,Bsic:11<CR><LF>
Operator:"MegaFon",MCC:250,MNC:02,Rxlev:41,Cellid:2108,Arfcn:814,Lac:1E9E,Bsic:1F<CR><LF>
Operator:"MegaFon",MCC:250,MNC:02,Rxlev:43,Cellid:5100,Arfcn:13,Lac:1E9E,Bsic:2B<CR><LF>
Operator:"MegaFon",MCC:250,MNC:02,Rxlev:39,Cellid:5102,Arfcn:839,Lac:1E9E,Bsic:1A<CR><LF>
Operator:"MegaFon",MCC:250,MNC:02,Rxlev:38,Cellid:2106,Arfcn:104,Lac:1E9E,Bsic:0A<CR><LF>
Operator:"MegaFon",MCC:250,MNC:02,Rxlev:37,Cellid:0FE7,Arfcn:12,Lac:1E9E,Bsic:24<CR><LF>
Operator:"MegaFon",MCC:250,MNC:02,Rxlev:44,Cellid:14C8,Arfcn:91,Lac:1E9E,Bsic:24<CR><LF>
Operator:"MegaFon",MCC:250,MNC:02,Rxlev:37,Cellid:04B3,Arfcn:105,Lac:1E9E,Bsic:3A<CR><LF>
Operator:"Bee Line GSM",MCC:250,MNC:99,Rxlev:47,Cellid:29A0,Arfcn:70,Lac:39BA,Bsic:09<CR><LF>
Operator:"Bee Line GSM",MCC:250,MNC:99,Rxlev:43,Cellid:0FDD,Arfcn:590,Lac:39BA,Bsic:09<CR><LF>
Operator:"Bee Line GSM",MCC:250,MNC:99,Rxlev:44,Cellid:29A1,Arfcn:84,Lac:39BA,Bsic:10<CR><LF>
Operator:"Bee Line GSM",MCC:250,MNC:99,Rxlev:40,Cellid:8F95,Arfcn:81,Lac:39BA,Bsic:03<CR><LF>
Operator:"Bee Line GSM",MCC:250,MNC:99,Rxlev:43,Cellid:0FDF,Arfcn:855,Lac:39BA,Bsic:24<CR><LF>
Operator:"Bee Line GSM",MCC:250,MNC:99,Rxlev:37,Cellid:299C,Arfcn:851,Lac:39BA,Bsic:17<CR><LF>
Operator:"Bee Line GSM",MCC:250,MNC:99,Rxlev:37,Cellid:0FDE,Arfcn:852,Lac:39BA,Bsic:1B<CR><LF>
Operator:"Bee Line GSM",MCC:250,MNC:99,Rxlev:35,Cellid:299F,Arfcn:72,Lac:39BA,Bsic:10<CR><LF>
Operator:"Bee Line GSM",MCC:250,MNC:99,Rxlev:33,Cellid:28A5,Arfcn:66,Lac:396D,Bsic:25<CR><LF>
Operator:"Bee Line GSM",MCC:250,MNC:99,Rxlev:33,Cellid:2A8F,Arfcn:71,Lac:39BA,Bsic:23<CR><LF>
Operator:"MOTIV",MCC:250,MNC:20,Rxlev:46,Cellid:39D2,Arfcn:865,Lac:4D0D,Bsic:14<CR><LF>
Operator:"MOTIV",MCC:250,MNC:20,Rxlev:36,Cellid:09EE,Arfcn:866,Lac:4D0D,Bsic:25<CR><LF>
Operator:"MOTIV",MCC:250,MNC:20,Rxlev:28,Cellid:09ED,Arfcn:869,Lac:4D0D,Bsic:22<CR><LF>
Operator:"MOTIV",MCC:250,MNC:20,Rxlev:28,Cellid:09EF,Arfcn:861,Lac:4D0D,Bsic:17<CR><LF>
Operator:"MTS",MCC:250,MNC:01,Rxlev:66,Cellid:58FE,Arfcn:1021,Lac:00EC,Bsic:0A<CR><LF>
Operator:"MTS",MCC:250,MNC:01,Rxlev:50,Cellid:58FD,Arfcn:1016,Lac:00EC,Bsic:08<CR><LF>
Operator:"MTS",MCC:250,MNC:01,Rxlev:49,Cellid:58FF,Arfcn:1023,Lac:00EC,Bsic:09<CR><LF>
Operator:"MTS",MCC:250,MNC:01,Rxlev:46,Cellid:F93B,Arfcn:59,Lac:00EC,Bsic:20<CR><LF>
Operator:"MTS",MCC:250,MNC:01,Rxlev:50,Cellid:381B,Arfcn:1020,Lac:00EC,Bsic:0A<CR><LF>
Operator:"MTS",MCC:250,MNC:01,Rxlev:37,Cellid:3819,Arfcn:42,Lac:00EC,Bsic:08<CR><LF>
Operator:"MTS",MCC:250,MNC:01,Rxlev:34,Cellid:4C0F,Arfcn:43,Lac:00EC,Bsic:0A<CR><LF>
Operator:"MTS",MCC:250,MNC:01,Rxlev:33,Cellid:0817,Arfcn:26,Lac:00EC,Bsic:27<CR><LF>
Operator:"MTS",MCC:250,MNC:01,Rxlev:34,Cellid:3A5D,Arfcn:1017,Lac:00E9,Bsic:34<CR><LF>
Operator:"MTS",MCC:250,MNC:01,Rxlev:33,Cellid:3D05,Arfcn:1018,Lac:00EC,Bsic:1F<CR><LF>

Важна адзначыць, што ў наступным запатрабуецца пераўтварэнне дадзеных з адказу модуля аб Cellid і Lac з шаснаццатковага фармату ў дзесятковы.

Цяпер нам трэба сфарміраваць XML-дадзеныя для звароту да сервера Яндэкс, якія, у наступным, будуць аб'яднаны ў адзін элемент.

Табліца дадзеных

Дадзеныя
Каментарыі

xml=<ya_lbs_request><common><version>1.0</version><api_key>

...
Тут павінен змяшчацца 88-значны ключ атрыманы ад Яндэкс

</api_key></common>

<gsm_cells>

<cell><countrycode>

Код краіны (MCC)

</countrycode><operatorid>

Код аператара (MNC)

</operatorid><cellid>

Cellid першай вышкі са спісу атрыманага ад модуля і ператвораны з ліку з падставай 16 у лік з падставай 10 (значэнне атрыманае ад модуля — 2105)

</cellid><lac>

Lac першай вышкі, гэтак жа ператвораны з ліку з падставай 16 у лік з падставай 10 (значэнне атрыманае ад модуля - 1E9E)

</lac></cell>

...

Групу, аб'яднаную тэгам cell можна паўтарыць неабходную колькасць разоў для павышэння дакладнасці пэўнага месцазнаходжання

</gsm_cells>

<ip><address_v4>

10.137.92.60

IP адрас прысвоены модулю сеткай пасля адкрыцця GPRS кантэксту, можна атрымаць даслаўшы ў модуль каманду 'AT+SAPBR=2,1' – гл. ніжэй

</address_v4></ip></ya_lbs_request>

Такім чынам будзе сфарміравана XML-паведамленне даўжынёй 1304 знака наступнага выгляду:

Паведамленне

xml=<ya_lbs_request><common><version>1.0</version><api_key>{здесь необходимо указать свой ключ}</api_key></common><gsm_cells><cell><countrycode>250</countrycode><operatorid>2</operatorid><cellid>8453</cellid><lac>7838</lac></cell><cell><countrycode>250</countrycode><operatorid>2</operatorid><cellid>8455</cellid><lac>7838</lac></cell><cell><countrycode>250</countrycode><operatorid>2</operatorid><cellid>4265</cellid><lac>7838</lac></cell><cell><countrycode>250</countrycode><operatorid>2</operatorid><cellid>8456</cellid><lac>7838</lac></cell><cell><countrycode>250</countrycode><operatorid>2</operatorid><cellid>20736</cellid><lac>7838</lac></cell><cell><countrycode>250</countrycode><operatorid>2</operatorid><cellid>20738</cellid><lac>7838</lac></cell><cell><countrycode>250</countrycode><operatorid>2</operatorid><cellid>8454</cellid><lac>7838</lac></cell><cell><countrycode>250</countrycode><operatorid>2</operatorid><cellid>4071</cellid><lac>7838</lac></cell><cell><countrycode>250</countrycode><operatorid>2</operatorid><cellid>5320</cellid><lac>7838</lac></cell><cell><countrycode>250</countrycode><operatorid>2</operatorid><cellid>1203</cellid><lac>7838</lac></cell></gsm_cells><ip><address_v4>10.137.92.60</address_v4></ip></ya_lbs_request>

Дадзенае паведамленне сфарміравана на базе даных па сотавых вышках аператара Мегафон, яго можна дапоўніць дадзенымі ў т.л. па іншых бачным модулем вышкам атрыманымі па камандзе 'AT+CNETSCAN' для падвышэння дакладнасці выдаваных каардынат.

Праца з модулем і атрыманне бягучых каардынат

АТ-лог працы з модулем

>AT+SAPBR=3,1,”Contype”,”GPRS” // конфигурирование профиля доступа в Интернет
<OK
>AT+SAPBR=3,1,”APN”,”internet” // конфигурирование APN 
<OK
>AT+SAPBR=1,1 // запрос на открытие GPRS контекста
<OK // контекст открыт
>AT+SAPBR=2,1 // запрос текущего IP адреса присвоенного оператором сотовой связи
<+SAPBR: 1,1,”10.137.92.60” // данный IP адрес потребуется вставить в XML-сообщение
<
<OK
>AT+HTTPINIT
<OK
>AT+HTTPPARA=”CID”,1
<OK
>AT+HTTPPARA=”URL”,”http://api.lbs.yandex.net/geolocation”
<OK
>AT+HTTPDATA=1304,10000 // первое число – длина сформированного XML-сообщения
<DOWNLOAD // приглашение к вводу XML-сообщения
< // вводим сформированное нами XML-сообщение
<OK
>AT+HTTPACTION=1
<OK
<
<+HTTPACTION: 1,200,303 // 200 – сообщение отправлено, 303 – получено 303 байт данных
>AT+HTTPREAD=81,10
<+HTTPREAD: 10
<60.0330963 // широта на которой расположен модуль
<OK
>AT+HTTPREAD=116,10
<+HTTPREAD: 10
<30.2484303 // долгота на которой расположен модуль
>AT+HTTPTERM
<OK

Такім чынам мы атрымалі бягучыя каардынаты модуля: 60.0330963, 30.2484304.
З павелічэннем колькасці адпраўленых дадзеных па сотавых вышках будзе прапарцыйна расці дакладнасць вызначэння месцазнаходжання.

Больш падрабязную інфармацыю аб змесце адказу ад сэрвісу Яндекс.Лакатар і выбару неабходных Вам дадзеных можна прачытаць па спасылцы: yandex.ru/dev/locator/doc/dg/api/xml-reply-docpage, у раздзеле API->XML->Адказ

Заключэнне

Спадзяюся гэты матэрыял стане добрай дапамогай распрацоўшчыкам. Гатовы адказаць на Вашы пытанні ў каментарах.

Крыніца: habr.com

Сэрвіс GSM Location модуляў SIM800x і яго праца з API Яндэкс.Лакатар

Такім чынам, прыступім

Праца з модулем і атрыманне бягучых каардынат

Заключэнне

Дадаць каментар Адмяніць адказ