# Ubicación del usuario (V3)

Fuente: /identity-verification-v3/user-location/

 Solo disponible en V3

Con esta opción, la sesión de verificación **pide la ubicación del dispositivo** antes de abrir la
cámara y la incluye en el resultado: coordenadas, precisión, fecha de captura y una dirección
aproximada. Sirve como evidencia adicional de dónde se realizó la verificación.

> **Nota**
>
> Es una opción **opcional y con costo adicional**: no se pide a menos que la actives explícitamente al
> [crear la sesión](/identity-verification-v3/create-verification-session/). No cambia el `result` de
> la verificación.

## Cómo activarla

Envía `capture_user_location: true` en el cuerpo de la solicitud al crear la sesión:

**JSON**

```json
{
    "validations": ["INE", "CURP"],
    "capture_user_location": true
}
```

**cURL**

```bash
curl -X POST https://api.verificamex.com/identity/v3/identity/sessions \
  -H "Authorization: Bearer {TU_TOKEN}" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "validations": ["INE", "CURP"],
    "capture_user_location": true
  }'
```

La respuesta de creación confirma la opción con `"capture_user_location": true`.

> **Tiene un costo adicional**
>
> Consume **5 tokens extra** por sesión, **solo si se obtiene la ubicación**. Si la ubicación no se
> obtiene, `user_location` llega en `null` y no se cobran.

## Estructura de la respuesta

Tanto el [detalle de la sesión](/identity-verification-v3/show-verification-session/) como el
[webhook](/identity-verification-v3/webhooks/) incluyen el campo `user_location`. Es `null` si la sesión
no pidió la ubicación o si no se obtuvo.

| Campo | Tipo | Descripción |
| - | - | - |
| lat | `Number` | Latitud. |
| lng | `Number` | Longitud. |
| `precision_m` | `Number` | Precisión estimada de la ubicación, en metros. |
| `capturada_en` | `String` | Fecha y hora de la captura (ISO-8601, UTC). |
| `altitud_m` | `Number` | Altitud en metros, o `null` si el dispositivo no la proporciona. |
| `rumbo_grados` | `Number` | Dirección de movimiento en grados, o `null`. |
| `velocidad_kmh` | `Number` | Velocidad en km/h, o `null`. |
| `utc_offset_min` | `Number` | Diferencia horaria del dispositivo respecto a UTC, en minutos (por ejemplo `-360` para la Ciudad de México). |
| `google_maps_url` | `String` | Enlace para ver la ubicación en Google Maps. |
| direccion | `Object` | Dirección aproximada obtenida de las coordenadas (por ejemplo `colonia`, `codigo_postal`, `estado`). Sus campos pueden variar según la zona. |

> **Consejo**
>
> Toma en cuenta `precision_m` al interpretar la ubicación: depende del dispositivo y de la señal
> disponible, y puede ir de unos cuantos metros a varios cientos.

## Ejemplo

```json
{
    "lat": 19.4326,
    "lng": -99.1332,
    "precision_m": 12.0,
    "capturada_en": "2026-10-08T18:02:13.000Z",
    "altitud_m": 2240.3,
    "rumbo_grados": null,
    "velocidad_kmh": null,
    "utc_offset_min": -360,
    "google_maps_url": "https://www.google.com/maps/search/?api=1&query=19.4326000,-99.1332000",
    "direccion": {
        "colonia": "Centro",
        "codigo_postal": "06060",
        "estado": "Ciudad de México"
    }
}
```

**Solo V3**

Esta opción no existe en las sesiones creadas con la V2.

**Cobro condicionado**

5 tokens extra, solo si se obtiene la ubicación.

**No afecta el resultado**

Es evidencia adicional: no cambia el `result` de la verificación.