API - meta 데이터의 다운로드 주소 가져오기

이 interface는 mapId를 통해 지정된 Spatial Map과 연결된 metadata(meta)의 다운로드 resource 정보를 가져오는 데 사용됩니다.

1. Interface 기본 정보

Interface 주소: https://armap-api-<cn1,na1>.easyar.com/map/meta/{mapId}
Request method: GET
Response format: */* (일반적으로 application/json)

2. 인증 방식

이 interface는 다음 두 가지 인증 모드를 지원합니다.

Token 기반 인증:
- Header: Authorization: [token]
- Parameter: AppId를 포함해야 합니다.
서명(Signature) 기반 인증:
- APIKey, APISecret, AppId를 사용하여 검증용 signature를 생성합니다.
- signature 계산의 자세한 알고리즘은 API Key signature 방법을 참조하십시오.

3. Request parameters

3.1 Path parameters

Parameter name	Type	Required	Description
mapId	String	예	spatial map의 고유 식별자(MapId).

4. Response data structure (Resource)

Request가 성공하면(statusCode가 0), 반환된 result에는 metadata 파일을 가리키는 Resource 객체가 포함됩니다.

Field name	Type	Description
statusCode	Integer	상태 코드. 0은 성공을 의미합니다.
msg	String	상태 설명 정보.
timestamp	DateTime	서버 response timestamp.
result	Object	map data array 및 pagination 통계 정보를 포함하는 Map 객체.

Resource 객체 구조:

Field name	Type	Description
filename	String	metadata 파일의 파일 이름.
url	Object (URL)	protocol, host, path 등 상세 다운로드 주소 정보를 포함하는 객체.
file	Object (File)	path, size 등 파일의 물리적 속성 정보.
readable	Boolean	이 resource를 읽을 수 있는지 여부.
open	Boolean	이 resource가 현재 열린 상태인지 여부.

5. Status codes

Http Code	의미	설명
200	OK	Request 성공.
401	Unauthorized	인증 실패. Token 또는 signature를 확인하십시오.
403	Forbidden	이 resource에 접근할 권한이 없습니다.
404	Not Found	지정한 map 또는 metadata를 찾을 수 없습니다.

Status Code 오류 코드

Sparse Spatial Map APIs 오류 코드 설명

6. Response 예시 (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