---
title: "ロケーションの照会"
slug: "arc-eye-mapdata-locations-api"
updated: 2026-09-17T09:57:56Z
published: 2026-09-17T09:57:56Z
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/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}/locations |

              参考

              

[ARC eyeの共通設定 > API URL](/docs/ja/arc-eye-overview#APIURL)のダウンロード URL照会 API URLパスの末尾の`/download-urls`を`/locations`に置き換えて呼び出します。

### リクエストヘッダ

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 - ダウンロード 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/ja/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/ja/arc-eye-overview#%EC%9D%91%EB%8B%B5)をご参照ください。