APIコマンドセット

curl --location --request POST 'http://127.0.0.1:8080/lcc_cloud/start_reconstruction' \
--header 'Content-Type: application/json' \
--data-raw '{
     "accessKey": "y6vera"                  //必須。コンテナ起動時に指定した API 認証 KEY
    ,"name": "job1"                        //必須。ジョブ名
    ,"inputFolder": "/work/job001/input"    //必須。再構築に使う input データディレクトリのパス（Docker 内部にマウントされたパス）
    ,"outputFolder": "/work/job001/output"  //必須。 再構築の出力先ディレクトリのパス（Docker 内部にマウントされたパス）
    ,"hookUrl":"http://localhost:8080/lcc_cloud/job_progress_hook_sample" //実行状態を同期する Hook アドレス
    ,"quality":"M"                     //必須。 品質： "H":高  "M":中  "L":低
    ,"maximumGaussianPoint": 8         //最大ガウス点数 8-50   
    ,"lowMemory":0                //低メモリ再構築を有効にするか: 0/1。既定は 0（無効）、1 で有効
    ,"exposure":0               //露出最適化を有効にするか: 0/1。既定は 0（無効）、1 で有効
    ,"portability":"ON"                //クロスプラットフォーム最適化を有効にするか: "ON/OFF"。既定は有効
    ,"pointCloudParticipationRate":"H" //PPR 機能、"H":高  "L":低 。既定は高。再構築処理における点群の関与度です。
    ,"jobQueueEnabled":1               //0：サーバーが現在ビジーの場合は直接エラーを返します。1 ジョブキューに追加し、順番を待って実行できます。シングルマップ再構築ジョブの作成時にこのパラメータを渡さない場合、既定値は 0 です
    ,"hdImageFolder": "/work/job001/output"  //高精細補足撮影画像のフォルダ。この機能は高度な機能であり、ライセンスが必要です。ない場合はパラメータが無効になります。
    ,"lccAiConfig":1 // 0 無効 1 AI 空間理解を有効化。ベータ版機能で、現在は屋内シーンのみ対応。この機能は高度な機能でライセンスが必要です。ない場合は常に 0 のままにしてください。
    ,"developerDataOutput":"ON" //開発者データを出力するか（"ON" / "OFF"）,未入力の場合は既定で OFF。この機能は高度な機能であり、ライセンスが必要です。ない場合はパラメータが無効になります。【付録：開発者データ】を参照
    ,"createJobFolder":"ON"             //outputFolder の下にジョブ名でサブディレクトリを作成するか："ON"/"OFF"
    ,"lioMode":""                        //LIO 特殊モード：""自動 / "0"なし / "1"ロバスト / "2"狭小シーン
    ,"executionNodes":["192.168.11.11:8080","192.168.11.11:8081"]//クラスタモードで、クラスタ内のどのノードがこのジョブを実行できるかを選択します
}'

注意：
1，パラメータフィールドの型が string 型か number 型かに注意してください。誤るとパラメータ形式エラーになります。
2，必須パラメータフィールドが欠けていると、ジョブの追加または実行でエラーになります。
3，再構築ジョブの実行時、コンテナノードの /work ディレクトリには input データサイズの 5 倍のディスク容量が必要です。不足すると再構築ジョブが失敗する可能性があります。

{
    "code":0,     // 0 は API 呼び出し成功を表します；その他の数値は予期しない例外が発生したことを表します
    "msg":"",     // 例外時はここにメッセージが返されます
    "data":{
        "bizCode": 0,  //業務戻りコード ：0 開始またはキュー追加に成功  1 他のジョブが実行中で開始できません。 その他のエラーコードは bizMsg の戻り情報を参照してください
        "bizMsg": "",  //業務処理メッセージ
        "jobId":"xxxx" //現在の jobID。開始時にシステムが生成します。ジョブを復旧できるかどうかは、データベースおよび関連作業ディレクトリが永続化されているかによります；コンテナを削除しデータベースを永続化していない場合は復旧できません
    }
}

