> 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 localização 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 solicitações de produção para:

```
https://location.eseye.com
```

Todas as solicitações devem usar HTTPS.

### Acesso e autenticação

A API de Localização é um serviço pago 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 senha da API de Localização. Cada solicitação inclui:

* O nome de usuário e a senha no corpo da solicitaçã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 envie para o controle de versão, exponha-os em aplicativos no lado do cliente nem os inclua em logs.
{% endhint %}

### Comportamento e limitações da 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 solicitação.
* Arquivos KMZ podem ser importados para o Google Earth ou o 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 teve sucesso. Verifique `status.status` na resposta:
  * `OK` significa que a solicitação foi concluída com sucesso.
  * `ERR` significa que a solicitação falhou. Verifique `errorCode` e `errorMessage` para mais detalhes.
* As informações de localização dependem dos dados de rede disponíveis para a Eseye. Pode ser que uma localização não seja retornada em todas as consultas.

### Suporte

Contato [Suporte da Eseye](mailto:support@eseye.com?subject=Location%20API%20support%20request) para obter ajuda 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 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://docs.eseye.com/api-reference/api-reference-pt-br/api-de-localizacao/overview.md?ask=<question>&goal=<endgoal>
```

`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.