# Cell ID / LBS

Esta página fornece instruções para configurar Cell ID / LBS (serviços baseados em localização) na solução Navixy On-Premises. Para saber mais sobre para que esse recurso é usado e como ele pode ser configurado na interface do usuário, consulte a página correspondente no manual do usuário.

## Configurando a função Cell ID / LBS

Como todas as operações de serviços baseados em localização (LBS) são executadas pelo servidor TCP, a ativação e configuração dessa função é realizada no arquivo de configuração do serviço do servidor TCP, localizado em `/home/java/tcp-server/conf/config.properties` (para implantações Linux).

### Habilitando a função Cell ID / LBS

Para habilitar o recurso LBS, o arquivo de configuração deve incluir o seguinte parâmetro:

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

Dependendo da versão da plataforma Navixy e de suas configurações anteriores, esse parâmetro pode estar ausente ou definido como false. Se o parâmetro estiver faltando, ele pode ser adicionado como uma linha separada na parte inferior do arquivo de configuração.

### Intervalo de atualização

Por padrão, a plataforma Navixy envia solicitações ao serviço LBS a cada 20 minutos quando o sinal de GPS não foi atualizado. No entanto, esse intervalo pode ser ajustado adicionando o seguinte parâmetro ao arquivo de configuração (o valor é especificado em minutos e pode ser personalizado conforme sua necessidade):

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

Depois que a configuração for alterada, o *tcp-server* deve ser reiniciado para aplicar as novas configurações.

## Bancos de dados LBS

A plataforma Navixy oferece duas opções para serviços baseados em localização (LBS): Mozilla Location Services (MLS) e Google LBS. Isso é definido pelo parâmetro `lbs.service_url` no arquivo de configuração do tcp-server `/home/java/tcp-server/conf/config.properties` (para implantações Linux).

**Opção 1. Mozilla Location Services (MLS)**

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

**Opção 2. Google LBS**

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

### Mozilla Location Services (padrão)

Por padrão, a Navixy utiliza o Mozilla Location Services, que é um serviço público aberto de geolocalização que qualquer pessoa pode usar para processar solicitações LBS e obter dados LBS. Embora o desempenho do MLS seja, em geral, suficiente, sua precisão e estabilidade não podem ser garantidas.

Em alguns casos, o MLS pode não retornar as coordenadas devido à alta carga no serviço ou à falta de informações em seu banco de dados. Infelizmente, não há como influenciar o funcionamento do serviço.

Se você encontrar frequentemente o problema descrito acima, ou se o desempenho do MLS for insuficiente em seu país e o LBS for crítico para você, pode optar pelo serviço Google LBS. Este é um serviço comercial que fornece garantias de desempenho.

### Google LBS

Para configurar o funcionamento do Google LBS na plataforma, é necessário realizar os seguintes passos:

1. Contatar o Google para adquirir a chave de API necessária para o LBS.
2. Adicionar essa chave à *api-server* configuração: `/home/java/api-server/conf/config.properties`(Linux). É necessário adicionar o seguinte parâmetro à configuração (substitua KEY pela sua chave):

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

3. Acesse o painel administrativo, abra *Account management → Service preferences*, e selecione Google em *"Cell ID geolocation"*.

![On-Premise - Maps and GIS - Cell ID - LBS](https://645322942-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. Certifique-se de que "Location by Cell ID" esteja selecionado nas configurações do plano tarifário para os dispositivos.

![On-Premise - Maps and GIS - Cell ID - LBS](https://645322942-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" %}
Observe que o Google cobra uma taxa por cada solicitação LBS. Com um grande número de dispositivos enviando dados LBS, o uso desse serviço pode ser bastante caro. Você pode reduzir os custos limitando o uso desse serviço apenas a dispositivos específicos. Para isso, crie um plano com a opção "Location by Cell ID" habilitada, desative essa opção para todos os outros planos e então atribua esse plano aos dispositivos necessários. As solicitações ao serviço LBS são realizadas apenas para aqueles dispositivos para os quais a opção esteja ativa. Se a opção não estiver habilitada para um plano, os dados LBS não serão processados, mesmo que o dispositivo os envie
{% endhint %}