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

# Geolocalização de moradas em documentos: validação por IA

> Valide moradas com a Geolocalização de Documentos da Didit: extração por IA, verificação no Google Maps e deteção de moradas fictícias em tempo real.

A verificação de geolocalização de moradas em documentos da Didit oferece uma solução abrangente para validar moradas de utilizadores com eficiência e precisão. O nosso sistema tira partido de tecnologia de IA avançada e de fontes de dados externas para garantir a autenticidade e a validade das informações de morada.

![Fluxo de geolocalização de documentos da Didit a extrair e validar moradas de documentos de identificação](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**

Os utilizadores carregam uma imagem do seu documento que contenha informação de morada. A nossa IA avançada trata do resto.

| Capacidade | Descrição |
| - | - |
| **Tipos de documento** | Passaportes, documentos de identificação, autorizações de residência e muito mais |
| **Suporte de idiomas** | Reconhecimento de múltiplos idiomas e formatos |
| **Extração por IA** | Extração automática de dados a partir do documento carregado |

**2. Extração de dados**

A morada extraída é validada em relação a múltiplas fontes e geolocalizada por IP.

| Capacidade | Descrição |
| - | - |
| **Integração de mapas** | Cruzamento de dados com o Google Maps e OpenStreetMap |
| **Validação de componentes** | Rua, cidade, região e código postal verificados individualmente |
| **Deteção de fraude** | Deteção de moradas fictícias para prevenir possíveis fraudes |

**3. Análise**

É gerado um relatório completo sobre o estado da validação com resultados normalizados.

| Capacidade | Descrição |
| - | - |
| **Resultados da verificação** | Resultados detalhados com formato de saída normalizado |
| **Relatórios abrangentes** | Relatórios de verificação completos para cada envio |
| **Opções de entrega** | Resultados através do painel, webhooks ou API |

![Resultado da geolocalização de morada da Didit no mapa cruzando a morada declarada com o 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]
>
> O nosso sistema suporta formatos globais de morada e fornece resultados normalizados, independentemente do tipo de documento de entrada ou da região.

### Estrutura do relatório

O relatório de Geolocalização de Documento devolve um objeto JSON com um campo `address` no nível raiz que contém todos os resultados da verificação.

#### Campos principais da resposta

```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 da resposta

#### Informação de morada

* `address`: Morada completa conforme extraída do documento
* `parsed_address.street_1`: Informação principal da rua
* `parsed_address.street_2`: Informação secundária da rua
* `parsed_address.city`: Nome da cidade
* `parsed_address.region`: Estado ou região
* `parsed_address.postal_code`: Código postal

#### Dados de geolocalização

* `raw_results.geometry.location`: Coordenadas precisas
* `raw_results.location_type`: Nível de precisão da geolocalização
* `raw_results.viewport`: Limites das coordenadas
* `raw_results.formatted_address`: Formato de morada normalizado

### Resposta JSON de exemplo

```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 obter uma lista completa das propriedades possíveis e dos respetivos valores, consulte a nossa [*Referência da API*](https://docs.didit.me/pt/sessions-api/retrieve-session.md).

### Considerações de segurança e privacidade

As informações de morada extraídas de documentos devem ser tratadas com medidas de segurança adequadas e em conformidade com as regulamentações de proteção de dados aplicáveis. Implemente controlos de acesso e políticas de conservação de dados adequados para esta informação sensível.


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