> For the complete documentation index, see [llms.txt](https://docs.eseye.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.eseye.com/api-reference/api-reference-pt-br/api-de-localizacao/overview.md).

# 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 [orders@eseye.com](mailto:orders@eseye.com?subject=Request%20Location%20API%20pricing). 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.

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

{% hint style="warning" %}
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.
{% endhint %}

### 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](mailto:support@eseye.com?subject=Location%20API%20support%20request) para obter assistência com a API de Localização.


---

# 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://docs.eseye.com/api-reference/api-reference-pt-br/api-de-localizacao/overview.md?ask=<question>&goal=<user_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.