モデリングワークフロー

このページでは、モデリングタスクの作成から出力物のダウンロードまでの全体の流れ、タスクのステータス遷移、およびモデリング出力物の内容について説明します。API を呼び出す前に、接続ガイドの準備を完了してください。

入力データの要件

モデリングの目的に応じて入力データを選択してください。

入力タイプ	説明	推奨
LCC2 シーンパッケージ	`info/poses.json` などの関連リソースを含む完全なシーンディレクトリ。キャプチャ・パスを含みます	モデルの細部、鮮明なテクスチャ、判読できる文字が必要な場合に推奨
LAS 点群	キャプチャ・パスを含まない LiDAR 点群。RGB カラーを含む必要があります（Point Data Record Format 2 / 3 / 5 / 7 / 8 / 10）。カラーなしの LAS には対応していません	高い寸法精度が必要な場合に推奨
PLY 点群	完全な 3DGS 点群。キャプチャ・パスなしで処理できます	LCC2 シーンパッケージと LAS 点群のどちらも用意できない場合に使用

アップロード形式は次の 2 種類に対応しています。

ディレクトリ形式：複数のファイルを相対パスを保ったまま 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 ネイティブ座標の 3 つのファイルです。

出力ファイル	type の値	説明	単位と座標
`model_align_scan.dxf`	`DXF`	編集可能なベクター図面。3D 3DFACE メッシュ	ミリメートル、1:1、LCC ネイティブ座標
`model_align_scan.glb`	`GLB`	GLB 3D モデル。プレビューやエンジンでそのまま使用できます	メートル、明示的な Z-up、LCC ネイティブ座標
`model_align_scan.blend`	`BLEND`	編集可能な Blender プロジェクトファイル	LCC ネイティブ座標
`model_align_scan.rvt`	`RVT`	Revit モデル	LCC ネイティブ座標

その他の補助的な出力物として、平面図 BEV 画像、点群オーバーレイ画像、家具レイアウト画像、全体レンダリングプレビュー、座標変換メタデータ coordinate_transform.json があります。