curl --location --request POST 'http://127.0.0.1:8080/lcc_cloud/start_multi_reconstruction' \
--header 'Content-Type: application/json' \
--data-raw '{
    "accessKey": "y6vera"      //必須。コンテナ起動時に指定した API 認証 KEY
    ,"name": "job1"            //必須。ジョブ名
    ,"outputFolder": "/work/job001/output"  //必須。 再構築の出力先ディレクトリのパス（Docker 内部にマウントされたパス）
    ,"quality":"M"                     //必須。 品質： "H":高  "M":中  "L":低
    ,"maximumGaussianPoint": 8         //最大ガウス点数 8-50  
    ,"exposure":0               //露出最適化を有効にするか: 0/1。既定は 0（無効）、1 で有効
    ,"portability":"ON"                // クロスプラットフォーム最適化を有効にするか: "ON/OFF"。既定は有効
    ,"pointCloudParticipationRate":"H" // PPR 機能、"H":高  "L":低 。既定は高。再構築処理における点群の関与度です。
    ,"subTasks":[                        //必須。
        {
            "inputFolder":"/work/indoor-multi/1",   //必須。再構築に使う input データディレクトリのパス（Docker 内部にマウントされたパス）
        },
        {
            "inputFolder":"/work/indoor-multi/2",
        },
        ...
    ]
    ,"droneFolder":"/work/multi/4"           //空地融合の場合は必須。ドローン画像の保存ディレクトリ。ライセンスによるサポートが必要で、ない場合はパラメータが無効になります。
    ,"hookUrl":"http://localhost:8080/lcc_cloud/job_progress_hook_sample" //実行状態を同期する Hook アドレス
    ,"jobQueueEnabled":1  //0：サーバーが現在ビジーの場合は直接エラーを返します。1 ジョブキューに追加し、順番を待って実行できます。マルチマップ再構築ジョブの作成時にこのパラメータを渡さない場合、既定値は 1 です
    ,"developerDataOutput":"ON" //開発者データを出力するか（"ON" / "OFF"）,未入力の場合は既定で OFF。この機能は高度な機能であり、ライセンスが必要です。
    ,"createJobFolder":"ON"             //outputFolder の下にジョブ名でサブディレクトリを作成するか："ON"/"OFF"
    ,"lioMode":""                        //LIO 特殊モード：""自動 / "0"なし / "1"ロバスト / "2"狭小シーン
    ,"multiNodeRun":"ON" //クラスタモードで、このジョブがマルチノード並列計算による高速化を許可するか（"ON" / "OFF"）。クラスタモードでは既定で "ON"、非クラスタモードではこのパラメータは無効です。
    ,"executionNodes":["192.168.11.11:8080","192.168.11.11:8081"] //クラスタモードで、クラスタ内のどのノードがこのジョブを実行できるかを選択します
}'

注意：
1，パラメータフィールドの型が string 型か number 型かに注意してください。誤るとパラメータ形式エラーになります。
2，必須パラメータフィールドが欠けていると、ジョブの追加または実行でエラーになります。
3，再構築ジョブの実行時、コンテナノードの /work ディレクトリには input データサイズの 5 倍のディスク容量が必要です。不足すると再構築ジョブが失敗する可能性があります。

{
    "code":0,     // 0 は API 呼び出し成功を表します；その他の数値は予期しない例外が発生したことを表します
    "msg":"",     // 例外時はここにメッセージが返されます
    "data":{
        "bizCode": 0,//業務戻りコード ：0 開始または作成に成功  1 他のジョブが実行中で開始できません。 その他のエラーコードは bizMsg の戻り情報を参照してください
        "bizMsg": "", //業務処理メッセージ
        "jobId":"xxxx" //現在の jobID。開始時にシステムが生成します。ジョブを復旧できるかどうかは、データベースおよび関連作業ディレクトリが永続化されているかによります；コンテナを削除しデータベースを永続化していない場合は復旧できません
    }
}

curl --location --request POST 'http://127.0.0.1:8080/lcc_cloud/check_reconstruction' \
--header 'Content-Type: application/json' \
--data-raw '{
    "accessKey": "y6vera",     //必須。コンテナ起動時に指定した API 認証 KEY
    "jobId":"xxxx"             //現在の jobID  このパラメータを渡さない場合は現在の job の状態がそのまま返されます
}

{
    "code":0,     // 0 は API 呼び出し成功を表します；その他の数値は予期しない例外が発生したことを表します
    "msg":"",     // 例外時はここにメッセージが返されます
    "data":{
        "bizCode": 0,//業務戻りコード ：0 この job の情報がありません   1 この job は実行中    2 この job は正常終了  その他の数値は異常です。詳細は bizMsg を参照してください 
        "bizMsg": "", //業務処理メッセージ
        "jobId":"xxxx", //照会した jobID
        "jobName":"xxxx",
        "progress":"<progress>" //進捗
    }
}

