---
title: "로케이션 조회"
slug: "arc-eye-mapdata-locations-api"
updated: 2026-09-17T09:16:30Z
published: 2026-09-17T09:16:30Z
canonical: "api.ncloud-docs.com/arc-eye-mapdata-locations-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.

# 로케이션 조회

Classic/VPC 환경에서 이용 가능합니다.

e-map 또는 로봇맵 변환 결과가 존재하는 로케이션 목록을 조회합니다. 응답 결과는 Task 종류에 따라 달라집니다. `emapper`의 경우 변환 결과가 있는 **최상위 로케이션** 1건이 반환되며, `robot-map`의 경우 로봇맵 결과가 존재하는 **층(floor) 단위 로케이션** 목록이 반환됩니다.

## 사전 단계

Map Data - 로케이션 조회 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}/locations |

참고

[ARC eye 공통 설정 > API URL](/docs/arc-eye-overview#APIURL)의 다운로드 URL 조회 API URL의 마지막 경로 `/download-urls`를 `/locations`로 치환하여 호출합니다.

### 요청 헤더

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 - 다운로드 URL 조회 화면에서 조회 가능 |
| `signature` | String | Required | 프로젝트 서명 값 - 다운로드 URL 조회 화면에서 조회 가능 |
| `task` | String | Required | 조회 대상 Task 종류 - `emapper` \| `robot-map` - 다운로드 URL 조회 화면에서 조회 가능 |

### 요청 예시

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

```
curl --location --request GET '{InvokeURL}' \
--header 'X-ARCEYE-SECRET: {SecretKey}'
```

## 응답

응답 형식을 설명합니다.

### 응답 바디(성공)

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

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `locations` | Array | - | 결과가 존재하는 로케이션 목록: [locations](/docs/arc-eye-mapdata-locations-api#locations) |

#### `locations`

`locations`에 대한 설명은 다음과 같습니다.

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `locationId` | Number | - | 로케이션 ID |
| `locationName` | String | - | 로케이션 이름 |
| `locationNamePath` | String | - | 최상위 로케이션부터 해당 로케이션까지의 이름을 `_`로 연결한 값 - `emapper`의 경우 최상위 로케이션 이름과 동일 |

### 응답 예시

응답 예시는 다음과 같습니다.

#### 성공(`emapper`)

`emapper` 호출이 성공한 경우의 응답 예시는 다음과 같습니다.

```
{
  "locations": [
    {
      "locationId": 1001,
      "locationName": "Office",
      "locationNamePath": "Office"
    }
  ]
}
```

#### 성공(`robot-map`)

`robot-map` 호출이 성공한 경우의 응답 예시는 다음과 같습니다.

```
{
  "locations": [
    {
      "locationId": 2001,
      "locationName": "1F",
      "locationNamePath": "Office_1F"
    },
    {
      "locationId": 2002,
      "locationName": "B1F",
      "locationNamePath": "Office_B1F"
    }
  ]
}
```

참고

API 호출이 실패한 경우의 응답 바디와 응답 예시는 [ARC eye 개요](/docs/arc-eye-overview#%EC%9D%91%EB%8B%B5)를 참조해 주십시오.