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 を考慮し、購入前にサーバーネットワークに対応するリージョンを選択してください。現在サポートしているもの:

  • 中国リージョン
  • 北米リージョン

方法 1: EasyAR Developer Center で spatial map を管理する

小規模ビジネスシナリオに適しています。操作手順は次のとおりです。

  1. EasyAR Developer Center にログインし、SpatialMap に入ります。
  2. 中国リージョンまたは北米リージョンを選択します。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 リソースの関連付け、カスタムプロパティ

mgnt-web

方法 2: REST API を使用して自動管理する

大量のマップ管理を処理する必要がある場合は、Web Service REST API を使用し、アプリケーションまたは management backend 内で自動化 workflows を実装することを推奨します。

準備リソースチェックリスト

  • SpatialMap AppId
  • 認証 credential: API Key / API Secret または Token
  • Cloud URL: Spatial Map サービスのリクエストアドレスは data center によって分かれ、中国（デフォルト）と米国はそれぞれ次のとおりです。
    • 中国リージョン: https://armap-api.easyar.com
    • 北米リージョン: https://armap-api-na1.easyar.com

チェックリストリソースの取得

  • 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 権限をチェックしてください。API Key と権限制御について詳しくは、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 を管理できます。

関連トピック:

次のトピック: