API —— Spatial Map 지도 정보 업데이트

이 인터페이스는 지정된 mapId를 통해 지도 정보를 업데이트합니다. HTTP PATCH와 유사한 업데이트 방식을 지원하며, 요청에서 제공된 매개변수만 수정되고 제공되지 않은 매개변수는 그대로 유지됩니다.

1. 인터페이스 기본 정보

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

2. 인증 방식

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

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

3. 요청 매개변수

3.1 경로 매개변수 (Path Parameters)

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

3.2 폼 매개변수 (Form Parameters)

multipart/form-data 형식을 사용하므로, 다음 매개변수는 폼 필드를 통해 제출되어야 합니다.

매개변수 이름	유형	필수 여부	설명
file	File	아니오	새로운 지도 데이터 파일.
name	String	아니오	지도 표시 이름.
gps	String	아니오	지도와 연결된 GPS 좌표 (예: "121.4541,31.2221").
tag	String	아니오	지도 태그.
meta	String	아니오	사용자 정의 메타데이터 (일반적으로 Base64 인코딩 문자열).
clusterInfo	String	아니오	클러스터 관련 정보.
emeBlocklist	String	아니오	EME 블랙리스트 구성, 기본값은 "[]".

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

요청이 성공하면(statusCode가 0) result에 업데이트된 지도 객체 상세 정보가 포함됩니다.

필드 이름	유형	설명
statusCode	Integer	상태 코드. 0은 성공을 의미합니다.
msg	String	상태 설명 메시지.
timestamp	DateTime	서버 응답 타임스탬프.
result	Object	업데이트된 `ARMapDTO` 객체.

ARMapDTO 객체 구조

필드 이름	유형	설명
mapId	String	지도 고유 식별자.
name	String	지도 이름.
status	String	지도 현재 상태.
size	Integer (int64)	지도 파일 크기(바이트).
gps	String	지도와 연결된 GPS 좌표 정보.
tag	String	지도 태그.
meta	String	사용자 정의 메타데이터.
md5	String	업데이트된 지도 파일의 MD5 체크섬.
modified	DateTime	마지막 수정 시간.

5. 상태 코드 (Status Codes)

Http Code	의미	설명
200	OK	요청 성공.
201	Created	업데이트 성공 및 관련 레코드 생성됨.
401	Unauthorized	인증 실패, 토큰 또는 서명을 확인하십시오.
403	Forbidden	해당 리소스에 대한 접근 권한 없음.
404	Not Found	지정된 `mapId`를 찾을 수 없음.

Status Code 오류 코드

스파셜 맵 APIs 오류 코드 설명

6. 예시 응답 (JSON)

{
  "statusCode": 0,
  "msg": "success",
  "timestamp": "2026-01-30T10:00:00Z",
  "result": {
    "mapId": "e61db301-e80f-4025-b822-9a00eb48d8d2",
    "name": "updated_office_scene",
    "status": "active",
    "gps": "121.4541,31.2221",
    "modified": "2026-01-30T10:00:00Z"
  }
}

Table of Contents