Api —— get meta 데이터의 다운로드 주소

이 인터페이스는 mapId를 통해 지정된 Spatial Map(공간 맵)에 연관된 메타데이터(meta)의 다운로드 리소스 정보를 가져오는 데 사용됩니다.

1. 인터페이스 기본 정보

인터페이스 주소: https://armap-api-<cn1,na1>.easyar.com/map/meta/{mapId}
요청 방법: GET
응답 형식: */* (일반적으로 application/json)

2. 인증 방식

이 인터페이스는 다음 두 가지 인증 모드를 지원합니다:

Token 기반 인증:
- Header: Authorization: [token]
- 매개변수: AppId를 포함해야 합니다.
서명(Signature) 기반 인증:
- APIKey, APISecret 및 AppId를 사용하여 서명을 생성하여 검증합니다.
- 서명 계산 상세 알고리즘은 API Key 서명 방법을 참조하세요.

3. 요청 매개변수

3.1 경로 매개변수 (Path Parameters)

매개변수 이름	유형	필수 여부	설명
mapId	String	예	공간 맵의 고유 식별자(MapId).

4. 응답 데이터 구조 (Resource)

요청이 성공하면(statusCode가 0인 경우) result에 메타데이터 파일을 가리키는 Resource 객체가 포함됩니다.

필드 이름	유형	설명
statusCode	Integer	상태 코드. 0은 성공을 의미합니다.
msg	String	상태 설명 정보.
timestamp	DateTime	서버 응답 타임스탬프.
result	Object	맵 데이터 배열 및 페이지네이션 통계 정보를 포함하는 Map 객체.

Resource 객체 구조:

필드 이름	유형	설명
filename	String	메타데이터 파일의 파일명.
url	Object (URL)	프로토콜, 호스트, 경로 등 상세 다운로드 주소 정보를 포함하는 객체.
file	Object (File)	파일의 물리적 속성 정보(경로, 크기 등).
readable	Boolean	해당 리소스가 읽을 수 있는지 여부.
open	Boolean	해당 리소스가 현재 열려 있는 상태인지 여부.

5. 상태 코드 (Status Codes)

Http Code	의미	설명
200	OK	요청 성공.
401	Unauthorized	인증 실패, Token 또는 서명을 확인하세요.
403	Forbidden	해당 리소스에 대한 접근 권한이 없음.
404	Not Found	지정된 맵 또는 메타데이터를 찾을 수 없음.

Status Code 오류 코드

스파셜 공간 맵 APIs 오류 코드 설명

6. 응답 예시 (JSON)

{
  "statusCode": 0,
  "msg": "success",
  "timestamp": "2026-01-30T10:00:00Z",
  "result": {
    "filename": "map_metadata.json",
    "url": {
      "protocol": "https",
      "host": "armap-api-cn1.easyar.com",
      "path": "/download/path/to/meta",
      "query": "token=..."
    },
    "readable": true,
    "open": false
  }
}

Table of Contents