API - Spatial Map 지도 검색

이 interface는 Spatial Map(공간 지도)을 검색하는 데 사용됩니다. 모든 검색 parameter는 optional입니다. 여러 field를 사용하여 검색할 때 시스템은 각 조건을 "AND" logic으로 연결합니다.

1. Interface 기본 정보

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

2. 인증 방식

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

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

3. Request parameters

3.1 Query parameters

모든 검색 parameter는 optional입니다.

Parameter name	Type	Required	Default value	Description
gps	String	아니요	-	이 GPS coordinate 근처의 map을 검색합니다.
range	Number	아니요	1.0	검색 범위(unit: km). `gps` parameter와 함께 사용해야 합니다.
name	String	아니요	-	map name으로 검색합니다.
tag	String	아니요	-	map tag로 검색합니다.

4. Response data structure (ARMapDTO)

Request가 성공하면(statusCode가 0), 반환된 result에는 조건에 맞는 map object array가 포함됩니다.

Field name	Type	Description
statusCode	Integer	상태 코드. 0은 성공을 의미합니다.
msg	String	상태 설명 정보.
timestamp	DateTime	서버 response timestamp.
result	Array	`ARMapDTO` object를 포함하는 array.

ARMapDTO object structure

Field name	Type	Description
mapId	String	map 고유 식별자.
name	String	map name.
status	String	map의 현재 상태.
size	Integer (int64)	map file size.
gps	String	map과 연결된 GPS coordinate 정보.
tag	String	map tag.
meta	String	custom metadata.
created	DateTime	생성 시간.
modified	DateTime	마지막 수정 시간.

5. Status codes

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

Status Code 오류 코드

Sparse Spatial Map APIs 오류 코드 설명

6. Response 예시 (JSON)

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

Table of Contents