Detalhes técnicos

A API de recuperação de localização de dispositivos permite recuperar a última localização conhecida de um dispositivo com cartão SIM. A API utiliza o posicionamento por rede celular para localizar o dispositivo associado a um determinado número de telefone, oferecendo várias vantagens em relação ao posicionamento por GPS, incluindo:

  • Maior duração da bateria: A localização é obtida por meio da conexão à rede celular, ao contrário do GPS, que consome bastante bateria, o que aumenta a capacidade de bateria necessária para o rastreamento contínuo de dispositivos IoT. Isso contribui para prolongar a vida útil dos dispositivos IoT não recarregáveis.
  • Lista de materiais (BOM) reduzida: Os dispositivos de IoT existentes exigem um módulo GPS e uma antena, o que aumenta o custo unitário do dispositivo. Os dispositivos de IoT com recurso de rede habilitado exigem apenas uma conexão de celular.

Observação: Atualmente, a API de recuperação da localização do dispositivo só pode ser utilizada no ambiente do Network Registry Playground, por meio de uma operadora virtual. Veja aqui para mais informações.

Casos de uso

Alguns casos de uso em que a API de recuperação da localização do dispositivo é útil:

  • Monitoramento e navegação de drones: Ao integrar a API de Localização de Dispositivos, é possível incorporar recursos avançados de rede para determinar de forma rápida e fácil a posição de um drone. Isso possibilita o desenvolvimento de novas Applications que oferecem segurança máxima no controle de frotas de drones.
  • Rastreamento de ativos: As empresas frequentemente precisam rastrear e monitorar seus ativos em tempo real. Sejam caminhões de entrega, veículos conectados ou outras máquinas, dispor de dados de localização confiáveis é fundamental. As plataformas de rastreamento de ativos por meio da IoT podem chamar periodicamente a API de recuperação de localização de dispositivos para obter a localização de cada ativo.
  • Publicidade personalizada: Ao acessar a localização do dispositivo do usuário, com o consentimento deste, os anunciantes contam com mais um recurso para personalizar os anúncios exibidos ao usuário. Com esses dados de localização, os anúncios tornam-se mais relevantes, apresentando lojas locais, serviços e outros conteúdos locais pertinentes.

Referência da API

A especificação OpenAPI para a API de recuperação de localização de dispositivos já está disponível aqui.

Inscrição

Um pré-requisito para utilizar o recurso de localização de dispositivos é o registro do seu aplicativo na Vonage e junto às operadoras de telefonia móvel. O serviço de Registro de Recursos de Rede da Vonage automatiza o processo de registro por meio de uma interface de painel comum e envia as informações às operadoras para aprovação. O portal do Painel do Cliente da Vonage é a fonte única para o registro junto a todas as operadoras participantes.

Informações mais detalhadas sobre como funciona o produto “Registro” podem ser encontradas aqui.

Se o seu registro não tiver sido aceito pela Vonage ou por qualquer operadora — por exemplo, se o status do Registro de Recursos de Rede estiver como “Pendente” ou “Rejeitado” —, você não está autorizado a usar ou enviar quaisquer solicitações de Recursos de Rede.

Parque infantil

Atualmente, a API de recuperação da localização do dispositivo só pode ser usada com uma operadora virtual, que fornece respostas predefinidas e determinísticas com base nos parâmetros da solicitação da API. Isso permite a descoberta, o desenvolvimento e o teste de recursos de rede em cenários em que não há acesso a uma operadora ativa.

Veja o Guia de parques infantis para obter mais informações sobre como configurar sua Account e sobre o Guia do Operador Virtual para obter mais informações sobre as solicitações e respostas pré-configuradas.

Autenticação

A autenticação no Verify é feita por meio de JWTs. Estes podem ser gerados por meio do ferramenta online; para obter mais informações sobre autenticação usando JWTs, consulte o Guia de autenticação.