Modellierungsablauf

Diese Seite beschreibt den vollständigen Ablauf einer Modellierungsaufgabe von der Erstellung bis zum Herunterladen der Ergebnisse, die Statusübergänge der Aufgabe sowie den Inhalt der Modellierungsergebnisse. Schließen Sie vor dem Aufruf der APIs die Einrichtung gemäß Zugangsleitfaden ab.

Anforderungen an die Eingabedaten

Wählen Sie die Eingabedaten entsprechend Ihren Modellierungsanforderungen:

Eingabetyp	Beschreibung	Empfehlung
LCC2-Szenenpaket	Vollständiges Szenenverzeichnis einschließlich zugehöriger Ressourcen wie `info/poses.json`, mit Erfassungstrajektorie	Bevorzugt, wenn feine Modelldetails, klare Texturen und lesbarer Text benötigt werden
LAS-Punktwolke	LiDAR-Punktwolke ohne Erfassungstrajektorie. Muss RGB-Farbe enthalten (Point Data Record Format 2 / 3 / 5 / 7 / 8 / 10). LAS ohne Farbe wird nicht unterstützt	Bevorzugt, wenn hohe Maßgenauigkeit benötigt wird
PLY-Punktwolke	Vollständige 3DGS-Punktwolke; kann ohne Erfassungstrajektorie verarbeitet werden	Verwenden, wenn weder ein LCC2-Szenenpaket noch eine LAS-Punktwolke verfügbar ist

Zwei Upload-Formen werden unterstützt:

Verzeichnisform: Mehrere Dateien direkt in das Verzeichnis input hochladen, wobei ihre relativen Pfade erhalten bleiben.
Archivform: Eine .zip-Datei hochladen; der Server entpackt sie automatisch.

Minimaler Integrationsablauf

Aufgabe erstellen: Rufen Sie Aufgabe erstellen und Upload-Zugangsdaten abrufen auf. Die automatische Modellierung ist standardmäßig aktiviert (autoRebuild = 1). Die Antwort enthält die modelId der Aufgabe und die für den Upload benötigten temporären Zugangsdaten.
Eingabedaten hochladen: Laden Sie mit den temporären Zugangsdaten aus dem vorherigen Schritt die Daten in Teilen über die Objektspeicher-API des jeweiligen Cloud-Anbieters hoch. Siehe Temporäre Upload-Zugangsdaten. Der endgültige Datei-Key ist savePath plus der relative Pfad der Datei, zum Beispiel savePath + "render2/info/poses.json".
Upload-Abschluss melden: Nachdem alle Dateien hochgeladen sind, rufen Sie Upload-Status aktualisieren mit status = 3 auf. Das System startet dann automatisch die Modellierung.
Aufgabenfortschritt abfragen: Rufen Sie Paginierte Aufgabenliste oder Aufgabendetails auf und beobachten Sie status und percent. status = 8 bedeutet, dass die Modellierung abgeschlossen ist; status = 9 bedeutet, dass die Modellierung fehlgeschlagen ist. Fragen Sie höchstens alle 5 Sekunden ab.
Ergebnisse herunterladen: Rufen Sie Modellierungsergebnisse herunterladen auf, um temporäre Download-Links zu erhalten.

Hinweis: Die Parallelität der Modellierungsaufgaben ist nicht begrenzt. Sie können mehrere Aufgaben gleichzeitig absenden; jede wird direkt nach dem Absenden in die Warteschlange gestellt und vom Rechenzentrum eingeplant, sobald Knoten frei werden.

Weitere unterstützte Abläufe

Fortsetzbarer Upload und abgelaufene Zugangsdaten

Wenn ein Upload unterbrochen wird oder die temporären Zugangsdaten ablaufen, rufen Sie Upload-Zugangsdaten erneut abrufen auf, um neue temporäre Upload-Zugangsdaten zu erhalten, und setzen Sie dann den mehrteiligen Upload fort.

Modellierung manuell starten

Gilt, wenn die Aufgabe mit autoRebuild = 0 erstellt wurde und alle Eingabedaten hochgeladen sind. Rufen Sie Aufgabe starten auf, um die Modellierung manuell zu starten.

Zustandsautomat der Aufgabe

status	Bedeutung	Beschreibung
0	Warten auf Upload	Aufgabe erstellt, Upload nicht gestartet
1	Upload läuft	Standardstatus nach dem Erstellen der Aufgabe
2	Upload pausiert	Vom Integrator gemeldete Pause
3	Upload abgeschlossen	Nach der Meldung durchsucht der Server das Verzeichnis `input`; bei `autoRebuild = 1` startet die Modellierung automatisch
4	Upload fehlgeschlagen	Vom Integrator gemeldeter Fehler
5	Warten auf Einreihung	Reservierter Status; tritt in Open-API-Szenarien nicht auf
6	In Warteschlange	An das Rechenzentrum übermittelt, wartet auf einen freien Knoten
7	Modellierung läuft	Beobachten Sie `percent` für den Modellierungsfortschritt
8	Modellierung abgeschlossen	Rufen Sie die Download-API auf, um die Ergebnisse zu erhalten
9	Modellierung fehlgeschlagen	Lesen Sie `errorCode` und `failedReason`, um die Ursache zu ermitteln

Statusübergänge bei automatischer Modellierung:

0 Waiting for upload → 1 Uploading → 3 Upload completed → 6 Queued → 7 Modeling → 8 Modeling completed
                           ↓                                                 ↓
                     4 Upload failed                                 9 Modeling failed

Modellierungsergebnisse

Nach Abschluss der Modellierung werden die folgenden Ergebnisse erzeugt. Die zentralen Downloads sind die drei Dateien in nativen LCC-Koordinaten.

Ergebnisdatei	type-Wert	Beschreibung	Einheiten und Koordinaten
`model_align_scan.dxf`	`DXF`	Bearbeitbare Vektorzeichnung, 3D-3DFACE-Mesh	Millimeter, 1:1, native LCC-Koordinaten
`model_align_scan.glb`	`GLB`	GLB-3D-Modell, bereit für Vorschau oder Engines	Meter, explizit Z-up, native LCC-Koordinaten
`model_align_scan.blend`	`BLEND`	Bearbeitbare Blender-Projektdatei	Native LCC-Koordinaten
`model_align_scan.rvt`	`RVT`	Revit-Modell	Native LCC-Koordinaten

Weitere Hilfsergebnisse sind ein BEV-Grundrissbild, ein Punktwolken-Überlagerungsbild, ein Möblierungsplanbild, eine gerenderte Gesamtvorschau sowie die Metadaten zur Koordinatentransformation coordinate_transform.json.