# Cell ID / LBS

На этой странице приведены инструкции по настройке Cell ID / LBS (службы определения местоположения) в решении Navixy On-Premises. Чтобы узнать больше о назначении этой функции и о том, как её настроить в пользовательском интерфейсе, пожалуйста, обратитесь к соответствующей странице руководства пользователя.

## Настройка функции Cell ID / LBS

Поскольку все операции службы определения местоположения (LBS) выполняются TCP-сервером, активация и настройка этой функции выполняются в файле конфигурации сервиса TCP-сервера, расположенном по адресу `/home/java/tcp-server/conf/config.properties` (для развертываний на Linux).

### Включение функции Cell ID / LBS

Чтобы включить функцию LBS, в файле конфигурации должен присутствовать следующий параметр:

```
geocodingService.lbs.enabled=true
```

В зависимости от версии платформы Navixy и её предыдущих настроек этот параметр может отсутствовать или быть установлен в false. Если параметр отсутствует, его можно добавить отдельной строкой в конце файла конфигурации.

### Интервал обновления

Платформа Navixy по умолчанию отправляет запросы к сервису LBS каждые 20 минут в случаях, когда GPS-сигнал не обновлялся. Однако этот интервал можно изменить, добавив в файл конфигурации следующий параметр (значение указывается в минутах и может быть настроено в соответствии с вашими потребностями):

```
geocodingService.lbs.delay=15m
```

После изменения конфигурации *tcp-server* должен быть перезапущен для применения новых настроек.

## Базы данных LBS

Платформа Navixy предлагает два варианта для служб определения местоположения (LBS): Mozilla Location Services (MLS) и Google LBS. Это задаётся параметром `lbs.service_url` в файле конфигурации tcp-server `/home/java/tcp-server/conf/config.properties` (для развертываний на Linux).

**Вариант 1. Mozilla Location Services (MLS)**

```
lbs.service_url=http://location.services.mozilla.com/v1/geolocate?key=test
```

**Вариант 2. Google LBS**

```
lbs.service_url=https://www.googleapis.com/geolocation/v1/geolocate?key=YOUR_API_KEY
```

### Mozilla Location Services (по умолчанию)

По умолчанию Navixy использует Mozilla Location Services — открытый публичный сервис геолокации, которым может воспользоваться любой желающий для обработки LBS-запросов и получения данных LBS. Несмотря на то, что производительность MLS в целом достаточна, её точность и стабильность не гарантируются.

В некоторых случаях MLS может не возвращать координаты из‑за высокой нагрузки на сервис или отсутствия информации в его базе данных. К сожалению, повлиять на работу сервиса нельзя.

Если вы часто сталкиваетесь с описанной выше проблемой или если производительность MLS в вашей стране недостаточна, а LBS является для вас критически важным, вы можете выбрать коммерческий сервис Google LBS. Этот сервис предоставляет гарантии производительности.

### Google LBS

Чтобы настроить работу Google LBS на платформе, необходимо выполнить следующие шаги:

1. Свяжитесь с Google, чтобы приобрести API-ключ, требующийся для LBS.
2. Добавьте этот ключ в *api-server* конфигурацию: `/home/java/api-server/conf/config.properties`(Linux). Необходимо добавить в конфигурацию следующий параметр (замените KEY на ваш ключ):

```
lbs.google.apiKey=KEY
```

3. Перейдите в панель администратора, откройте *Account management → Service preferences*, и выберите Google в *"Cell ID geolocation"*.

![On-Premise - Maps and GIS - Cell ID - LBS](https://4066122344-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-d1c58382b9bbf07e3c0e31179ee62228c4d68e2e%2Fimage-20230810-133150.png?alt=media)

4. Убедитесь, что в настройках тарифного плана для устройств выбрана опция «Location by Cell ID».

![On-Premise - Maps and GIS - Cell ID - LBS](https://4066122344-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-79532badf32358128abe0bdfa4a46a154ff11922%2Fimage-20230810-133203.png?alt=media)

{% hint style="danger" %}
Обратите внимание, что Google взимает плату за каждый LBS-запрос. При большом количестве устройств, отправляющих данные LBS, использование этого сервиса может оказаться довольно дорогим. Вы можете сократить расходы, ограничив использование сервиса только для конкретных устройств. Для этого создайте план с включённой опцией «Location by Cell ID», отключите эту опцию для всех остальных планов и затем назначьте этот план необходимым устройствам. Запросы к сервису LBS выполняются только для тех устройств, для которых опция активна. Если опция не включена для плана, данные LBS обрабатываться не будут, даже если устройство их отправляет
{% endhint %}