> 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 GPS de ativos estacionários com tags BLE Qualquer objeto pode ser integrado à Internet das Coisas. A plataforma permite rastrear não apenas objetos móveis, mas também objetos estacionários, como equipamentos pesados, equipamentos agrícolas, carga, 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 demais 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 carretas de caminhão como exemplo. Também abordaremos como obter informações sobre viagens e uso para trabalhos de manutenção subsequentes 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 conseguem ler dados de beacons BLE: Galileosky, Quecklink, Ruptela, Teltonika, TopFlyTech\*.\* Descreveremos com base no exemplo de [Teltonika FMB920](https://www.navixy.com/devices/teltonika/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 compatíveis com o dispositivo GPS.\ Vale observar que muitas etiquetas BLE podem transmitir informações sobre temperatura e umidade, bem como a carga da 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 forneçam 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 caso real - rastreamento de carretas de caminhão para obter informações de viagem e uso e para trabalhos de manutenção subsequentes. ## Como configurar seu dispositivo Siga estas etapas para configurar seu dispositivo para enviar dados de beacon BLE à plataforma: 1. Baixe [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/2eecb4e807a0c975047176ccbb899741b500e892) 3. Ative o Bluetooth nas configurações de Bluetooth e escolha "Enable (hidden)" ou "Enable (visible)". Caso contrário, o Bluetooth ficará desativado.\ ![How to configure your device](/files/9e1c15502cac896a8c97d27e0ae02292b85b9000) 4. Nas configurações de Bluetooth 4.0, desative o Non-Stop Scan e configure a Update Frequency e a Scan Duration como 30 segundos. Essas configurações otimizam a varredura BLE com o dispositivo. 5. Nas configurações Advanced Mode Settings do Bluetooth 4.0, 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 à plataforma os dados das etiquetas próximas. ## Como obter informações sobre beacons BLE próximos ao dispositivo GPS Do 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 as informações dele: * `tracker_id` - int. Um ID do rastreador (também chamado de "object\_id"). * `hardware_id` - string. Um ID do beacon. * `rssi` - int. RSSI significa received signal strength indicator e representa a potência do sinal recebido em um dispositivo. Com base nisso, você pode entender a que distância o beacon está do rastreador. * `get_time` - [data/hora](https://www.navixy.com/docs/navixy-api/user-api/backend-api#data-types). Quando esses dados foram recebidos. * `latitude` - float. Latitude. * `longitude` - float. Longitude. * `ext_data` - object. 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](https://www.navixy.com/docs/navixy-api/user-api/backend-api/resources/tracking/beacon/index#read). Você pode definir os parâmetros "from" e "to" para obter dados durante um período específico sobre os beacons BLE conectados. Como precisamos das informações do ponto de vista das etiquetas BLE, ou seja, das carretas, 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 desse 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 } },{//other objects per period }, { "tracker_id": 10181654, "hardware_id": "7cf9501df3d6924e423cabcde4c924ff", "rssi": -101, "get_time": "2023-04-17 17:40:22", //a last point per period "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 conectados no momento](https://www.navixy.com/docs/navixy-api/user-api/backend-api/resources/tracking/beacon/index#last-values) a um dispositivo específico. Por exemplo, se você quiser saber qual carreta está atualmente próxima do 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", "trackers": [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 tempos de uso e detalhes da viagem Já coletamos dados históricos usando a primeira das chamadas de API apresentadas, que mostrou em quais dispositivos a carreta foi exibida em um determinado momento. Para obter informações sobre as viagens e o tempo de uso dessa carreta, precisamos simplesmente usar uma das duas chamadas de API: 1. chamada de API [track/list](https://www.navixy.com/docs/navixy-api/user-api/backend-api/resources/tracking/track/index#list) para obter informações de viagem 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, City of Tonawanda, New York, United States, 14150", "length": 18.91, "points": 59, "avg_speed": 49, "event_count": 3, "norm_fuel_consumed": 6.32, "type": "regular", "gsm_lbs": false } ``` Com esses dados, podemos ver que a viagem durou quase 35 minutos (end\_date - start\_date), com velocidade média de 49 km/h e velocidade máxima de 62 km/h. O comprimento da viagem 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 da viagem pode ser usado no futuro para calcular a quantidade de quilômetros até a próxima manutenção da carreta. 2. Se você quiser um registro detalhado da trajetória da carreta onde o beacon está instalado para exibi-lo em um relatório, por exemplo, você pode usar a [track/read](https://www.navixy.com/docs/navixy-api/user-api/backend-api/resources/tracking/track/index#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, County Road, Town of Clarence, Erie County, New York, United States, 14031", "satellites": 10, "mileage": 0, "heading": 173, "speed": 42, "get_time": "2023-04-17 17:05:42", "alt": 0, "lat": 43.0318683, "lng": -78.5985733 }, {//other point objects per this trip } ] } ``` 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 da Navixy Aqui estão alguns outros 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 ajudá-lo a determinar rapidamente quais motoristas são adequados para certos passageiros e evitar perda de 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 duas ou mais crianças 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 reserva de transporte precise solicitar informações de todos os motoristas que têm uma cadeirinha infantil instalada. Para isso, use a chamada de API beacon/last\_values para reunir informações sobre quais motoristas podem ser atribuídos a uma determinada solicitação. 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 dos 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, aqueles com uma cadeirinha infantil no compartimento dos passageiros e, depois, aqueles com uma cadeirinha infantil no porta-malas. Essa abordagem garante que você corresponda de forma eficiente passageiros a veículos e motoristas adequados. ### Máquinas agrícolas Suponha que seu cliente tenha máquinas agrícolas que possam ser acopladas 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 intensidade de 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 conseguir isso, instale dispositivos em tratores e colheitadeiras, bem como em á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 por 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 das carretas 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 e uma utilização eficientes de seu equipamento agrícola, aumentando, em última análise, a produtividade. ### Uso em canteiros de obras Canteiros de obras costumam ter inúmeras ferramentas e equipamentos caros. Embora a instalação de um beacon para fins de rastreamento seja benéfica, surge outra preocupação – como garantir que o equipamento seja rastreado com frequência e que o rastreador GPS não fique sem energia? Para monitorar o uso e a localização do equipamento, os beacons BLE também podem ser úteis. A solução para canteiros de obras pode ser semelhante à das máquinas agrícolas – instale dispositivos nas máquinas, bem como nos locais de armazenamento. Essa abordagem permite rastrear com eficiência seu valioso equipamento, garantindo que ele esteja sendo usado de forma eficaz 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 indoor Você pode rastrear itens com eficiência em ambientes internos usando a plataforma e 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 saber em qual área um funcionário está ou quantos vendedores estão próximos ao balcão de informações. Ter essas informações 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 de mercadorias ou equipamentos economiza tempo, pois você não precisa procurá-los em todo o armazém. Isso agiliza o processo de recuperação, tornando suas operações mais eficientes. ### Rastreamento de mercadorias com beacons BLE Utilizar 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 um determinado momento. Esse método não apenas permite rastrear as 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, por sua vez, leva a um melhor atendimento aos clientes e a processos de negócios mais otimizados. --- # 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.