---
title: "ダウンロード URLの照会"
slug: "arc-eye-mapdata-download-urls-api"
updated: 2026-09-17T09:57:56Z
published: 2026-09-17T09:57:56Z
canonical: "api.ncloud-docs.com/arc-eye-mapdata-download-urls-api"
---

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

# ダウンロード URLの照会

Classic/VPC環境で利用できます。

特定のロケーション・バージョンの e-mapまたはロボットマップの結果ファイルのダウンロード URLリストを照会します。`emapper`の場合は`map.json`ファイルが返され、`robot-map`の場合は imlocの結果ファイルと mapの結果ファイルが一緒に返されます。レスポンスとして返される`url`は、有効期限のある presigned URLですので、発行後すぐにダウンロードしてください。

## 事前段階

Map Data - ダウンロード URL照会 APIを使用するための事前段階は次の通りです。

### 1. e-mapの作成またはロボットマップの作成

コンソールで、対象の最上位ロケーションに対して e-mapの作成またはロボットマップの作成を実行し、**成功**の状態になるまで完了させます。実行方法の詳細は、[ARC eyeご利用ガイド](https://guide.ncloud-docs.com/docs/ja/arceye-mapdata)をご参照ください。

### 2. Secret Keyの発行

NAVERクラウドプラットフォームコンソールの **Menu** > **All Services** > **Digital Twin** > **ARC eye** > **Visual Localization** > **Data Management**メニューで、Emapperまたは RobotMapタスク詳細にて **Secret Key**の **[作成]** ボタンをクリックし、Map Data専用の Secret Keyを発行します。詳細な方法は、[ARC eyeご利用ガイド](https://guide.ncloud-docs.com/docs/ja/arceye-mapdata)をご参照ください。

## リクエスト

リクエスト形式を説明します。リクエスト形式は次の通りです。

| メソッド | URI |
| --- | --- |
| GET | /map-data/v1/{projectId}/{signature}/{task}/download-urls |

              参考

              

NAVERクラウドプラットフォームコンソールの **Menu** > **All Services** > **Digital Twin** > **ARC eye** > **Visual Localization** > **Data Management**メニューで、Emapperまたは RobotMapタスク詳細に表示される Invoke URLです。確認方法の詳細は、[ARC eyeの共通設定 > API URL](/docs/ja/arc-eye-overview#APIURL)をご参照ください。

### リクエストヘッダ

ARC eye APIで共通して使用されるヘッダの詳細は、[ARC eyeのリクエストヘッダ](/docs/ja/arc-eye-overview#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)をご参照ください。

### リクエストパス変数

リクエストパス変数の説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `projectId` | Number | Required | プロジェクト ID - コンソールのタスク詳細画面に表示される Invoke URLで確認可能 |
| `signature` | String | Required | プロジェクトの署名値 - コンソールのタスク詳細画面に表示される Invoke URLで確認可能 |
| `task` | String | Required | 照会対象 Taskの種類 - `emapper` \| `robot-map` - コンソールのタスク詳細画面に表示される Invoke URLで確認可能 |

### リクエストクエリパラメータ

リクエストクエリパラメータの説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `locationId` | Number | Required | 対象ロケーション ID - [Map Data - ロケーションの照会](/docs/ja/arc-eye-mapdata-locations-api)レスポンスの`locationId` |
| `version` | Number | Optional | 対象のバージョン番号 - [Map Data - 履歴の照会](/docs/ja/arc-eye-mapdata-versions-api)レスポンスの`version` - 省略時、最新バージョンを返す |

### リクエスト例

リクエストのサンプルコードは次の通りです。

```
curl --location --request GET '{InvokeURL}?locationId=2001&version=3' \
--header 'X-ARCEYE-SECRET: {SecretKey}'
```

## レスポンス

レスポンス形式を説明します。

### レスポンスボディ(成功)

照会に成功した場合のレスポンスボディの説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `data` | Array | - | ダウンロード対象ファイルリスト: [data](/docs/ja/arc-eye-mapdata-download-urls-api#data) |

#### `data`

`data`の説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `fileName` | String | - | ファイル名 |
| `url` | String | - | ダウンロード用 presigned URL |

### レスポンス例

レスポンスのサンプルコードは次の通りです。

#### 成功(`emapper`)

`emapper`の呼び出しに成功した場合のレスポンスのサンプルコードは次の通りです。

```
{
  "data": [
    {
      "fileName": "map.json",
      "url": "https://kr.object.ncloudstorage.com/arceye-data-{projectId}/{volume}/.../map.json?response-content-disposition=attachment%3Bfilename%3Dmap.json&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=...&X-Amz-SignedHeaders=host&X-Amz-Expires=3600&X-Amz-Credential=...&X-Amz-Signature=..."
    }
  ]
}
```

#### 成功(`robot-map`)

`robot-map`呼び出しに成功した場合のレスポンスのサンプルコードは次の通りです。

```
{
  "data": [
    {
      "fileName": "1784_1F.tar.gz",
      "url": "https://kr.object.ncloudstorage.com/arceye-data-{projectId}/{volume}/csi-fs/imloc_output/1784_1F.tar.gz?response-content-disposition=attachment%3Bfilename%3D1784_1F.tar.gz&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=...&X-Amz-SignedHeaders=host&X-Amz-Expires=3600&X-Amz-Credential=...&X-Amz-Signature=..."
    },
    {
      "fileName": "1784_1F_tile_map.tar.gz",
      "url": "https://kr.object.ncloudstorage.com/arceye-data-{projectId}/{volume}/csi-fs/map_output/tar/1784_1F_tile_map.tar.gz?response-content-disposition=attachment%3Bfilename%3D1784_1F_tile_map.tar.gz&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=...&X-Amz-SignedHeaders=host&X-Amz-Expires=3600&X-Amz-Credential=...&X-Amz-Signature=..."
    }
  ]
}
```

              参考

              

API呼び出しに失敗した場合のレスポンスボディとレスポンスのサンプルコードは、[ARC eyeの概要](/docs/ja/arc-eye-overview#%EC%9D%91%EB%8B%B5)をご参照ください。