> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Geolocalización de direcciones en documentos con IA

> Didit valida direcciones de documentos con IA: extracción, cotejo con Google Maps y detección de direcciones ficticias en tiempo real.

La verificación de geolocalización de direcciones de documentos de Didit ofrece una solución completa para validar las direcciones de los usuarios de forma eficiente y precisa. Nuestro sistema combina tecnología de IA avanzada y fuentes de datos externas para garantizar la autenticidad y la validez de la información de la dirección.

![Flujo de geolocalización de documentos de Didit que extrae y valida direcciones de documentos de identidad](https://mintcdn.com/didit-0f962782/z6T2GHM4Zh-iSj-K/images/document-geolocation.png?fit=max\&auto=format\&n=z6T2GHM4Zh-iSj-K\&q=85\&s=1512879d44d8923d4f6ea8f78ff7d378)

**1. Captura**

Los usuarios suben una imagen de su documento con la información de la dirección. Nuestra IA avanzada se encarga del resto.

| Capacidad | Descripción |
| - | - |
| **Tipos de documento** | Pasaportes, documentos de identidad, permisos de residencia y más |
| **Compatibilidad con idiomas** | Reconocimiento en varios idiomas y formatos |
| **Extracción con IA** | Extracción automática de datos del documento subido |

**2. Extracción de datos**

La dirección extraída se valida con varias fuentes y se geolocaliza por IP.

| Capacidad | Descripción |
| - | - |
| **Integración con mapas** | Comprobación cruzada con Google Maps y OpenStreetMap |
| **Validación por componentes** | Calle, ciudad, región y código postal verificados por separado |
| **Detección de fraude** | Detección de direcciones ficticias para prevenir posibles fraudes |

**3. Análisis**

Se genera un informe completo sobre el estado de la validación con resultados estandarizados.

| Capacidad | Descripción |
| - | - |
| **Resultados de la verificación** | Resultados detallados con un formato de salida estandarizado |
| **Informes completos** | Informes de verificación completos para cada envío |
| **Opciones de entrega** | Resultados a través del panel, webhooks o API |

![Resultado de geolocalización de la dirección de Didit en un mapa, contrastando la dirección declarada con Google Maps](https://mintcdn.com/didit-0f962782/z6T2GHM4Zh-iSj-K/images/geolocation.png?fit=max\&auto=format\&n=z6T2GHM4Zh-iSj-K\&q=85\&s=ba2c32a5454c03aef687fbb5bb12d79f)

> [!NOTE]
>
> Nuestro sistema admite formatos de dirección de todo el mundo y ofrece resultados estandarizados sea cual sea el tipo de documento o la región.

### Estructura del informe

El informe de geolocalización del documento devuelve un objeto JSON con un campo `address` en el nivel raíz que contiene todos los resultados de la verificación.

#### Campos principales de la respuesta

```typescript theme={null}
interface DocumentGeolocationResponse {
  address: string;
  parsed_address: {
    id: string;
    label: string;
    street_1: string;
    street_2: string | null;
    city: string;
    region: string;
    postal_code: string;
    raw_results: {
      geometry: {
        location: {
          lat: number;
          lng: number;
        };
        location_type: string;
        viewport: {
          northeast: {
            lat: number;
            lng: number;
          };
          southwest: {
            lat: number;
            lng: number;
          };
        };
      };
      formatted_address: string;
    };
  };
}
```

### Campos de la respuesta

#### Información de la dirección

* `address`: dirección completa tal como se extrae del documento
* `parsed_address.street_1`: información principal de la calle
* `parsed_address.street_2`: información secundaria de la calle
* `parsed_address.city`: nombre de la ciudad
* `parsed_address.region`: estado o región
* `parsed_address.postal_code`: código postal o ZIP

#### Datos de geolocalización

* `raw_results.geometry.location`: coordenadas precisas
* `raw_results.location_type`: nivel de precisión de la geolocalización
* `raw_results.viewport`: límites de coordenadas
* `raw_results.formatted_address`: formato de dirección estandarizado

### Ejemplo de respuesta JSON

```json theme={null}
{
  "address": "123 Sample Street",
  "parsed_address": {
    "id": "7c6280a2-fb6a-4258-93d5-2ac987cbc6ba",
    "city": "Madrid",
    "label": "Spain ID Card Address",
    "region": "Madrid",
    "street_1": "Avda de Madrid 34",
    "street_2": null,
    "postal_code": "28822",
    "raw_results": {
      "geometry": {
        "location": {
          "lat": 37.4222804,
          "lng": -122.0843428
        },
        "location_type": "ROOFTOP",
        "viewport": {
          "northeast": {
            "lat": 37.4237349802915,
            "lng": -122.083183169709
          },
          "southwest": {
            "lat": 37.4210370197085,
            "lng": -122.085881130292
          }
        }
      },
      "formatted_address": "Avda de Madrid 34, Madrid, Madrid 28822, Spain"
    }
  }
}
```

> [!NOTE]
>
> Para ver la lista completa de propiedades posibles y sus valores, consulta nuestra [*referencia de la API*](https://docs.didit.me/es/sessions-api/retrieve-session.md).

### Consideraciones de seguridad y privacidad

La información de la dirección extraída de los documentos debe tratarse con las medidas de seguridad adecuadas y cumpliendo la normativa de protección de datos aplicable. Implementa controles de acceso y políticas de retención de datos adecuados para esta información sensible.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.