> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/expert-center/pt-br/faq-and-troubleshooting/access-iot-data/gps-tracking-of-stationary-assets-with-ble-tags.md). # Rastreamento por GPS de ativos estacionários com etiquetas BLE Qualquer Objeto pode ser integrado à Internet das Coisas. A plataforma Navixy permite rastrear não apenas Objetos móveis, mas também os estacionários, como equipamentos pesados, equipamentos agrícolas, cargas, mercadorias ou equipamentos de Segurança. Instalar dispositivos GPS em cada um desses Objetos pode ser muito caro. Em vez disso, é mais econômico instalar um dispositivo em um veículo ou local e rastrear todos os outros com Etiquetas BLE mais baratas. Neste tutorial, discutiremos como organizar o rastreamento de Objetos estacionários, quais dispositivos GPS e Etiquetas ajudarão a coletar os dados necessários e como configurá-los usando reboques de caminhão como exemplo. Também abordaremos como obter informações sobre Viagens e uso para posterior Serviço de manutenção e quais chamadas de API fornecerão informações sobre as Etiquetas. Além disso, compartilharemos outros casos de uso com base em situações reais. ## O que você precisa para rastrear Objetos estacionários Vários dispositivos são capazes de ler dados de sinalizadores BLE: Galileosky, Quecklink, Ruptela, Teltonika, TopFlyTech\*.\* Descreveremos com base no exemplo de [Teltonika FMB920](https://www.navixy.com/devices/teltonika/teltonika-fmb920/) modelo e sinalizador BLE [Eye Sensor](https://teltonika-gps.com/products/accessories/sensors-beacons/eye).\ Para começar a rastrear Objetos estacionários, você precisará do seguinte: 1. Um dispositivo GPS que possa ler Etiquetas BLE e seja compatível com a plataforma. 2. Etiquetas BLE que sejam compatíveis com o dispositivo GPS.\ Vale destacar que muitas Etiquetas BLE podem transmitir informações sobre temperatura e umidade, além de sua carga de bateria. Isso amplia a capacidade dessas Etiquetas de rastrear informações, mas, para o nosso propósito, vamos nos concentrar especificamente em Objetos estacionários. 3. APIs da plataforma que fornecem informações sobre qual dispositivo GPS está próximo de uma determinada etiqueta. Para criar soluções personalizadas para seus usuários usando APIs, você precisará de desenvolvedores. Os clientes normalmente contratam seus próprios desenvolvedores ou terceirizam equipes de terceiros. Agora vamos examinar o procedimento para implementar um estudo de caso real: rastreamento de reboques de caminhão para informações de trajeto e uso e para o subsequente Serviço de manutenção. ## Como configurar seu dispositivo Siga estas etapas para configurar seu dispositivo para enviar dados de beacon BLE para a plataforma: 1. Baixar [Teltonika Configurator](https://wiki.teltonika-gps.com/view/Teltonika_Configurator_versions). Este aplicativo simplifica várias configurações de uma só vez. Você pode salvar a predefinição e usá-la no FOTA Web para configurar outros dispositivos, tornando o processo mais conveniente. 2. Na aba Sistema, defina o Protocolo de dados como Codec 8 Extended. Isso permite que o dispositivo funcione com etiquetas BLE.\ ![How to configure your device](/files/8068b161e07f5c2e3aebbd530f8d240f2051a425) 3. Ative o Bluetooth nas configurações de Bluetooth e escolha uma das opções **Ativar (oculto)** ou **Ativar (visível)**. Caso contrário, o Bluetooth será desativado.\ ![How to configure your device](/files/b417f10ff59224154aa87ad4dbb5b03a90e2fbcb) 4. Nas configurações do Bluetooth 4.0, desative a varredura contínua e configure a Frequência de atualização e a Duração da varredura para 30 segundos. Essas configurações otimizam a varredura BLE com o dispositivo. 5. Nas configurações avançadas do Bluetooth 4.0, carregue a predefinição EYE Sensor de acordo com as configurações de pacote no app EYE. 6. Configure o endereço MAC do sensor. O dispositivo agora está pronto para transmitir dados das Etiquetas próximas para a plataforma. ## Como obter informações sobre beacons BLE próximos ao dispositivo GPS Do lado da plataforma, há um Objeto de entrada de dados do beacon BLE: ```json { "tracker_id": 10181654, "hardware_id": "7cf9501df3d6924e423cabcde4c924ff", "rssi": -101, "get_time": "2023-04-17 17:14:42", "latitude": 50.3487321, "longitude": 7.58238, "ext_data": { "tensão": 3,075, "temperatura": 24,0 } } ``` Você pode ler informações dele: * `tracker_id` - int. Um ID do rastreador (também conhecido como "object\_id"). * `hardware_id` - string. Um ID do beacon. * `rssi` - int. RSSI significa indicador de intensidade do sinal recebido e representa a potência do sinal recebido em um dispositivo. Com base nisso, você pode entender quão longe o beacon está do dispositivo. * `get_time` - [data/hora](/docs/navixy-api/user-api/backend-api.md#data-types). Quando esses dados foram recebidos. * `latitude` - float. Latitude. * `longitude` - float. Longitude. * `ext_data` - objeto. Dados adicionais da baliza. ### Chamadas de API para obter informações sobre Etiquetas BLE Há duas chamadas de API que permitem obter todas as informações necessárias sobre beacons BLE: 1. A primeira chamada recupera [dados históricos dos dispositivos](/docs/navixy-api/user-api/backend-api/resources/tracking/beacon/index.md#read). Você pode definir os parâmetros "from" e "to" para obter dados durante um período específico sobre beacons BLE conectadas. Como precisamos das informações do ponto de vista das Etiquetas BLE, ou seja, dos reboques, vamos solicitar as informações usando o parâmetro "beacons".\ Exemplo de solicitação: {% code overflow="wrap" %} ```sh curl -X POST 'https://api.navixy.com/v2/beacon/data/read' \ -H 'Content-Type: application/json' \ -d '{"hash":"59be129c1855e34ea9eb272b1e26ef1d","from": "2023-04-17 17:00:00","to": "2023-04-17 18:00:00","beacons": ["7cf9501df3d6924e423cabcde4c924ff"]}' ``` {% endcode %} Isso mostrará quais dispositivos estavam nas proximidades deste beacon BLE durante o período. Resposta: ```json { "list": [ { "tracker_id": 10181654, "hardware_id": "7cf9501df3d6924e423cabcde4c924ff", "rssi": -101, "get_time": "2023-04-17 17:05:42", "latitude": 50.3487321, "longitude": 7.58238, "ext_data": { "tensão": 3,075, "temperatura": 24,0 } },{//outros objetos por período }, { "tracker_id": 10181654, "hardware_id": "7cf9501df3d6924e423cabcde4c924ff", "rssi": -101, "get_time": "2023-04-17 17:40:22", //um último ponto por período "latitude": 55.348890, "longitude": 6.59403, "ext_data": { "tensão": 3,075, "temperatura": 24,0 } ], "success": true } ``` 2\. A segunda chamada recupera informações sobre [balizas atualmente conectadas](/docs/navixy-api/user-api/backend-api/resources/tracking/beacon/index.md#last-values) a um dispositivo específico. Por exemplo, se você quiser saber qual reboque está atualmente próximo ao dispositivo, use a seguinte solicitação: Exemplo de solicitação: {% code overflow="wrap" %} ```sh curl -X POST 'https://api.navixy.com/v2/beacon/data/last_values' \ -H 'Content-Type: application/json' \ -d '{"hash":"59be129c1855e34ea9eb272b1e26ef1d", "devices": [10181654], "skip_older_than_seconds": 1200} ``` {% endcode %} Isso fornecerá informações de que há um reboque "7cf..." ao lado do dispositivo. Resposta: ```json { "list": [ { "tracker_id": 10181654, "hardware_id": "7cf9501df3d6924e423cabcde4c924ff", "rssi": -101, "get_time": "2023-04-17 17:40:22", "latitude": 55.348890, "longitude": 6.59403, "ext_data": { "tensão": 3,075, "temperatura": 24,0 } ], "success": true } ``` ## Como obter informações sobre tempos de uso e detalhes do Trajeto Já coletamos dados históricos usando a primeira das chamadas de API apresentadas, que mostrou em quais dispositivos o reboque foi exibido em um horário específico. Para obter informações sobre os trajetos e o tempo de uso desse reboque, precisamos usar uma das duas chamadas de API: 1. chamada de API [track/list](/docs/navixy-api/user-api/backend-api/resources/tracking/track/index.md#list) para obter informações do trajeto para o período. Isso fornecerá informações gerais sobre as viagens, como onde e quando começaram e terminaram, velocidade máxima, Quilometragem e muito mais.\ Solicitação: {% code overflow="wrap" %} ```sh curl -X POST 'https://api.navixy.com/v2/track/list' \ -H 'Content-Type: application/json' \ -d '{"hash": "59be129c1855e34ea9eb272b1e26ef1d", "tracker_id": 10181654, "from": "2023-04-17 17:00:00","to": "2023-04-17 18:00:00", "split": true, "limit": 3000, "filter": true, "include_gsm_lbs": true}' ``` {% endcode %} Resposta: ```json { "id": 11672, "start_date": "2023-04-17 17:05:42", "start_address": "10470, County Road, Town of Clarence, Erie County, New York, United States, 14031", "max_speed": 62, "end_date": "2023-04-17 17:40:22", "end_address": "Fast Teddy's, 221, Main Street, Cidade de Tonawanda, Nova York, Estados Unidos, 14150", "comprimento": 18,91, "pontos": 59, "avg_speed": 49, "event_count": 3, "norm_fuel_consumed": 6,32, "type": "regular", "GSM_LBS": false } ``` A partir desses dados, podemos ver que o trajeto durou quase 35 minutos (end\_date - start\_date), com uma velocidade média de 49 km/h e uma velocidade máxima de 62 km/h. O trajeto teve 18,91 km de comprimento. Essas informações nos permitem determinar quanto pagar ao motorista pelo transporte da carga, se a velocidade contratual foi excedida e outros detalhes. Além disso, o comprimento do trajeto pode ser usado no futuro para calcular a quantidade de quilômetros até a próxima manutenção do reboque. 2. Se você quiser um registro detalhado do trajeto do reboque onde o beacon está instalado para exibi-lo em um relatório, por exemplo, você pode usar o [rastrear/ler](/docs/navixy-api/user-api/backend-api/resources/tracking/track/index.md#read) Requisição. Isso nos fornecerá dados sobre todos os pontos recebidos pela plataforma durante a viagem.\ Requisição: {% code overflow="wrap" %} ```sh curl -X POST 'https://api.navixy.com/v2/track/read' \ -H 'Content-Type: application/json' \ -d '{"hash": "22eac1c27af4be7b9d04da2ce1af111b", "tracker_id": 10181654, "from": "2023-04-17 17:00:00","to": "2023-04-17 18:00:00", "filter": true}' ``` {% endcode %} Resposta: ```json { "success": true, "limit_exceeded": true, "list": [ { "address": "10470, County Road, Town of Clarence, Erie County, New York, United States, 14031", "satellites": 10, "Quilometragem": 0, "heading": 173, "speed": 42, "get_time": "2023-04-17 17:05:42", "alt": 0, "lat": 43.0318683, "lng": -78.5985733 }, {//outros objetos de ponto deste trajeto } ] } ``` Você pode usar esses pontos junto com sua API de mapas preferida para exibi-los em um mapa. ## Outros exemplos de uso de etiquetas BLE e da API da Navixy Aqui estão alguns outros exemplos de como usar etiquetas BLE com um algoritmo simples para obter os resultados de que você precisa: ### Cadeirinhas infantis Cadeirinhas infantis são obrigatórias para passageiros que viajam com crianças. Se você ou o usuário opera um serviço de transporte de passageiros, saber se uma cadeirinha infantil está disponível em um veículo pode ajudar você a determinar rapidamente quais Motoristas são adequados para determinados passageiros e evitar desperdiçar tempo e Combustível. Você também pode descobrir qual Motorista atualmente tem uma cadeirinha infantil instalada em seu veículo. Além disso, é importante considerar passageiros com dois ou mais filhos e identificar carros equipados com mais de uma cadeirinha infantil. Para resolver isso, você precisará instalar um beacon BLE em cada cadeirinha infantil. Em seguida, digamos que seu aplicativo de reservas de transporte precise solicitar informações de todos os Motoristas que tenham uma cadeirinha infantil instalada. Para fazer isso, use a chamada de API beacon/last\_values para reunir informações sobre quais Motoristas podem ser atribuídos a um pedido específico. Você também pode usar o parâmetro RSSI para determinar se a cadeirinha está localizada dentro do veículo ou no porta-malas. Para fazer isso, você precisará realizar alguns testes. Por exemplo, se o valor de RSSI for menor no compartimento de passageiros do que no porta-malas, a cadeirinha provavelmente está no porta-malas. Como resultado, você pode priorizar sua busca por veículos: primeiro aqueles com uma cadeirinha no compartimento de passageiros e depois aqueles com uma cadeirinha no porta-malas. Essa abordagem garante que você associe com eficiência os passageiros aos veículos e motoristas adequados. ### Máquinas agrícolas Suponha que seu cliente tenha máquinas agrícolas que podem ser conectadas a vários equipamentos. Como você pode rastrear qual trator está usando uma semeadora e qual está com um arado? Essas informações ajudarão você a entender a frequência e a extensão do uso das ferramentas, além de determinar sua localização atual. Dessa forma, os trabalhadores podem passar mais tempo trabalhando no campo em vez de procurar equipamentos. Para isso, instale dispositivos em tratores e colheitadeiras, bem como nas áreas de armazenamento de ferramentas. Coloque um sinalizador BLE em cada ferramenta em um local seguro, onde seja difícil removê-lo, evitando que ela se perca durante o trabalho. Em seguida, para determinar há quanto tempo as ferramentas estão em uso, consulte a `beacon/read` chamada de API. As informações da resposta serão úteis, assim como no caso dos reboques em nosso exemplo detalhado. Para determinar a localização de uma ferramenta específica, consulte `beacon/last_values` com uma busca por beacons para identificar onde e em qual dispositivo a ferramenta está instalada. Essa abordagem garante um rastreamento eficiente e o uso adequado do seu equipamento agrícola, aumentando, por fim, a produtividade. ### Uso em canteiros de obras Os canteiros de obras frequentemente têm muitas ferramentas e equipamentos caros. Embora a instalação de um sinalizador para fins de rastreamento seja benéfica, surge outra preocupação. Como você pode garantir que o equipamento seja rastreado com frequência e que o dispositivo GPS não fique sem bateria? Para monitorar o uso e a localização do equipamento, os sinalizadores BLE também podem ser úteis. A solução para canteiros de obras pode ser semelhante à de máquinas agrícolas: instale dispositivos nas máquinas, assim como nos locais de armazenamento. Essa abordagem permite rastrear com eficácia seu equipamento valioso, garantindo que ele esteja sendo usado de forma eficiente e minimizando o risco de perda ou extravio. Ao acompanhar de perto suas ferramentas e máquinas, você pode otimizar a produtividade no canteiro de obras. ### Rastreamento interno Você pode rastrear itens em ambientes internos de forma eficaz usando a plataforma e etiquetas BLE. Tudo o que você precisa fazer é instalar dispositivos GPS em diferentes partes do armazém ou do prédio e etiquetar os objetos que deseja rastrear. Aqui estão alguns exemplos: * **Rastreamento de funcionários em várias áreas de um armazém ou loja**: Isso permite que você saiba em que área um funcionário está ou quantos assistentes de vendas estão perto do balcão de informações. Ter essas informações ajuda a melhorar a eficiência e garante que os funcionários estejam onde precisam estar. * **Rastreamento de mercadorias ou máquinas em diferentes áreas do armazém**: Saber a localização de mercadorias ou equipamentos economiza tempo, pois você não precisa procurá-los em todo o armazém. Isso agiliza o processo de retirada, tornando suas operações mais eficientes. ### Rastreamento de mercadorias com beacons BLE Usar beacons BLE para rastreamento pode beneficiar muito as empresas de transporte, permitindo que determinem qual caminhão está transportando um palete específico de mercadorias em qualquer momento. Esse método não apenas permite o rastreamento das rotas das mercadorias, mas também ajuda a calcular os custos de transporte com mais precisão. Ao adotar essa abordagem inovadora, as empresas de transporte podem aprimorar suas operações, tornando-as mais eficientes e precisas. Isso, em última análise, resulta em um serviço melhor para os clientes e em processos de negócios mais simplificados. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://navixy.com/docs/expert-center/pt-br/faq-and-troubleshooting/access-iot-data/gps-tracking-of-stationary-assets-with-ble-tags.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.