---
title: "다운로드 URL 조회"
slug: "arc-eye-mapdata-download-urls-api"
updated: 2026-09-17T09:16:33Z
published: 2026-09-17T09:16:33Z
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/arceye-mapdata)를 참조해 주십시오.

### 2. Secret Key 발급

네이버 클라우드 플랫폼 콘솔의 **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/arceye-mapdata)를 참조해 주십시오.

## 요청

요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

| 메서드 | URI |
| --- | --- |
| GET | /map-data/v1/{projectId}/{signature}/{task}/download-urls |

참고

네이버 클라우드 플랫폼 콘솔의 **Menu** > **All Services** > **Digital Twin** > **ARC eye** > **Visual Localization** > **Data Management** 메뉴에서 대상 Emapper 또는 RobotMap 작업 상세에 표시되는 Invoke URL입니다. 자세한 확인 방법은 [ARC eye 공통 설정 > API URL](/docs/arc-eye-overview#APIURL)을 참조해 주십시오.

### 요청 헤더

ARC eye API에서 공통으로 사용하는 헤더에 대한 정보는 [ARC eye 요청 헤더](/docs/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/arc-eye-mapdata-locations-api) 응답의 `locationId` |
| `version` | Number | Optional | 대상 버전 번호 - [Map Data - 이력 조회](/docs/arc-eye-mapdata-versions-api) 응답의 `version` - 생략 시 최신 버전 반환 |

### 요청 예시

요청 예시는 다음과 같습니다.

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

## 응답

응답 형식을 설명합니다.

### 응답 바디(성공)

조회가 성공한 경우의 응답 바디에 대한 설명은 다음과 같습니다.

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `data` | Array | - | 다운로드 대상 파일 목록: [data](/docs/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/arc-eye-overview#%EC%9D%91%EB%8B%B5)를 참조해 주십시오.