> 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). # Monitor GPS de ativos estacionários com Etiquetas BLE Rastreie ativos estacionários usando Etiquetas BLE anexadas a dispositivos GPS. Configure o dispositivo e a integração de API para monitorar reboques e equipamentos. Qualquer objeto pode ser integrado à Internet das Coisas. A plataforma Navixy permite o rastreamento não apenas de objetos móveis, mas também de objetos 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, vamos discutir 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 Serviço de manutenção subsequente 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 beacons BLE: Galileosky, Quecklink, Ruptela, Teltonika, TopFlyTech\*.\* Descreveremos com base no exemplo de [Teltonika FMB920](https://navixy.com/en/devices/teltonika-telematics/teltonika-fmb920/) modelo e beacon 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 notar que muitas etiquetas BLE podem transmitir informações sobre temperatura e umidade, bem como sua carga de bateria. Isso aprimora a capacidade dessas etiquetas de monitorar 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 uma determinada etiqueta está próxima. Para criar soluções personalizadas para seus usuários usando APIs, você vai 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 do mundo real: rastrear reboques de caminhão para informações de trajeto e uso e o posterior serviço de manutenção. ## Como configurar seu dispositivo Siga estas etapas para configurar seu dispositivo para enviar dados de beacon BLE à plataforma: 1. Baixar [Teltonika Configurator](https://wiki.teltonika-gps.com/view/Teltonika_Configurator_versions). Este aplicativo simplifica muitas 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 guia Sistema, defina o protocolo de dados como Codec 8 Extended. Isso permite que o dispositivo funcione com etiquetas BLE.\ ![How to configure your device](https://1173629567-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-8433b20ef4cd49373258c953fbbde9fea2227af5%2Fimage-20230619-101210.png?alt=media) 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](https://1173629567-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIgDb43gtyXcm1Av4h1np%2Fuploads%2Fgit-blob-9f6aed56b6c024c490422e276f2bcd3fb3add0d5%2Fbrowser_ivSpIqPwoh.png?alt=media) 4. Nas configurações de 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 de Bluetooth 4.0, em Configurações do modo avançado, carregue a predefinição EYE Sensor de acordo com as configurações de pacote no aplicativo 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 No lado da plataforma, há um objeto de entrada de dados de 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": { "voltage": 3.075, "temperature": 24.0 } } ``` Você pode ler informações dele: * `tracker_id` - int. Um ID do rastreador (também conhecido como "object\_id"). * `ID do hardware` - 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 nele, você pode entender quão distante o sinalizador está do dispositivo. * `get_time` - [data/hora](/docs/navixy-api/user-api/getting-started.md#data-types). Quando esses dados forem recebidos. * `latitude` - float. Latitude. * `longitude` - flutuante. Longitude. * `ext_data` - objeto. Dados adicionais do beacon. ### 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/resources/tracking/beacon.md#post-beacon-data-read). Você pode definir os parâmetros "from" e "to" para obter dados durante um período específico sobre beacons BLE conectados. 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": { "voltage": 3.075, "temperature": 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": { "voltage": 3.075, "temperature": 24.0 } ], "success": true } ``` 2\. A segunda chamada recupera informações sobre [beacons atualmente conectados](/docs/navixy-api/user-api/resources/tracking/beacon.md#post-beacon-data-last_values) a um dispositivo específico. Por exemplo, se você quiser saber qual carreta está atualmente próxima ao dispositivo, use a seguinte requisição: Exemplo de requisiçã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á uma carreta "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": { "voltage": 3.075, "temperature": 24.0 } ], "success": true } ``` ## Como obter informações sobre os tempos de uso e detalhes do trajeto Já reunimos dados históricos usando a primeira das chamadas de API apresentadas, que mostrou em quais dispositivos o reboque foi exibido em um momento específico. Para obter informações sobre as viagens e o tempo de uso deste reboque, precisamos usar uma das duas chamadas de API: 1. Chamada de API [track/list](/docs/navixy-api/user-api/resources/tracking/track.md#post-track-list) para obter informações sobre o trajeto no 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", "length": 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 comprimento do Trajeto foi de 18,91 km. 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 o número de quilômetros até a próxima Manutenção do reboque. 2. Se você quiser um registro detalhado de rastreamento 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/resources/tracking/track.md#post-track-read) Solicitação. Isso nos dará dados sobre todos os pontos recebidos pela plataforma durante a viagem.\ Solicitaçã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, Estrada do Condado, Município de Clarence, Condado de Erie, Nova York, Estados Unidos, 14031", "satélites": 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 para este trajeto } ] } ``` Você pode usar esses pontos junto com a API de mapas de sua preferência para exibi-los em um mapa. ## Outros exemplos de uso de Etiquetas BLE e da API do Navixy Aqui estão mais alguns exemplos de como usar Etiquetas BLE com um algoritmo curto 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 há uma cadeirinha infantil disponível em um veículo pode ajudar você a determinar rapidamente quais motoristas são adequados para determinados passageiros e evitar perda de tempo e de 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 duas ou mais crianças e identificar carros equipados com mais de uma cadeirinha infantil. Para lidar com isso, você precisará instalar um beacon BLE em cada cadeirinha infantil. Em seguida, vamos supor que seu aplicativo de reserva 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 o assento está localizado 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, é provável que o assento esteja no porta-malas. Como resultado, você pode priorizar sua busca por veículos: primeiro os que têm uma cadeirinha infantil no compartimento de passageiros e depois os que têm uma cadeirinha infantil no porta-malas. Essa abordagem garante que você faça a correspondência entre passageiros e veículos e motoristas adequados de forma eficiente. ### Maquinário agrícola Suponha que seu cliente tenha maquinário agrícola que possa ser conectado a vários equipamentos. Como você pode acompanhar qual trator está usando uma semeadora e qual tem um arado? Essas informações ajudarão você a entender a frequência e a extensão do uso dos implementos, além de determinar sua localização atual. Dessa forma, os trabalhadores podem passar mais tempo trabalhando no campo em vez de procurar os equipamentos. Para isso, instale dispositivos em tratores e colheitadeiras, bem como nas áreas de armazenamento de ferramentas. Coloque um beacon BLE em cada ferramenta em um local seguro de difícil remoção, 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 com os 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 rastreamento e utilização eficientes do seu equipamento agrícola, aumentando a produtividade. ### Uso em canteiros de obras Canteiros de obras ხშირად têm inúmeras ferramentas e equipamentos caros. Embora instalar uma baliza para fins de rastreamento seja benéfico, surge outra preocupação. Como garantir que o equipamento seja rastreado com frequência e que o dispositivo GPS não fique sem energia? Para monitorar o uso e a localização do equipamento, as balizas 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, bem como nos locais de armazenamento. Essa abordagem permite que você rastreie de forma eficaz seu equipamento valioso, garantindo que ele esteja sendo usado com eficiência 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 com eficácia em ambientes internos usando a plataforma e as Etiquetas BLE. Tudo o que você precisa fazer é instalar dispositivos GPS em diferentes partes do armazém ou edifício 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 qual área um funcionário está ou quantos atendentes de vendas estão perto do balcão de informações. Ter essa informação ajuda a melhorar a eficiência e garante que os membros da equipe estejam onde precisam estar. * **Rastreamento de mercadorias ou máquinas em diferentes áreas do armazém**: Saber a localização das mercadorias ou equipamentos economiza tempo, pois você não precisa procurá-los por todo o armazém. Isso agiliza o processo de retirada, tornando suas operações mais eficientes. ### Rastreamento de mercadorias com balizas BLE Usar balizas BLE para rastreamento pode beneficiar muito as transportadoras, permitindo que determinem qual caminhão está transportando um palete específico de mercadorias em qualquer momento. Esse método não apenas possibilita o rastreamento do percurso das mercadorias, como 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 instância, resulta em um melhor atendimento aos clientes e em processos de negócios mais ágeis. --- # 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 by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` 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 what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. 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.