다운로드 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 발급

네이버 클라우드 플랫폼 콘솔의 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=..."
    }
  ]
}