שירות מיקום GSM של מודולי SIM800x ועבודתו עם ה-API של Yandex.Locator

גוגל, למרבה הצער עבור משתמשים רבים של מודולי GSM, לפני 2-3 חודשים חסמה והעבירה לבסיס בתשלום את ה-API לקביעת מיקום על סמך הקואורדינטות של מגדלים סלולריים הנראים למודול. בגלל זה, על מודולים מסדרת SIM800 מיוצרים פתרונות אלחוטיים של SIMCom, הפונקציונליות של הפקודה AT+CIPGSMLOC הפסיקה לפעול. במאמר זה אספר לך כיצד תוכל לפתור בעיה זו על ידי שימוש בשירות דומה המסופק על ידי Yandex - Yandex.Locator.

בואו נדלג איך Yandex מקבל את הקואורדינטות של מגדלים סלולריים, העיקר שנוכל להשתמש בשירות החינמי הזה ולקבל את הנתונים הבאים: קו רוחב, קו אורך, גובה, כמו גם השגיאה המשוערת עבור כל פרמטר. המטרה העיקרית של המאמר היא לתת מדריך קצר על מעבר מהיר ל-Yandex API, במקום השירות שכבר לא זמין מגוגל.

להלן, כדוגמה, נציג רק את קו הרוחב והאורך של מיקום המודול.

אז בואו נתחיל

ראשית עליך לקרוא את הסכם המשתמש שנמצא בכתובת: 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, תצטרך לקבל מידע על מגדלים סלולריים ה"גלויים" על ידי המודול:

• קוד מדינה - קוד מדינה
• 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

תא של המגדל הראשון מהרשימה שהתקבל מהמודול והומר ממספר עם בסיס 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-> תגובה

מסקנה

אני מקווה שהחומר הזה יעזור למפתחים. אני מוכן לענות על שאלותיך בתגובות.

מקור: www.habr.com