Table of Contents

Manajemen data sparse spatial map

Bab ini memperkenalkan cara mengelola data sparse spatial map Spatial Map.

Data

Proses manajemen data peta adalah sebagai berikut:

  • Pembuatan dan upload: peta dibuat otomatis oleh EasyAR Sense di sisi perangkat dan di-upload ke cloud dalam format khusus.
  • Manajemen cloud: melalui management API, developer dapat mengintegrasikan fungsi manajemen seperti tambah, hapus, ubah, dan query peta.
  • Berbagi dan distribusi: mendukung berbagi peta. Peta yang di-upload oleh perangkat mana pun dapat digunakan oleh perangkat lain untuk localization, sehingga memungkinkan kolaborasi multi-perangkat.

Alur data

  • EasyAR Sense membuat dan meng-upload peta ke server. Saat digunakan, data peta diunduh dan digunakan. Sebelum digunakan, validitas cache diperiksa terlebih dahulu.
  • Sisi pengguna mengirim instruksi operasi ke server manajemen data melalui API.
flowchart TB

B[API atau EasyAR Web] --> A[Server manajemen data]

A[Server manajemen data] <-->  D[EasyAR Sense sisi perangkat] <--> C>Cache data sisi perangkat]

Data center

Dengan mempertimbangkan data center distribusi jaringan, pengguna sebaiknya memilih region yang sesuai dengan jaringan server sebelum membeli. Saat ini didukung:

  • Region China
  • Region Amerika Utara

Metode 1: mengelola spatial map di EasyAR Developer Center

Cocok untuk skenario bisnis skala kecil. Langkah operasinya sebagai berikut:

  1. Login ke EasyAR Developer Center dan masuk ke SpatialMap.
  2. Pilih region China atau region Amerika Utara. Jika SpatialMap library belum dibuat, buat SpatialMap library baru terlebih dahulu.
    • Karena EasyAR SpatialMap terikat dengan EasyAR Sense, operasi pembuatan SpatialMap library dilakukan di halaman Sense License Key.
    • Sense authorization -> SpatialMap

create-web

  1. Klik Manage pada daftar image library untuk masuk ke daftar SpatialMap. Klik Manage pada salah satu spatial map, seperti yang ditunjukkan pada gambar, untuk melakukan operasi manajemen berikut pada satu spatial map:

    • Operasi hapus
    • Operasi update (mark 1): nonaktifkan/aktifkan peta
    • Operasi update (mark 2): ubah nama
    • Operasi update (mark 3): ubah label: Label
    • Operasi update (mark 4): ubah lokasi: GNSS/GPS
    • Operasi update (mark 5): ubah Meta: kaitkan resource url dan properti kustom

mgnt-web

Metode 2: menggunakan REST API untuk manajemen otomatis

Untuk skenario yang perlu memproses banyak manajemen peta, disarankan menggunakan Web Service REST API agar workflow otomatis dapat diterapkan di aplikasi atau backend manajemen Anda.

Checklist resource persiapan

  • SpatialMap AppId
  • Credential autentikasi: API Key / API Secret atau Token
  • Cloud URL: alamat request layanan Spatial Map dibagi berdasarkan data center, China (default) dan Amerika Serikat:
    • Region China: https://armap-api.easyar.com
    • Region Amerika Utara: https://armap-api-na1.easyar.com

Mendapatkan resource checklist

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

    m1-appid

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

    m1-apikey

    Jika Anda belum memiliki API Key, buat API Key dan pastikan permission SpatialMap dicentang. Untuk mempelajari lebih lanjut tentang API Key dan kontrol permission, lihat Pengenalan API Key.

m1-apikey

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

m1-token

    Jika Anda perlu menyesuaikan masa berlaku Token, lihat UAC API - Membuat Token, lalu gunakan APIKey dan APISecret asli untuk membuat Token.

Panduan integrasi multi-end

Dalam workflow nyata, manajemen spatial map biasanya diintegrasikan ke server bisnis developer, mobile end, atau Unity:

  • Platform layanan bisnis: menyediakan kode contoh API dalam bahasa pengembangan server umum (Curl/Java/NodeJS/PHP) untuk membantu developer menerapkan manajemen spatial map.

  • Mobile end (Unity/Mobile): developer dapat menggunakan Unity untuk mengembangkan dan membuat spatial map, lalu mengelola spatial map berbasis Unity.

Topik terkait:

Topik berikutnya: