Table of Contents

Sparse spatial map 데이터 관리

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

데이터

지도 데이터 관리 프로세스는 다음과 같습니다:

  • 생성 및 업로드: 지도는 디바이스 측에서 EasyAR Sense에 의해 자동으로 생성되며 전용 형식으로 클라우드에 업로드됩니다.
  • 클라우드 관리: 관리 API를 통해 개발자는 지도의 추가, 삭제, 수정, 조회와 같은 관리 기능을 통합할 수 있습니다.
  • 공유 및 배포: 지도 공유를 지원하며, 하나의 디바이스에서 업로드한 지도는 다른 디바이스에서 위치 파악에 사용될 수 있어 다중 디바이스 협업이 가능합니다.

데이터 흐름

  • EasyAR Sense가 생성하여 서버에 업로드합니다. 사용 시 지도 데이터를 다운로드하여 사용합니다. 사용 전에 캐시 유효성을 확인하세요.
  • 사용자 측에서 API를 통해 데이터 관리 서버에 작업 명령을 전송합니다
flowchart TB

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

A[데이터 관리 서버] <-->  D[디바이스 측 EasyAR Sense] <--> C>디바이스 측 데이터 캐시]

데이터 센터

네트워크 배포 데이터 센터를 고려하여 구매 전 서버 네트워크에 해당하는 지역을 선택하세요. 현재 지원되는 지역:

  • 중국 지역
  • 북미 지역

방법1: EasyAR 개발 센터에서 공간 지도 관리

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

  1. EasyAR 개발 센터에 로그인하여 SpatialMap으로 이동합니다.
  2. 중국 지역 또는 북미 지역을 선택합니다. 아직 SpatialMap 라이브러리를 생성하지 않았다면 먼저 새 SpatialMap 라이브러리를 생성하세요.
    • EasyAR SpatialMap은 EasyAR Sense와 바인딩되어 있으므로 작업은 Sense License Key 페이지에서 SpatialMap 라이브러리를 생성하는 것입니다
    • Sense 인증 -> SpatialMap

create-web

  1. 갤러리 목록에서 관리를 클릭하면 SpatialMap 목록으로 이동합니다. 임의의 공간 지도에서 관리를 클릭하면 아래 그림과 같이 개별 공간 지도에 대해 다음과 같은 관리 작업을 수행할 수 있습니다

    • 삭제 작업
    • 업데이트 작업(표시 1): 지도 비활성화/활성화
    • 업데이트 작업(표시 2): 이름 수정
    • 업데이트 작업(표시 3): 레이블 수정: Label
    • 업데이트 작업(표시 4): 위치 수정: GNSS/GPS
    • 업데이트 작업(표시 5): 메타 수정: 관련 url 리소스, 사용자 정의 속성

mgnt-web

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

많은 지도 관리를 처리해야 하는 경우에는 Web Service REST API를 사용하여 애플리케이션 또는 관리 백엔드에서 자동화된 워크플로우를 구현하는 것이 좋습니다.

리소스 목록 준비

  • SpatialMap AppId
  • 인증 자격 증명: API Key / API Secret 또는 Token
  • Cloud URL: Spatial Map 서비스의 요청 주소는 데이터 센터별로 구분되며, 중국(기본값)과 미국은 각각 다음과 같습니다:
    • 중국 지역: https://armap-api.easyar.com
    • 북미 지역: https://armap-api-na1.easyar.com

리소스 목록 가져오기

  • SpatialMap AppId 가져오기:
    개발 센터 -> SpatialMap -> 갤러리 선택 -> 관리 -> 키(Authentication)

    m1-appid

  • API Key / API Secret 가져오기:
    개발 센터 -> 클라우드 서비스 APIKey -> 복사

    m1-apikey

    아직 API Key가 없다면 API Key를 생성하고, 반드시 SpatialMap 권한을 선택해야 합니다. API Key 및 권한 제어에 대한 자세한 내용은 주제 API Key 소개를 참조하세요.

m1-apikey

  • Token 가져오기:
    개발 센터 -> 클라우드 서비스 APIKey -> 관리 -> 유효 기간 선택 -> Token 생성 -> 복사

m1-token

    Token의 유효 기간을 사용자 정의해야 하는 경우, UAC API —— Token 생성 방식을 참조하여 원본 APIKey와 APISecret을 사용하여 Token을 생성할 수 있습니다.

다중 클라이언트 통합 가이드

실제 워크플로우에서 공간 지도 관리는 일반적으로 개발자의 비즈니스 서버, 모바일 또는 Unity에 통합됩니다:

  • 비즈니스 서비스 플랫폼: 일반적인 서버 개발 언어(Curl/Java/NodeJS/PHP)로 API를 호출하는 샘플 코드를 제공하여 개발자가 공간 지도 관리를 구현할 수 있도록 돕습니다.

  • 모바일(Unity/Mobile): 개발자는 Unity를 사용하여 공간 지도를 생성하고, Unity를 기반으로 공간 지도를 관리할 수 있습니다.

관련 주제:

다음 주제: