Visão geral

Rastreie dispositivos com a API de Localização.

A API de Localização da Eseye fornece informações de localização para SIMs IoT e torres de rede celular. Você pode:

• Recuperar a localização atual ou a última registrada de um SIM.
• Exportar as localizações de vários SIMs como um arquivo KMZ.
• Recuperar a localização e os detalhes da rede de uma torre de celular.

Os resultados de localização são baseados na última torre de celular usada pelo SIM. Eles não representam a localização GPS precisa do dispositivo.

URL base

Envie requisições de produção para:

https://location.eseye.com

Todas as requisições devem usar HTTPS.

Acesso e autenticação

A API de Localização é um serviço tarifado e requer acesso separado.

Solicite acesso e preços enviando um e-mail para [e-mail]. Inclua o nome da sua empresa, cargo, número de telefone e endereço de e-mail.

A Eseye fornece um nome de usuário e uma senha da API de Localização. Cada requisição inclui:

• O nome de usuário e a senha no corpo da requisição JSON.
• Um PHPSESSID cookie de sessão no Cookie cabeçalho.

Cookie: PHPSESSID=<session-cookie>
Content-Type: application/json

Mantenha suas credenciais da API de Localização e o cookie de sessão em segurança. Não os comite no controle de origem, não os exponha em aplicativos do lado do cliente nem os inclua em logs.

Comportamento e limitações de localização

• Um SIM pode ser identificado usando seu ICCID ou MSISDN.
• Os resultados de localização contêm a latitude e a longitude da última torre de celular usada pelo SIM.
• Quando o dispositivo está offline ou sua localização atual não está disponível, a API retorna a última localização registrada.
• A Eseye retém os dados de localização por dois meses. Armazene quaisquer dados históricos que você precise manter por mais tempo.
• Uma exportação KMZ pode conter no máximo 10 ICCIDs por requisição.
• Arquivos KMZ podem ser importados no Google Earth ou no Google My Maps.
• Uma consulta de torre de celular requer seu Código de País Móvel (mcc), Código de Rede Móvel (mnc), identificador da área de localização e identificador da célula.
• Uma resposta HTTP bem-sucedida nem sempre significa que a consulta de localização foi bem-sucedida. Verifique status.status na resposta:

  • OK significa que a requisição foi concluída com sucesso.
  • ERR significa que a requisição falhou. Verifique errorCode e errorMessage para detalhes.
• As informações de localização dependem dos dados de rede disponíveis para a Eseye. Uma localização pode não ser retornada em todas as consultas.

Suporte

Contato Suporte da Eseye para obter assistência com a API de Localização.