> ## 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 endereço do documento: validação com IA

> Valide endereços em tempo real com a Geolocalização de Documentos da Didit: extração por IA, checagem no Google Maps e detecção de endereços falsos.

A verificação de geolocalização de endereço do documento da Didit oferece uma solução completa para validar endereços de usuários com eficiência e precisão. Nosso sistema usa tecnologia avançada de IA e fontes de dados externas para garantir a autenticidade e a validade das informações de endereço.

![Fluxo de geolocalização de documentos da Didit extraindo e validando endereços de documentos de identidade](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 usuários enviam uma imagem do documento que contém as informações de endereço. Nossa IA avançada cuida do resto.

| Recurso | Descrição |
| - | - |
| **Tipos de documento** | Passaportes, documentos de identidade, autorizações de residência, entre outros |
| **Suporte a idiomas** | Reconhecimento em vários idiomas e formatos |
| **Extração por IA** | Extração automática de dados do documento enviado |

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

O endereço extraído é validado em várias fontes e geolocalizado por IP.

| Recurso | Descrição |
| - | - |
| **Integração com mapas** | Verificação cruzada com Google Maps e OpenStreetMap |
| **Validação por componente** | Rua, cidade, região e código postal verificados individualmente |
| **Detecção de fraude** | Detecção de endereços fictícios para evitar possíveis fraudes |

**3. Análise**

É gerado um relatório completo sobre o status da validação, com saídas padronizadas.

| Recurso | Descrição |
| - | - |
| **Resultados da verificação** | Resultados detalhados em formato de saída padronizado |
| **Relatórios completos** | Relatórios de verificação completos para cada envio |
| **Opções de entrega** | Resultados pelo painel, por webhooks ou pela API |

![Resultado da geolocalização de endereço da Didit no mapa, comparando o endereço declarado 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]
>
> Nosso sistema é compatível com formatos de endereço de todo o mundo e fornece saídas padronizadas, independentemente do tipo de documento ou da região.

### Estrutura do relatório

O relatório de geolocalização do documento retorna 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ções de endereço

* `address`: endereço completo, conforme extraído do documento
* `parsed_address.street_1`: informações principais da rua
* `parsed_address.street_2`: informações complementares da rua
* `parsed_address.city`: nome da cidade
* `parsed_address.region`: estado ou região
* `parsed_address.postal_code`: CEP ou 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 endereço padronizado

### Exemplo de resposta 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 a lista completa de propriedades possíveis e seus valores, consulte nossa [*Referência da API*](https://docs.didit.me/pt-br/sessions-api/retrieve-session.md).

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

As informações de endereço extraídas de documentos devem ser tratadas com medidas de segurança adequadas e em conformidade com as normas de proteção de dados aplicáveis. Implemente controles de acesso e políticas de retenção de dados adequados para essas informações sensíveis.


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