Table of Contents

희소 공간 맵 관리 APIs 소개

Api 전체 목록

Rest api 인터페이스 프로토콜과 인증 메커니즘

Spatial Map API는 표준 HTTP REST 전송 표준을 따릅니다.

Http 헤더

    Authorization: <APIKey에서 획득한 Token 입력>

Http 요청 매개변수, 두 가지 유형으로 분류:

  • 공통 매개변수 (총 포함 항목, 인증 방식에 따라 조합이 달라짐):

    • appId
    • timestamp(Long 형: 1970년 1월 1일 00:00:00 UTC 이후 경과된 밀리초)
    • apiKey
    • signature(요청 서명, token 방식 인증과 중복 선택 불가)

  • Spatial Map API 매개변수: API 고유의 매개변수

    API 문서에서는 인증용 공통 매개변수는 별도로 설명하지 않음

Api Key 인증

인증 방식은 두 가지입니다.

Token 기반 인증

Http 헤더 Authorization에 Token을 포함, 공통 매개변수는:

  • appId

서명 인증

Http 헤더 Authorization 미사용.

요청 매개변수에 signature 서명 정보 포함. 모든 매개변수가 서명 계산에 포함됨(이미지 제외).

  • appId
  • timestamp
  • apiKey
  • signature

서명 계산 상세 알고리즘은 문서 API Key 서명 방법을 참조하세요.

사용 예시와 속성 분석

Api 사용 예시

여기서 예시——Spatial Map 지도 데이터 조회 API 호출을 통해 개발자가 Spatial Map API 인터페이스와 공간 지도 구조를 이해하는 데 도움을 드립니다.

요청 예시

  GET /maps HTTP/1.1
  Host:
  Date: Mon, 1 Jan 2018 00:00:00 GMT
  Content-Type: application/json
  {
      "timestamp": 1769406019000,
      "apiKey": "8b485c648c3056e79c2a85ee9b...",
      "appId": "C:NA1:6fc8fe27af4a4d6cb02f4b494d2a9..",
      "signature": "89985e2420899196db5bdf16b3c2ed0922c0c221"
  }

응답 예시

 {
  "result": {
    "armaps": [
      {
        "mapId": "62d4f765-cc54-4dff-9c48-b7c8b4adbde9",
        "gps": "[0.0, 0.0]",
        "name": "Map_2020-09-28_1302",
        "size": 124140,
        "status": "active",
        "auxiliaryId": "62d4f765-cc54-4dff-9c48-b7c8b4adbde9",
        "created": 1601245841687,
        "modified": 1601245841687,
        "mapVersion": "esm1",
        "mapUrl": "https://prod-armap-1348728941.cos.na-siliconvalley...",
        "previewUrl": "https://prod-armap-1348728941.cos.na-siliconvalley...",
        "appKey": "C:NA1:6fc8fe27af4a4d6cb02f4b494d2a9f.."
      },
      {
        "mapId": "5ccdf1fb-0cd3-4580-80aa-42bd2289...",
        "gps": "[0.0, 0.0]",
        "name": "test",
        "size": 2419184,
        "status": "active",
        "auxiliaryId": "5ccdf1fb-0cd3-4580-80aa-42bd22897b...",
        "floor": "1",
        "tag": "cat",
        "created": 1601244090670,
        "modified": 1601244090670,
        "mapVersion": "esm1",
        "mapUrl": "https://prod-armap-1348728941.cos.na-siliconvalley....",
        "previewUrl": "https://prod-armap-1348728941.cos.na-siliconvalley...."
      }
    ],
    "page": {
      "total": 2,
      "pageNum": 1,
      "pageSize": 10,
      "pages": 1
    }
  },
  "statusCode": 0,
  "msg": "Success",
  "timestamp": 1769406021019
}

희소 지도 속성

위 예시와 같이, 정상 반환된 Spatial Map 공간 지도 구조체입니다

속성 설명
mapId 지도의 고유 Id
name 지도 이름
size 지도 파일 크기
meta 사용자 연관 데이터, 파일/텍스트/URL 가능, base64 인코딩 필요
status 활성화 여부, 두 값 [active inactive]
tag 사용자 정의 태그, 검색 편의
floor 층수, 검색 편의
gps 공간의 지리적 위치, wgs84 좌표계 또는 사용자 정의 좌표계 사용 가능
previewUrl 미리보기 이미지 다운로드

오류 코드

관련 주제