Zum Hauptinhalt springen

CAD- und BIM-Modelle

Wandeln Sie ein Architektur- oder synthetisches 3D-Modell in eine Karte für AR Clip VPS um. Das eignet sich für Bauprojekte, Indoor-Navigation und digitale Zwillinge.

Die Geometrie vorbereiten​

  1. Importieren Sie das CAD- oder BIM-Modell in Blender, Unity oder ein ähnliches Programm.
  2. Lösen Sie instanziierte Objekte auf und entfernen Sie verdeckte oder unnötige Geometrie.
  3. Reduzieren Sie die Polygonzahl, aber behalten Sie die wichtigen Merkmale. Zielen Sie auf höchstens 5 Millionen Dreiecke.
  4. Wenn Sie das Modell in der Vorschau sehen wollen, erzeugen Sie UVs und backen Sie leichte Texturen.

Anker planen​

[
  { "name": "lobby", "position": [0.0, 0.0, 0.0] },
  { "name": "elevator_north", "position": [12.4, 0.0, 28.9] }
]
  • Die Koordinaten sind in Metern angegeben, gemessen vom Ursprung des Modells.
  • Verwenden Sie feste Namen wie lobby oder loading_dock, damit Ihr SDK-Code sie direkt nutzen kann.

Mit Python hochladen​

# upload_cad.py
from pathlib import Path
import json
import os
import requests

API_BASE = "https://api.arclip.app/vps/api/v3"
TOKEN = os.environ["ARCLIP_TOKEN"]
MODEL = Path("exports/mall.glb")
ANCHORS = Path("exports/anchors.json")

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

payload = {
    "name": "Mall Digital Twin",
    "dataType": "mesh",
    "sourceFormat": "glb",
    "anchors": json.loads(ANCHORS.read_text()),
    "publish": False
}

init = requests.post(f"{API_BASE}/maps/import", json=payload, headers=headers)
init.raise_for_status()
info = init.json()
map_id, upload_url = info["mapId"], info["uploadUrl"]

with MODEL.open("rb") as src:
    put = requests.put(upload_url, data=src, headers={"Content-Type": "model/gltf-binary"})
    put.raise_for_status()

finalize = requests.post(f"{API_BASE}/maps/{map_id}/finalize", json={}, headers=headers)
finalize.raise_for_status()
print(f"CAD map {map_id} queued → {finalize.json()['status']}")
  • Sie können die Anker gleich in der ersten Anfrage mitschicken oder später mit POST /maps/{id}/anchors hinzufügen.
  • Ist das Modell georeferenziert, ergänzen Sie coordinate ({"lat": ..., "lon": ..., "alt": ...}).

Die Karte prüfen​

  • Sehen Sie sich die Karte in arclip.design in der Vorschau an und korrigieren Sie bei Bedarf die Versätze der Anker.
  • Testen Sie die Lokalisierung mit dem Unity SDK. Richten Sie virtuelle Objekte über dieselben Anker-IDs aus.
  • Ändert sich das CAD-Modell, importieren Sie es erneut. Rufen Sie dafür POST /maps/{id}/update auf, statt eine neue Karte anzulegen – dann bleibt die mapId gleich.