Flux de modélisation

Cette page décrit le déroulement complet d'une tâche de modélisation, de sa création jusqu'au téléchargement de ses résultats, les transitions d'état de la tâche et le contenu des résultats de modélisation. Effectuez la configuration décrite dans le Guide d'accès avant d'appeler les API.

Exigences relatives aux données d'entrée

Choisissez les données d'entrée selon vos besoins de modélisation :

Type d'entrée	Description	Recommandation
Package de scène LCC2	Répertoire de scène complet, incluant les ressources associées comme `info/poses.json`, avec trajectoire de capture	À privilégier lorsque vous avez besoin de détails fins, de textures nettes et de textes lisibles
Nuage de points LAS	Nuage de points LiDAR sans trajectoire de capture. Doit contenir la couleur RVB (Point Data Record Format 2 / 3 / 5 / 7 / 8 / 10). Les fichiers LAS sans couleur ne sont pas pris en charge	À privilégier lorsque vous avez besoin d'une grande précision dimensionnelle
Nuage de points PLY	Nuage de points 3DGS complet ; peut être traité sans trajectoire de capture	À utiliser lorsque vous ne disposez ni d'un package de scène LCC2 ni d'un nuage de points LAS

Deux formes d'importation sont prises en charge :

Forme répertoire : importez plusieurs fichiers directement dans le répertoire input, en conservant leurs chemins relatifs.
Forme archive : importez un .zip ; le serveur l'extrait automatiquement.

Flux d'intégration minimal

Créer une tâche : appelez Créer une tâche et obtenir les identifiants d'importation. La modélisation automatique est activée par défaut (autoRebuild = 1). La réponse contient le modelId de la tâche et les identifiants temporaires nécessaires à l'importation.
Importer les données d'entrée : avec les identifiants temporaires de l'étape précédente, importez par parties via l'API de stockage d'objets du fournisseur cloud correspondant. Voir Identifiants temporaires d'importation. La Key finale du fichier est savePath suivi du chemin relatif du fichier, par exemple savePath + "render2/info/poses.json".
Signaler la fin de l'importation : une fois tous les fichiers importés, appelez Mettre à jour l'état d'importation avec status = 3. Le système démarre alors automatiquement la modélisation.
Interroger la progression de la tâche : appelez Liste paginée des tâches ou Détails de la tâche et surveillez status et percent. status = 8 signifie que la modélisation est terminée ; status = 9 signifie que la modélisation a échoué. N'interrogez pas plus d'une fois toutes les 5 secondes.
Télécharger les résultats : appelez Télécharger les résultats de modélisation pour obtenir des liens de téléchargement temporaires.

Remarque : la concurrence des tâches de modélisation n'est pas limitée. Vous pouvez soumettre plusieurs tâches à la fois ; chacune entre dans la file d'attente dès sa soumission et est planifiée par le centre de calcul à mesure que des nœuds se libèrent.

Autres flux pris en charge

Reprise d'importation et identifiants expirés

Si une importation est interrompue ou si les identifiants temporaires expirent, appelez Obtenir à nouveau les identifiants d'importation pour obtenir de nouveaux identifiants temporaires d'importation, puis poursuivez l'importation multipartie.

Démarrer la modélisation manuellement

S'applique lorsque la tâche a été créée avec autoRebuild = 0 et que toutes les données d'entrée ont été importées. Appelez Démarrer une tâche pour démarrer la modélisation manuellement.

Machine à états de la tâche

status	Signification	Description
0	En attente d'importation	Tâche créée, importation non démarrée
1	Importation en cours	État par défaut après la création de la tâche
2	Importation suspendue	Suspension signalée par l'intégrateur
3	Importation terminée	Après le signalement, le serveur analyse le répertoire `input` ; avec `autoRebuild = 1`, la modélisation démarre automatiquement
4	Échec de l'importation	Échec signalé par l'intégrateur
5	En attente de mise en file	État réservé ; ne se produit pas dans les scénarios Open API
6	En file d'attente	Soumise au centre de calcul, en attente d'un nœud libre
7	Modélisation en cours	Surveillez `percent` pour suivre la progression de la modélisation
8	Modélisation terminée	Appelez l'API de téléchargement pour obtenir les résultats
9	Échec de la modélisation	Consultez `errorCode` et `failedReason` pour en trouver la cause

Transitions d'état avec modélisation automatique :

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

Résultats de modélisation

Les résultats suivants sont produits à la fin de la modélisation. Les téléchargements principaux sont les trois fichiers en coordonnées natives LCC.

Fichier de résultat	Valeur de type	Description	Unités et coordonnées
`model_align_scan.dxf`	`DXF`	Dessin vectoriel modifiable, maillage 3D 3DFACE	Millimètres, 1:1, coordonnées natives LCC
`model_align_scan.glb`	`GLB`	Modèle 3D GLB, prêt pour la prévisualisation ou les moteurs	Mètres, Z vers le haut explicite, coordonnées natives LCC
`model_align_scan.blend`	`BLEND`	Fichier de projet Blender modifiable	Coordonnées natives LCC
`model_align_scan.rvt`	`RVT`	Modèle Revit	Coordonnées natives LCC

Les autres résultats auxiliaires comprennent une image BEV du plan d'étage, une image de superposition du nuage de points, une image de l'agencement du mobilier, un aperçu de rendu global et les métadonnées de transformation de coordonnées coordinate_transform.json.