履歴の照会

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

特定のロケーションの e-mapまたはロボットマップ変換履歴(バージョン)リストを照会します。同じロケーションに対して変換処理が複数回実行された場合、各成功履歴がバージョンとして蓄積されます。レスポンスは、バージョン番号の降順でソートされて返されます。

事前段階

Map Data - 履歴照会 APIを使用するための事前段階は次の通りです。

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

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

2. Secret Keyの発行

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

リクエスト

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

リクエストヘッダ

ARC eye APIで共通して使用されるヘッダの詳細は、ARC eyeのリクエストヘッダをご参照ください。

リクエストパス変数

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

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

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

リクエスト例

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

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

レスポンス

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

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

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

versions

versionsの説明は次の通りです。

レスポンス例

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

成功

照会に成功した場合のレスポンスのサンプルコードは次の通りです。

{
  "versions": [
    {
      "version": 3,
      "createdAt": "2026-04-21 16:57:58"
    },
    {
      "version": 2,
      "createdAt": "2026-04-20 12:35:25"
    },
    {
      "version": 1,
      "createdAt": "2026-04-17 11:55:48"
    }
  ]
}