ダウンロード 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ご利用ガイドをご参照ください。

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&version=3' \
--header 'X-ARCEYE-SECRET: {SecretKey}'

レスポンス

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

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

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

data

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

レスポンス例

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

成功(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=..."
    }
  ]
}