Table of Contents

Sparse spatial map 데이터 관리

이 장은 Spatial Map sparse spatial map 데이터를 관리하는 방법을 소개합니다.

데이터

맵 데이터의 관리 흐름은 다음과 같습니다.

  • 생성 및 업로드: 맵은 장치 측 EasyAR Sense가 자동으로 생성하고 전용 형식으로 cloud에 업로드합니다.
  • Cloud 관리: management APIs를 통해 개발자는 맵의 추가, 삭제, 수정, 조회 등의 관리 기능을 통합할 수 있습니다.
  • 공유 및 배포: 맵 공유를 지원합니다. 어떤 장치가 업로드한 맵이든 다른 장치가 localization에 사용할 수 있어 다중 장치 협업을 구현합니다.

데이터 흐름

  • EasyAR Sense가 맵을 생성하고 서버에 업로드합니다. 사용할 때는 맵 데이터를 다운로드하여 사용합니다. 사용 전 cache 유효성을 먼저 확인합니다.
  • 사용자 측은 API를 통해 데이터 관리 서버에 작업 명령을 보냅니다.
flowchart TB

B[API 또는 EasyAR Web] --> A[데이터 관리 서버]

A[데이터 관리 서버] <-->  D[장치 측 EasyAR Sense] <--> C>장치 측 데이터 cache]

Data center

네트워크 배포 data center를 고려하여 사용자는 구매 전에 서버 네트워크에 대응하는 region을 선택해야 합니다. 현재 지원:

  • China region
  • North America region

방법 1: EasyAR Developer Center에서 spatial map 관리

소규모 비즈니스 상황에 적합합니다. 작업 단계는 다음과 같습니다.

  1. EasyAR Developer Center에 로그인하고 SpatialMap으로 들어갑니다.
  2. China region 또는 North America region을 선택합니다. 아직 SpatialMap library를 만들지 않았다면 먼저 새 SpatialMap library를 만드십시오.
    • EasyAR SpatialMap은 EasyAR Sense와 바인딩되므로, Sense License Key 페이지에서 SpatialMap library를 생성합니다.
    • Sense authorization -> SpatialMap

create-web

  1. image library 목록에서 Manage를 클릭하여 SpatialMap 목록으로 들어갑니다. 임의의 spatial map에서 Manage를 클릭하면 그림과 같이 단일 spatial map에 대해 다음 관리 작업을 수행할 수 있습니다.

    • 삭제 작업
    • 업데이트 작업(mark 1): 맵 비활성화/활성화
    • 업데이트 작업(mark 2): 이름 수정
    • 업데이트 작업(mark 3): 라벨 수정: Label
    • 업데이트 작업(mark 4): 위치 수정: GNSS/GPS
    • 업데이트 작업(mark 5): Meta 수정: url resource 연결, custom property

mgnt-web

방법 2: REST API를 사용한 자동화 관리

많은 맵 관리를 처리해야 하는 경우, Web Service REST API를 사용하여 애플리케이션 또는 management backend에서 자동화 workflows를 구현하는 것을 권장합니다.

준비 resource checklist

  • SpatialMap AppId
  • 인증 credential: API Key / API Secret 또는 Token
  • Cloud URL: Spatial Map 서비스의 request 주소는 data center에 따라 China(기본값)와 US로 나뉩니다.
    • China region: https://armap-api.easyar.com
    • North America region: https://armap-api-na1.easyar.com

Checklist resource 얻기

  • SpatialMap AppId 얻기:
    Developer Center -> SpatialMap -> Select image library -> Manage -> Key (Authentication)

    m1-appid

  • API Key / API Secret 얻기:
    Developer Center -> Cloud Service APIKey -> Copy

    m1-apikey

    아직 API Key가 없다면 API Key를 만들고 SpatialMap permission을 반드시 체크하십시오. API Key 및 permission control에 대해 더 알아보려면 API Key 소개를 참고하십시오.

m1-apikey

  • Token 얻기:
    Developer Center -> Cloud Service APIKey -> Manage -> Select validity period -> Generate Token -> Copy

m1-token

    Token의 유효 기간을 사용자 지정해야 하는 경우 UAC API - Token 생성을 참고하여 원본 APIKey와 APISecret으로 Token을 만들 수 있습니다.

멀티 엔드 통합 가이드

실제 workflows에서 spatial map 관리는 일반적으로 개발자의 비즈니스 서버, mobile end 또는 Unity에 통합됩니다.

  • 비즈니스 서비스 플랫폼: 일반적인 서버 개발 언어(Curl/Java/NodeJS/PHP)의 API 예제 코드를 제공하여 개발자가 spatial map 관리를 구현하도록 돕습니다.

  • Mobile end(Unity/Mobile): 개발자는 Unity로 spatial maps를 개발 및 생성한 후 Unity 기반으로 spatial maps를 관리할 수 있습니다.

관련 주제:

다음 주제: