Процесс моделирования

На этой странице описан полный путь задачи моделирования от создания до скачивания результатов, переходы между статусами задачи и состав результатов моделирования. Прежде чем вызывать API, выполните настройку из Руководства по подключению.

Требования к входным данным

Выберите входные данные в зависимости от задач моделирования:

Тип входных данных	Описание	Рекомендация
Пакет сцены LCC2	Полный каталог сцены со связанными ресурсами, например `info/poses.json`, и траекторией съёмки	Предпочтителен, если нужны детализированная модель, чёткие текстуры и читаемый текст
Облако точек LAS	Облако точек LiDAR без траектории съёмки. Должно содержать цвет RGB (Point Data Record Format 2 / 3 / 5 / 7 / 8 / 10). LAS без цвета не поддерживается	Предпочтителен, если нужна высокая точность размеров
Облако точек PLY	Полное облако точек 3DGS; обрабатывается без траектории съёмки	Используйте, если нет ни пакета сцены LCC2, ни облака точек LAS

Поддерживаются два способа загрузки:

Каталог: загрузите несколько файлов прямо в каталог input, сохранив их относительные пути.
Архив: загрузите файл .zip; сервер распакует его автоматически.

Минимальный процесс интеграции

Создайте задачу: вызовите Создание задачи и получение учётных данных для загрузки. Автоматическое моделирование включено по умолчанию (autoRebuild = 1). Ответ содержит modelId задачи и временные учётные данные для загрузки.
Загрузите входные данные: с временными учётными данными из предыдущего шага выполните загрузку частями через API объектного хранилища соответствующего облачного провайдера. См. Временные учётные данные для загрузки. Итоговый Key файла — это savePath плюс относительный путь файла, например savePath + "render2/info/poses.json".
Сообщите о завершении загрузки: после загрузки всех файлов вызовите Обновление статуса загрузки со значением status = 3. После этого система автоматически запустит моделирование.
Опрашивайте ход выполнения: вызывайте Постраничный список задач или Сведения о задачах и следите за полями status и percent. status = 8 означает, что моделирование завершено; status = 9 — что моделирование завершилось ошибкой. Опрашивайте не чаще одного раза в 5 секунд.
Скачайте результаты: вызовите Скачивание результатов моделирования, чтобы получить временные ссылки для скачивания.

Примечание: число параллельных задач моделирования не ограничено. Вы можете отправить несколько задач сразу; каждая попадает в очередь сразу после отправки, и вычислительный центр распределяет их по мере освобождения узлов.

Другие поддерживаемые сценарии

Докачка и истёкшие учётные данные

Если загрузка прервалась или срок действия временных учётных данных истёк, вызовите Повторное получение учётных данных для загрузки, чтобы получить новые временные учётные данные, и продолжите загрузку частями.

Ручной запуск моделирования

Подходит, если задача создана с autoRebuild = 0 и все входные данные загружены. Вызовите Запуск задачи, чтобы запустить моделирование вручную.

Конечный автомат статусов задачи

status	Значение	Описание
0	Ожидание загрузки	Задача создана, загрузка не начата
1	Загрузка	Статус по умолчанию после создания задачи
2	Загрузка приостановлена	Приостановка, о которой сообщила интегрирующая сторона
3	Загрузка завершена	После сообщения сервер сканирует каталог `input`; при `autoRebuild = 1` моделирование запускается автоматически
4	Ошибка загрузки	Ошибка, о которой сообщила интегрирующая сторона
5	Ожидание постановки в очередь	Зарезервированный статус; в сценариях Open API не встречается
6	В очереди	Отправлена в вычислительный центр, ожидает свободного узла
7	Моделирование	Ход моделирования отображается в поле `percent`
8	Моделирование завершено	Вызовите API скачивания, чтобы получить результаты
9	Ошибка моделирования	Причину смотрите в полях `errorCode` и `failedReason`

Переходы между статусами при автоматическом моделировании:

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

Результаты моделирования

По завершении моделирования создаются следующие результаты. Основные файлы для скачивания — три файла в исходных координатах LCC.

Файл результата	Значение type	Описание	Единицы и координаты
`model_align_scan.dxf`	`DXF`	Редактируемый векторный чертёж, 3D-сетка 3DFACE	Миллиметры, 1:1, исходные координаты LCC
`model_align_scan.glb`	`GLB`	3D-модель GLB для предпросмотра или движков	Метры, явная ось Z вверх, исходные координаты LCC
`model_align_scan.blend`	`BLEND`	Редактируемый файл проекта Blender	Исходные координаты LCC
`model_align_scan.rvt`	`RVT`	Модель Revit	Исходные координаты LCC

К вспомогательным результатам относятся BEV-изображение плана этажа, изображение наложения облака точек, изображение расстановки мебели, общий рендер для предпросмотра и метаданные преобразования координат coordinate_transform.json.