> For the complete documentation index, see [llms.txt](https://wiki.datadike.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.datadike.com/es/sonar/administration/user-activity/geolocation.md).

# Geolocalización

Dónde han estado los dispositivos Windows: la última posición informada y el historial de ubicaciones en un mapa, con la precisión y los usuarios con sesión iniciada en ese momento.

## Qué es y cuándo usarlo

La geolocalización muestra la posición física que informan los dispositivos Windows, en un mapa y como historial. Úsela para saber dónde se vio por última vez un portátil, para comprobar que un dispositivo permanece en la oficina a la que pertenece, o para ver quién tenía la sesión iniciada en un dispositivo cuando estaba en un lugar determinado.

La posición está disponible en dos lugares:

* **Observability › Geolocation**, para recorrer los dispositivos sitio por sitio.
* La pestaña **LOCATION** de un dispositivo, en el panel del dispositivo de **Dashboard › Sysadmin**, para el dispositivo que ha seleccionado.

## Qué se recopila

| Elemento     | Detalle                                                                                                                                  |
| ------------ | ---------------------------------------------------------------------------------------------------------------------------------------- |
| Dispositivos | Dispositivos **Windows** cuyo agente se instaló con la opción **Geolocation**                                                            |
| Datos        | Latitud, longitud y precisión, tal como las informa el servicio de ubicación de Windows                                                  |
| Precisión    | El radio de incertidumbre, en metros enteros                                                                                             |
| Cuándo       | Al instalar el agente, cada vez que se inicia el servicio del agente y, después, aproximadamente una vez por hora (cada 50 a 60 minutos) |

La opción **Geolocation** se elige al generar el instalador. Está activada de forma predeterminada en **Agents › Install Agent** y desactivada de forma predeterminada en un nuevo enlace de despliegue. La opción forma parte de la instalación: para cambiarla en un dispositivo, reinstale el agente con la opción que desee. Vea [Instalar el agente en Windows](/es/sonar/deploy-operate/install-agent-windows.md).

La dirección que aparece junto a cada posición la resuelve su navegador a partir de las coordenadas cuando se carga la lista. El mapa y las direcciones requieren que el navegador tenga acceso a internet.

## Antes de empezar

* Un rol con **View Geolocation** (grupo **Productivity** en **Admin Center › Roles**). Ese permiso muestra la entrada de menú **Geolocation** y abre la pestaña **LOCATION**.
* **List Sites** (grupo **Clients & Sites**), para rellenar la lista **Site**.
* Al menos un dispositivo Windows instalado con la opción **Geolocation** que haya informado una posición.

## Pasos

### Recorrer los dispositivos en el mapa

1. Abra **Observability › Geolocation**.
2. En **Site**, elija el sitio. Solo se listan los sitios con al menos una posición informada; el primero viene seleccionado.
3. En **Device**, elija el dispositivo. Aparecen primero los dispositivos en línea, luego los atrasados y por último los que están sin conexión, cada uno con su estado. El primero viene seleccionado.
4. Sin ventana de tiempo, el mapa muestra la última posición que informó el dispositivo. Para ver un historial, haga clic en **24H**, **7D**, **14D** o **30D** en **Time window**, o en el botón de calendario para un intervalo personalizado.
5. En **Location History**, despliegue un día y haga clic en una posición para mostrarla en el mapa.

### Consultar un dispositivo

1. Abra **Dashboard › Sysadmin** y seleccione el dispositivo.
2. Abra la pestaña **LOCATION**.
3. En **Time Window**, elija **1h**, **3h**, **12h**, **24h**, **7D** o **30D**. El valor predeterminado es **24h**. Para un intervalo personalizado, haga clic en el botón de calendario, fije **Start** y **End** y haga clic en **Apply**.
4. Haga clic en una posición de **Location History** para mostrarla en el mapa.

## Qué debe ver

**Location History** agrupa las posiciones por día, de la más reciente a la más antigua, con el número de posiciones de cada día. Cada entrada muestra cuándo se registró la posición y su dirección. La más reciente lleva la insignia **LAST**, "Last location reported by agent". El color de una entrada refleja su precisión:

| Color    | Precisión      |
| -------- | -------------- |
| Verde    | 100 m o mejor  |
| Amarillo | De 101 a 499 m |
| Rojo     | 500 m o más    |

El mapa muestra un marcador, en la posición seleccionada. Su ventana de información muestra el nombre de host y el estado del dispositivo, cuándo se recopiló la posición, **Accuracy:&#x20;*****n*****&#x20;m**, la dirección y los usuarios que tenían una sesión abierta en el dispositivo dentro de un margen de cinco minutos respecto a ese momento ("No connected users" cuando no había ninguno).

## Cómo verificar que funcionó

1. Abra la pestaña **LOCATION** de un dispositivo instalado con la opción **Geolocation**, con **24h**.
2. Debe figurar al menos una posición. Un dispositivo en línea añade una aproximadamente cada hora.
3. Reinicie el servicio del agente en el dispositivo, o espere a la hora siguiente. Debe aparecer una entrada nueva al principio de **Location History** con la insignia **LAST**.

## Errores comunes

| Síntoma                                                                                    | Causa                                                                                                   | Solución                                                                                              |
| ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
| "No sites available"                                                                       | Ningún dispositivo de ningún sitio ha informado una posición                                            | Compruebe que los dispositivos se instalaron con la opción **Geolocation** y están en línea           |
| Falta un dispositivo en **Device**                                                         | El dispositivo no ha informado una posición, o no es un dispositivo Windows                             | Reinstale el agente con **Geolocation** activada; solo los dispositivos Windows informan una posición |
| "No location data. Live or historical." o "No location data available for this time range" | No hay ninguna posición en la ventana elegida                                                           | Amplíe la ventana de tiempo                                                                           |
| "You don't have permission for this action" en la pestaña **LOCATION**                     | Al rol le falta **View Geolocation**                                                                    | Añada el permiso al rol                                                                               |
| "Address unavailable" o "Address lookup limit reached"                                     | No se pudo resolver la dirección, o la lista tiene más posiciones que direcciones consultadas para ella | Las coordenadas siguen siendo correctas; reduzca la ventana de tiempo para ver las direcciones        |
| Solo una posición en el mapa                                                               | No hay ninguna ventana de tiempo seleccionada, así que solo se muestra la última posición               | Elija una ventana de tiempo                                                                           |

## Referencia de campos

| Campo           | Dónde            | Qué hace                                 | Valores aceptados                                                        | Predeterminado                   |
| --------------- | ---------------- | ---------------------------------------- | ------------------------------------------------------------------------ | -------------------------------- |
| **Site**        | Geolocation      | Limita **Device** a ese sitio            | Sitios con posiciones informadas                                         | El primer sitio                  |
| **Device**      | Geolocation      | Dispositivo cuyas posiciones se muestran | Dispositivos del sitio con posiciones                                    | El primer dispositivo            |
| **Time window** | Geolocation      | Período del historial                    | **24H**, **7D**, **14D**, **30D**, o un intervalo personalizado          | Ninguno: solo la última posición |
| **Time Window** | Pestaña LOCATION | Período del historial                    | **1h**, **3h**, **12h**, **24h**, **7D**, **30D**, o **Start** / **End** | **24h**                          |
| **Accuracy**    | Mapa             | Radio de incertidumbre de la posición    | Metros                                                                   | (sin valor)                      |

## Páginas relacionadas

* [Detalles del dispositivo](/es/sonar/administration/devices/device-details.md): el panel del dispositivo y sus pestañas
* [Instalar el agente en Windows](/es/sonar/deploy-operate/install-agent-windows.md): la opción **Geolocation**
* [Comportamiento de los usuarios](/es/sonar/administration/user-activity/users-behavior.md): la **Latest location** del informe del usuario
* [Roles y permisos](/es/sonar/administration/identities/roles.md)
