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

# Geolocalizzazione indirizzo documento: validazione IA

> Valida gli indirizzi con Didit: geolocalizzazione documenti, estrazione IA, controlli Google Maps e rilevamento indirizzi fittizi in tempo reale.

La verifica Document Address Geolocation di Didit offre una soluzione completa per convalidare gli indirizzi degli utenti in modo efficiente e accurato. Il nostro sistema sfrutta una tecnologia IA avanzata e fonti di dati esterne per garantire l'autenticità e la validità delle informazioni sull'indirizzo.

![Flusso di geolocalizzazione dei documenti Didit che estrae e convalida gli indirizzi dai documenti d'identità](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. Acquisizione**

Gli utenti caricano un'immagine del proprio documento contenente le informazioni sull'indirizzo. La nostra IA avanzata gestisce il resto.

| Funzionalità | Descrizione |
| - | - |
| **Tipi di documento** | Passaporti, carte d'identità, permessi di soggiorno e altro ancora |
| **Supporto linguistico** | Riconoscimento multilingue e multiformato |
| **Estrazione tramite IA** | Estrazione automatica dei dati dal documento caricato |

**2. Estrazione dei dati**

L'indirizzo estratto viene convalidato rispetto a molteplici fonti e geolocalizzato tramite IP.

| Funzionalità | Descrizione |
| - | - |
| **Integrazione con mappe** | Confronto incrociato con Google Maps e OpenStreetMap |
| **Convalida dei componenti** | Via, città, regione e codice postale verificati singolarmente |
| **Rilevamento delle frodi** | Rilevamento di indirizzi fittizi per prevenire possibili frodi |

**3. Analisi**

Viene generato un report completo sullo stato di validazione con output standardizzati.

| Funzionalità | Descrizione |
| - | - |
| **Risultati della verifica** | Risultati dettagliati con formato di output standardizzato |
| **Report completi** | Report di verifica completi per ogni invio |
| **Opzioni di consegna** | Risultati tramite dashboard, webhook o API |

![Risultato della geolocalizzazione dell'indirizzo Didit su mappa che confronta l'indirizzo dichiarato 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]
>
> Il nostro sistema supporta i formati di indirizzo globali e fornisce output standardizzati indipendentemente dal tipo di documento di input o dall'area geografica.

### Struttura del report

Il report Document Geolocation restituisce un oggetto JSON con un campo `address` di livello principale contenente tutti i risultati della verifica.

#### Campi principali della risposta

```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;
    };
  };
}
```

### Campi della risposta

#### Informazioni sull'indirizzo

* `address`: Indirizzo completo estratto dal documento
* `parsed_address.street_1`: Informazioni sulla via principale
* `parsed_address.street_2`: Informazioni sulla via secondaria
* `parsed_address.city`: Nome della città
* `parsed_address.region`: Stato o regione
* `parsed_address.postal_code`: CAP o codice postale

#### Dati di geolocalizzazione

* `raw_results.geometry.location`: Coordinate precise
* `raw_results.location_type`: Livello di precisione della geolocalizzazione
* `raw_results.viewport`: Delimitazioni delle coordinate
* `raw_results.formatted_address`: Formato standardizzato dell'indirizzo

### Esempio di risposta 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]
>
> Per un elenco completo delle possibili proprietà e dei relativi valori, consulta il nostro [*Riferimento API*](https://docs.didit.me/it/sessions-api/retrieve-session.md).

### Considerazioni su sicurezza e privacy

Le informazioni sull'indirizzo estratte dai documenti devono essere gestite con misure di sicurezza adeguate e in conformità con le normative applicabili in materia di protezione dei dati. Implementa controlli di accesso appropriati e politiche di conservazione dei dati appropriate per queste informazioni sensibili.


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