curl --location --request POST 'http://127.0.0.1:8080/lcc_cloud/job_progress_hook_sample' \
--header 'Content-Type: application/json' \
--data-raw '{
        "bizCode": 0,     //1 job は実行中    2 job は正常終了  その他の数値は異常です。詳細は bizMsg を参照してください 
        "bizMsg": "",     //業務処理メッセージ
        "jobId":"xxxx"    //現在実行中の jobID
        "progress":"<progress>" //進捗
}'

curl --location --request POST 'http://127.0.0.1:8080/lcc_cloud/resume_reconstruction' \
--header 'Content-Type: application/json' \
--data-raw '{
    "accessKey": "y6vera"      //必須。コンテナ起動時に指定した API 認証 KEY
   ,"jobId":"xxxx"             //必須。再開するジョブの jobID
}

注：
コンテナが異常終了した場合など、ジョブは異常中止されますがジョブ状態を FAIL に更新できず、MODELING 状態のままになります。
その場合も本 API を使って、この異常ジョブを強制的に再開して実行を継続できます

{
    "code":0,     // 0 は API 呼び出し成功を表します；その他の数値は予期しない例外が発生したことを表します
    "msg":"",     // 例外時はここにメッセージが返されます
    "data":{
        "bizCode": 0,//業務戻りコード ：0 成功  その他の数値は異常です。詳細は bizMsg を参照してください 
        "bizMsg": "", //業務処理メッセージ
    }
}

curl --location --request POST 'http://127.0.0.1:8080/lcc_cloud/job_delete' \
--header 'Content-Type: application/json' \
--data-raw '{
    "accessKey": "y6vera"      //必須。コンテナ起動時に指定した API 認証 KEY
   ,"jobId":"xxxx"             //必須。再開するジョブの jobID
}

{
    "code":0,     // 0 は API 呼び出し成功を表します；その他の数値は予期しない例外が発生したことを表します
    "msg":"",     // 例外時はここにメッセージが返されます
    "data":{
        "bizCode": 0,//業務戻りコード ：0 成功  その他の数値は異常です。詳細は bizMsg を参照してください 
        "bizMsg": "", //業務処理メッセージ
    }
}

curl --location --request POST 'http://127.0.0.1:8080/lcc_cloud/job_queue_control' \
--header 'Content-Type: application/json' \
--data-raw '{
    "accessKey": "y6vera"     //必須。コンテナ起動時に指定した API 認証 KEY
   ,"jobQueueControl":"ON"    //"ON"で有効； "OFF"で無効；その他は処理せず、現在の状態のみを返します
}

{
    "code":0,     // 0 は API 呼び出し成功を表します；その他の数値は予期しない例外が発生したことを表します
    "msg":"",     // 例外時はここにメッセージが返されます
    "data":{
        "bizCode": 0,//業務戻りコード ：0 成功  その他の数値は異常です。詳細は bizMsg を参照してください 
        "bizMsg": "", //業務処理メッセージ
        "jobQueueEnabled":true  //現在のサーバーがジョブキュー内のジョブを自動的に処理するかどうか
    }
}

curl --location --request POST 'http://127.0.0.1:8081/lcc_cloud/start_aerial_reconstruction' \
--header 'Content-Type: application/json' \
--data-raw '{
    "accessKey":"y6vera"    //必須。コンテナ起動時に指定した API 認証 KEY
    ,"name":"AerialTestJob"   //必須。ジョブ名
    ,"droneFolder":"/data/lcc-test-data/k1/images" //必須。入力するドローン画像のパス（Docker 内部にマウントされたパス）
    ,"outputFolder": "/work/job001/output"          //必須。 再構築の出力先ディレクトリのパス（Docker 内部にマウントされたパス）
    ,"quality":"H"            //必須。 品質： "H":高  "M":中  "L":低
    ,"maximumGaussianPoint": 8               //最大ガウス点数 8-50  
    ,"exposure":0               //露出最適化を有効にするか: 0/1。既定は 0（無効）、1 で有効
    ,"portability":"ON"          //クロスプラットフォーム最適化を有効にするか："ON"/"OFF"、既定は有効
    ,"createJobFolder":"ON"       //outputFolder の下にジョブ名でサブディレクトリを作成するか："ON"/"OFF"
    ,"multiNodeRun":"ON"          //クラスタモードでマルチノード並列計算による高速化を許可するか
    ,"hookUrl":"http://localhost:8080/lcc_cloud/job_progress_hook_sample" //実行状態を同期する Hook アドレス
    ,"executionNodes":["192.168.11.11:8080","192.168.11.11:8081"]
}'

