Skip to main content

Multi-session maps

Merge several AR Clip Mapper sessions of the same place into one denser indoor map. Use this for shops, campuses and other large venues where one pass is not enough.

Merge sessions​

  1. Record several sessions. Cover the same area along overlapping paths. For the best detail, use an iOS device with LiDAR.
  2. Find the session IDs. In arclip.design, open Maps → Sessions, select the recordings and note their session IDs.
  3. Start a merge with the REST API. The API returns the ID of the new map.
# merge_sessions.py
import os
import requests

API_BASE = "https://api.arclip.app/vps/api/v3"
TOKEN = os.environ["ARCLIP_TOKEN"]
SESSIONS = ["sess_01h5p", "sess_01h7d", "sess_01hb2"]

headers = {"Authorization": f"Bearer {TOKEN}"}

payload = {
    "name": "Flagship Store Superset",
    "sessions": SESSIONS,
    "publish": False
}

resp = requests.post(f"{API_BASE}/maps/merge", json=payload, headers=headers)
resp.raise_for_status()
info = resp.json()
map_id = info["mapId"]
print(f"Merge started for map {map_id}")

The merge creates a new map. Check its status the same way as for a regular import — see Check processing.

Tips​

  • Keep each recording under five minutes. This limits drift — small tracking errors that add up over time.
  • Leave visual anchors, such as posters or signs, that appear in several sessions.
  • When the status is READY, open the heatmap in the console and check that coverage is even.

Next: Panoramas and video — build a map from 360° photos or a walkthrough video.