疎空間マップデータ管理

本章では、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 ライブラリが未作成の場合は、新規作成
   • EasyAR SpatialMap は EasyAR Sense と紐付くため、操作は Sense License Key ページ内で SpatialMap ライブラリを作成
   • Sense 認証 -> SpatialMap

3. ライブラリリストで 管理 をクリックし、SpatialMap リストに移動。任意の空間マップの 管理 をクリック。図のように、個々の空間マップに対して以下の管理操作が可能：

   • 削除操作
   • 更新操作（マーク1）: マップの無効化/有効化
   • 更新操作（マーク2）: 名称変更
   • 更新操作（マーク3）: ラベルの変更: Label
   • 更新操作（マーク4）: 位置情報の変更: GNSS/GPS
   • 更新操作（マーク5）: Meta の変更: 関連 url リソース、カスタム属性

方法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）

  

• API Key / API Secret の取得:
  開発センター -> クラウドサービス APIKey -> コピー

  

    API Key が未作成の場合は新規作成。SpatialMap 権限のチェックが必須。API Key と権限制御の詳細は、トピックAPI Key 概要を参照

• Token の取得:
  開発センター -> クラウドサービス APIKey -> 管理 -> 有効期間選択 -> Token 生成 -> コピー

    Token の有効期間をカスタマイズする必要がある場合は、UAC API —— Token 作成 方式を参照し、元の APIKey と APISecret を使用して Token を作成可能

マルチエンド統合ガイド

実際のワークフローでは、空間マップ管理は通常、開発者の業務サーバー、モバイル端末、または Unity に統合されます：

• 業務サービスプラットフォーム: 主要サーバー開発言語（Curl/Java/NodeJS/PHP）向け API 呼び出しサンプルコードを提供。空間マップ管理の実装を支援。

• モバイル端末（Unity/Mobile）: Unity を使用して空間マップを作成し、Unity ベースで空間マップを管理可能。

関連トピック：

• 疎空間マップ APIs 概要
• API Key 概要

次のトピック：

• 疎空間マップのリストとプレビュー