注意：
1，パラメータフィールドの型が string 型か number 型かに注意してください。誤るとパラメータ形式エラーになります。
2，必須パラメータフィールドが欠けていると、ジョブの追加または実行でエラーになります。
3，再構築ジョブの実行時、コンテナノードの /work ディレクトリには input データサイズの 5 倍のディスク容量が必要です。不足すると再構築ジョブが失敗する可能性があります。

{
    "code":0,     // 0 は API 呼び出し成功を表します；その他の数値は予期しない例外が発生したことを表します
    "msg":"",     // 例外時はここにメッセージが返されます
    "data":{
        "bizCode": 0,//業務戻りコード ：0 成功  その他の数値は異常です。詳細は bizMsg を参照してください 
        "bizMsg": "", //業務処理メッセージ
        "jobQueueEnabled":true  //現在のサーバーがジョブキュー内のジョブを自動的に処理するかどうか
    }
}

curl --location --request POST 'http://127.0.0.1:8080/lcc_cloud/stop_reconstruction' \
--header 'Content-Type: application/json' \
--data-raw '{
    "accessKey": "y6vera"      //必須。コンテナ起動時に指定した API 認証 KEY
   ,"jobId":"xxxx"             //必須。強制中止するジョブの jobID
}

{
    "code":0,     // 0 は API 呼び出し成功を表します；その他の数値は予期しない例外が発生したことを表します
    "msg":"",     // 例外時はここにメッセージが返されます
    "data":{
        "bizCode": 0,//業務戻りコード ：0 成功  その他の数値は異常です。詳細は bizMsg を参照してください 
        "bizMsg": "", //業務処理メッセージ
    }
}

curl --location --request POST 'http://127.0.0.1:8080/lcc_cloud/start_video_reconstruction' \
--header 'Content-Type: application/json' \
--data-raw '{
"accessKey":"y6vera",
"quality":"H",                //必須。 品質： "H":高  "M":中  "L":低
"maximumGaussianPoint":8,    //最大ガウス点数 8-50 
"name":"video-test",
"samplingFrameRate":1,         //サンプリング頻度（毎秒のサンプリングフレーム数）： 1 / 2 / 4 
"createJobFolder":"ON",
"portability":"ON",         //クロスプラットフォーム最適化を有効にするか："ON"/"OFF"、既定は有効
"exposure":0,                 //露出最適化を有効にするか：0 無効、1 有効、既定 0（無効）
"inputType":"video",         //必須 ： video: 動画ファイルの直接入力
"outputFolder":"/data/lcc_test_data_110/result",
"videoFile1Path":"/data/lcc_test_data_110/video/VID_20250703_102244.mp4"
}'

curl --location --request POST 'http://127.0.0.1:8080/lcc_cloud/start_video_reconstruction' \
--header 'Content-Type: application/json' \
--data-raw '{
"accessKey":"y6vera",
"quality":"H", //必須。 品質： "H":高  "M":中  "L":低
"maximumGaussianPoint":8,  //最大ガウス点数 8-50 
"name":"iamges-test",
"samplingFrameRate":1,    //画像モードではこのフィールドを使用しません
"createJobFolder":"ON",  
"portability":"ON",     //クロスプラットフォーム最適化を有効にするか："ON"/"OFF"、既定は有効
"exposure":0,         //露出最適化を有効にするか：0 無効、1 有効、既定 0（無効）
"inputType":"image", //必須 ： image: 抽出フレーム画像ファイルの直接入力
"outputFolder":"/data/lcc_test_data_110/result",
"inputFolder":"/data/lcc_test_data_110/images" //画像モードでは画像ディレクトリを必ず渡してください
}'

{
    "code":0,     // 0 は API 呼び出し成功を表します；その他の数値は予期しない例外が発生したことを表します
    "msg":"",     // 例外時はここにメッセージが返されます
    "data":{
        "bizCode": 0,//業務戻りコード ：0 成功  その他の数値は異常です。詳細は bizMsg を参照してください 
        "bizMsg": "", //業務処理メッセージ
    }
}