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

# 書類の住所ジオロケーション：AIによる住所検証

> Didit の書類ジオロケーションで住所をリアルタイムに検証。AIによる住所抽出、Google Mapsとの照合、架空住所の検出に対応します。

Diditの書類住所ジオロケーション検証は、ユーザーの住所を効率的かつ正確に検証する包括的なソリューションです。高度なAI技術と外部データソースを活用し、住所情報の真正性と有効性を確認します。

![本人確認書類から住所を抽出して検証するDiditの書類ジオロケーションフロー](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. 撮影**

ユーザーは住所情報が記載された書類の画像をアップロードします。その後の処理は高度なAIが行います。

| 機能 | 説明 |
| - | - |
| **書類の種類** | パスポート、身分証明書、在留許可証など |
| **言語サポート** | 多言語・多形式の認識に対応 |
| **AIによる抽出** | アップロードされた書類からデータを自動抽出 |

**2. データ抽出**

抽出された住所は複数のソースと照合され、IPに基づいて位置情報が特定されます。

| 機能 | 説明 |
| - | - |
| **地図との連携** | Google MapsとOpenStreetMapによる相互照合 |
| **構成要素ごとの検証** | 番地、市区町村、地域、郵便番号を個別に検証 |
| **不正検知** | 架空の住所を検知し、不正行為を防止 |

**3. 分析**

検証ステータスに関する完全なレポートが、標準化された出力形式で生成されます。

| 機能 | 説明 |
| - | - |
| **検証結果** | 標準化された出力形式による詳細な結果 |
| **包括的なレポート** | すべての提出に対する完全な検証レポート |
| **配信オプション** | ダッシュボード、Webhook、APIで結果を取得 |

![申告された住所をGoogle Mapsと照合した地図上のDidit住所ジオロケーション結果](https://mintcdn.com/didit-0f962782/z6T2GHM4Zh-iSj-K/images/geolocation.png?fit=max\&auto=format\&n=z6T2GHM4Zh-iSj-K\&q=85\&s=ba2c32a5454c03aef687fbb5bb12d79f)

> [!NOTE]
>
> 本システムは世界各地の住所形式に対応しており、入力された書類の種類や地域にかかわらず、標準化された出力を提供します。

### レポートの構造

書類ジオロケーションレポートは、すべての検証結果を含むルートレベルの`address`フィールドを持つJSONオブジェクトを返します。

#### 主要なレスポンスフィールド

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

### レスポンスフィールド

#### 住所情報

* `address`: 書類から抽出された完全な住所
* `parsed_address.street_1`: 主となる住所情報
* `parsed_address.street_2`: 補足の住所情報
* `parsed_address.city`: 市区町村名
* `parsed_address.region`: 州または地域
* `parsed_address.postal_code`: ZIPコードまたは郵便番号

#### ジオロケーションデータ

* `raw_results.geometry.location`: 正確な座標
* `raw_results.location_type`: ジオロケーションの精度レベル
* `raw_results.viewport`: 座標の範囲
* `raw_results.formatted_address`: 標準化された住所形式

### 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]
>
> 使用可能なプロパティとその値の完全な一覧は、[*APIリファレンス*](https://docs.didit.me/ja/sessions-api/retrieve-session.md)を参照してください。

### セキュリティとプライバシーに関する考慮事項

書類から抽出された住所情報は、適切なセキュリティ対策を講じ、関連するデータ保護規制を遵守して取り扱う必要があります。この機密情報に対しては、適切なアクセス制御とデータ保持ポリシーを実装してください。


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