GSM услуга за местоположение на SIM800x модули и нейната работа с Yandex.Locator API

Google, за съжаление за много потребители на GSM-модули, преди 2-3 месеца блокира и прехвърли на платена основа API за определяне на местоположението чрез координатите на клетъчните кули, видими от модула. Поради това се произвеждат модули от серията SIM800 SIMCom безжични решения, функционалността на командата AT+CIPGSMLOC спря да работи. В тази статия ще ви кажа как можете да разрешите този проблем, като използвате подобна услуга, предоставена от Yandex - Yandex.Locator.

Нека пропуснем как Yandex получава координатите на клетъчните кули, основното е, че можем да използваме тази безплатна услуга и да получим следните данни: географска ширина, дължина, надморска височина, както и приблизителна грешка за всеки параметър. Основната цел на статията е да даде малък урок за това как бързо да преминете към API от Yandex, вместо вече недостъпната услуга от Google.

По-долу, като пример, ще бъдат получени само географската ширина и дължина на местоположението на модула.

Така че нека започваме

Първо трябва да прочетете потребителското споразумение, намиращо се на: yandex.ru/legal/locator_api. Особено внимание трябва да се обърне на точка 3.6. от това потребителско споразумение, което гласи, че Yandex си запазва правото да променя/коригира или актуализира API на Yandex.Locator по всяко време без предизвестие.

Отидете на адреса yandex.ru/dev/locator/keys/get и добавете създадения преди това акаунт в Yandex към групата за разработчици. Тези стъпки ще ви позволят да получите ключ за достъп до тази услуга.

Запишете или по друг начин запазете получения ключ.

След като изпълните тези стъпки, ще получите достъп до страницата. yandex.ru/dev/locator/doc/dg/api/geolocation-api-docpage който предоставя основна информация за механизма на работа на услугата Yandex.Locator.

За да генерирате XML заявка във формат cURL към услугите на Yandex.Locator, ще трябва да получите информация за клетъчните кули, „видими“ от модула:

• 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 данни за достъп до сървъра на Yandex, които по-късно ще бъдат комбинирани в един елемент.

таблица с данни

Данни
Коментар

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

...
Това трябва да съдържа 88-цифрен ключ, получен от Yandex

</api_key></common>

<gsm_cells>

<cell><countrycode>

250

Код на държавата (MCC)

</countrycode><operatorid>

2

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

</operatorid><cellid>

8453

Cellid на първата кула в списъка, получена от модула и преобразувана от число с основа 16 в число с основа 10 (стойността, получена от модула, е 2105)

</cellid><lac>

7838

Lac на първата кула, също преобразувана от число с основа 16 в число с основа 10 (стойността, получена от модула е 1E9E)

</lac></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>

Това съобщение е генерирано в базата данни на клетъчните кули на оператора Megafon, може да бъде допълнено с данни, вкл. върху други кули, видими от модула, получен от командата 'AT + CNETSCAN', за да се увеличи надеждността на изходните координати.

Работа с модула и получаване на текущи координати

AT-дневник на работа с модула

>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.Locator и избора на необходимите данни можете да намерите на връзката: yandex.ru/dev/locator/doc/dg/api/xml-reply-docpage, под API->XML->Response

Заключение

Надявам се, че този материал ще бъде добра помощ за разработчиците. Готови да отговорите на вашите въпроси в коментарите.

Източник: www.habr.com