API Başvurusu

4 HTTP API Tanımları

4.1 Tek Harita Yeniden Oluşturma İşi Oluşturma

İstek Parametreleri

curl --location --request POST 'http://127.0.0.1:8080/lcc_cloud/start_reconstruction' \
--header 'Content-Type: application/json' \
--data-raw '{
     "accessKey": "y6vera"                  //Required. The API authentication KEY specified when the container was started
    ,"name": "job1"                        //Required. Job name
    ,"inputFolder": "/work/job001/input"    //Required. Path of the input data directory used for reconstruction (the path as mounted inside Docker)
    ,"outputFolder": "/work/job001/output"  //Required. Path of the reconstruction output destination directory (the path as mounted inside Docker)
    ,"hookUrl":"http://localhost:8080/lcc_cloud/job_progress_hook_sample" //Hook URL for execution status synchronization
    ,"quality":"M"                     //Required. Quality: "H" = high, "M" = medium, "L" = low
    ,"maximumGaussianPoint": 8         //Maximum number of Gaussian points, 8-50
    ,"lowMemory":0                //Whether to enable low-memory reconstruction: 0/1. Default is 0 (disabled), 1 enables it
    ,"exposure":0               //Whether to enable exposure optimization: 0/1. Default is 0 (disabled), 1 enables it
    ,"portability":"ON"                //Whether to enable cross-platform optimization: "ON/OFF". Enabled by default
    ,"pointCloudParticipationRate":"H" //PPR feature, "H" = high, "L" = low. Default is high. This is how much the point cloud participates in reconstruction.
    ,"jobQueueEnabled":1               //0: fail immediately if the server is currently busy. 1: allow the job to join the queue and wait its turn. When creating a single-map reconstruction job, this parameter defaults to 0 if omitted
    ,"hdImageFolder": "/work/job001/output"  //Folder for HD supplementary images. This is an advanced feature and requires a license, otherwise the parameter has no effect.
    ,"lccAiConfig":1 // 0 = disabled, 1 = enable AI spatial understanding. Beta feature, currently supports indoor scenes only. This is an advanced feature and requires a license, otherwise it must always be left at 0.
    ,"developerDataOutput":"ON" //Whether to output developer data ("ON" / "OFF"). Defaults to OFF when omitted. This is an advanced feature and requires a license, otherwise the parameter has no effect. See [Appendix: Developer Data]
    ,"createJobFolder":"ON"             //Whether to create a subdirectory named after the job under outputFolder: "ON"/"OFF"
    ,"lioMode":""                        //LIO special mode: "" auto / "0" none / "1" robust / "2" narrow scene
    ,"executionNodes":["192.168.11.11:8080","192.168.11.11:8081"]//In cluster mode, selects which nodes in the cluster may run this job
}'

Note:
1. Mind whether a parameter field is a string or a number; using the wrong type causes a parameter format error.
2. If a required parameter field is missing, adding or running the job will fail.
3. While a reconstruction job runs, the /work directory on the container node needs 5x the size of the input data in free disk space, otherwise the job may fail.

Zorunlu (kod tarafından uygulanır): accessKey, name, inputFolder, outputFolder.
(quality varsayılan olarak M, maximumGaussianPoint varsayılan olarak 12 değerini alır; hookUrl, hdImageFolder ve benzerleri isteğe bağlı gelişmiş öğelerdir.)

Yanıt Parametreleri

{
    "code":0,     // 0 means the API call succeeded; any other value means an unexpected error occurred
    "msg":"",     // On error, the message is returned here
    "data":{
        "bizCode": 0,  //Business return code: 0 = started or queued successfully, 1 = another job is running and it cannot start. For other error codes see the bizMsg response
        "bizMsg": "",  //Business processing message
        "jobId":"xxxx" //Current jobID, generated by the system at startup. Whether a job can be recovered depends on whether the database and the related working directories are persisted; it cannot be recovered if the container is deleted without a persisted database
    }
}

GİRDİ Verisi Doğrulama Hata Kodları Listesi

Girdi verisi doğrulamasının döndürebileceği hata kodları ve hata iletileri için en güncel hata kodu listesi belgesine bakın: Ek - Hata Kodu Listesi.

4.2 Çoklu Harita Birleştirme / Hava-Yer Birleştirme Yeniden Oluşturma İşi Oluşturma

İstek Parametreleri

curl --location --request POST 'http://127.0.0.1:8080/lcc_cloud/start_multi_reconstruction' \
--header 'Content-Type: application/json' \
--data-raw '{
    "accessKey": "y6vera"      //Required. The API authentication KEY specified when the container was started
    ,"name": "job1"            //Required. Job name
    ,"outputFolder": "/work/job001/output"  //Required. Path of the reconstruction output destination directory (the path as mounted inside Docker)
    ,"quality":"M"                     //Required. Quality: "H" = high, "M" = medium, "L" = low
    ,"maximumGaussianPoint": 8         //Maximum number of Gaussian points, 8-50
    ,"exposure":0               //Whether to enable exposure optimization: 0/1. Default is 0 (disabled), 1 enables it
    ,"portability":"ON"                // Whether to enable cross-platform optimization: "ON/OFF". Enabled by default
    ,"pointCloudParticipationRate":"H" // PPR feature, "H" = high, "L" = low. Default is high. This is how much the point cloud participates in reconstruction.
    ,"subTasks":[                        //Required.
        {
            "inputFolder":"/work/indoor-multi/1",   //Required. Path of the input data directory used for reconstruction (the path as mounted inside Docker)
        },
        {
            "inputFolder":"/work/indoor-multi/2",
        },
        ...
    ]
    ,"droneFolder":"/work/multi/4"           //Required for air-ground fusion. Storage directory for drone images; requires license support, otherwise the parameter has no effect.
    ,"hookUrl":"http://localhost:8080/lcc_cloud/job_progress_hook_sample" //Hook URL for execution status synchronization
    ,"jobQueueEnabled":1  //0: fail immediately if the server is currently busy. 1: allow the job to join the queue and wait its turn. When creating a multi-map reconstruction job, this parameter defaults to 1 if omitted
    ,"developerDataOutput":"ON" //Whether to output developer data ("ON" / "OFF"). Defaults to OFF when omitted. This is an advanced feature and requires a license.
    ,"createJobFolder":"ON"             //Whether to create a subdirectory named after the job under outputFolder: "ON"/"OFF"
    ,"lioMode":""                        //LIO special mode: "" auto / "0" none / "1" robust / "2" narrow scene
    ,"multiNodeRun":"ON" //In cluster mode, whether this job may use multi-node parallel computation for acceleration ("ON" / "OFF"). Defaults to "ON" in cluster mode; the parameter has no effect outside cluster mode.
    ,"executionNodes":["192.168.11.11:8080","192.168.11.11:8081"] //In cluster mode, selects which nodes in the cluster may run this job
}'

Note:
1. Mind whether a parameter field is a string or a number; using the wrong type causes a parameter format error.
2. If a required parameter field is missing, adding or running the job will fail.
3. While a reconstruction job runs, the /work directory on the container node needs 5x the size of the input data in free disk space, otherwise the job may fail.

• Yalnızca harita birleştirme: sadece subTasks[] gönderin.
• Hava-yer birleştirme: ayrıca "droneFolder": "/work/multi/drone" ekleyin (otomatik olarak hava-yer birleştirmeye geçer, lisans gerektirir).

Zorunlu (kod tarafından uygulanır): accessKey, name, subTasks[] (1-50 giriş); outputFolder yazılabilir bir yol olmalıdır.
(quality varsayılan olarak M değerini alır)

Yanıt Parametreleri

{
    "code":0,     // 0 means the API call succeeded; any other value means an unexpected error occurred
    "msg":"",     // On error, the message is returned here
    "data":{
        "bizCode": 0,//Business return code: 0 = started or created successfully, 1 = another job is running and it cannot start. For other error codes see the bizMsg response
        "bizMsg": "", //Business processing message
        "jobId":"xxxx" //Current jobID, generated by the system at startup. Whether a job can be recovered depends on whether the database and the related working directories are persisted; it cannot be recovered if the container is deleted without a persisted database
    }
}

4.3 Yeniden Oluşturma Durumunu Sorgulama (Yoklama İçin)

Yeniden oluşturma başlatılırken yürütme durumu, hookUrl parametresi aracılığıyla otomatik olarak eşitlenebilir.

Bu API ile de yoklama yapabilirsiniz.

İstek Parametreleri

curl --location --request POST 'http://127.0.0.1:8080/lcc_cloud/check_reconstruction' \
--header 'Content-Type: application/json' \
--data-raw '{
    "accessKey": "y6vera",     //Required. The API authentication KEY specified when the container was started
    "jobId":"xxxx"             //Current jobID. If this parameter is omitted, the status of the current job is returned directly
}

Yanıt Parametreleri

{
    "code":0,     // 0 means the API call succeeded; any other value means an unexpected error occurred
    "msg":"",     // On error, the message is returned here
    "data":{
        "bizCode": 0,//Business return code: 0 = no information for this job, 1 = this job is running, 2 = this job finished normally. Other values indicate an error, see bizMsg for details
        "bizMsg": "", //Business processing message
        "jobId":"xxxx", //Queried jobID
        "jobName":"xxxx",
        "progress":"<progress>" //Progress
    }
}

4.4 Yeniden Oluşturma Durumu Eşitleme İçin Örnek HOOK API

İmajın, geçerli JOB'ın yürütme durumunu zamanlanmış olarak başka bir iş sistemine otomatik eşitlemesini istiyorsanız,

iş sisteminde bu API'nin istek biçimini kabul eden bir HTTP POST API oluşturun ve yeniden oluşturmayı başlatırken bu API'nin URL'sini hookUrl parametresi olarak iletin.

İstek Parametreleri

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 is running, 2 = job finished normally. Other values indicate an error, see bizMsg for details
        "bizMsg": "",     //Business processing message
        "jobId":"xxxx"    //Currently running jobID
        "progress":"<progress>" //Progress
}'

Yanıt Parametreleri

Hook API herhangi bir yanıt döndürebilir; LCC sistemi bunu işlemez.

4.5 Yeniden Oluşturma İşini Yeniden Başlatma

İstek Parametreleri

curl --location --request POST 'http://127.0.0.1:8080/lcc_cloud/resume_reconstruction' \
--header 'Content-Type: application/json' \
--data-raw '{
    "accessKey": "y6vera"      //Required. The API authentication KEY specified when the container was started
   ,"jobId":"xxxx"             //Required. The jobID of the job to restart
}

Note:
If the container crashes unexpectedly, the job is aborted but its status cannot be updated to FAIL in time and stays as MODELING.
In that case you can also use this API to force this abnormal job to restart and continue running

Yanıt Parametreleri

{
    "code":0,     // 0 means the API call succeeded; any other value means an unexpected error occurred
    "msg":"",     // On error, the message is returned here
    "data":{
        "bizCode": 0,//Business return code: 0 = success. Other values indicate an error, see bizMsg for details
        "bizMsg": "", //Business processing message
    }
}

4.6 Çalışmayan Bir İşi Silme

İstek Parametreleri

curl --location --request POST 'http://127.0.0.1:8080/lcc_cloud/job_delete' \
--header 'Content-Type: application/json' \
--data-raw '{
    "accessKey": "y6vera"      //Required. The API authentication KEY specified when the container was started
   ,"jobId":"xxxx"             //Required. The jobID of the job to restart
}

Yanıt Parametreleri

{
    "code":0,     // 0 means the API call succeeded; any other value means an unexpected error occurred
    "msg":"",     // On error, the message is returned here
    "data":{
        "bizCode": 0,//Business return code: 0 = success. Other values indicate an error, see bizMsg for details
        "bizMsg": "", //Business processing message
    }
}

4.7 İş Kuyruğunun Otomatik Yürütülmesini Etkinleştirme veya Devre Dışı Bırakma

İstek Parametreleri

curl --location --request POST 'http://127.0.0.1:8080/lcc_cloud/job_queue_control' \
--header 'Content-Type: application/json' \
--data-raw '{
    "accessKey": "y6vera"     //Required. The API authentication KEY specified when the container was started
   ,"jobQueueControl":"ON"    //"ON" enables it; "OFF" disables it; any other value is ignored and only the current status is returned
}

Yanıt Parametreleri

{
    "code":0,     // 0 means the API call succeeded; any other value means an unexpected error occurred
    "msg":"",     // On error, the message is returned here
    "data":{
        "bizCode": 0,//Business return code: 0 = success. Other values indicate an error, see bizMsg for details
        "bizMsg": "", //Business processing message
        "jobQueueEnabled":true  //Whether the current server automatically processes jobs in the queue
    }
}

4.8 Havadan Yeniden Oluşturma İşi Oluşturma

İstek Parametreleri

curl --location --request POST 'http://127.0.0.1:8081/lcc_cloud/start_aerial_reconstruction' \
--header 'Content-Type: application/json' \
--data-raw '{
    "accessKey":"y6vera"    //Required. The API authentication KEY specified when the container was started
    ,"name":"AerialTestJob"   //Required. Job name
    ,"droneFolder":"/data/lcc-test-data/images" //Required. Path of the input drone images (the path as mounted inside Docker)
    ,"outputFolder": "/work/job001/output"          //Required. Path of the reconstruction output destination directory (the path as mounted inside Docker)
    ,"quality":"H"            //Required. Quality: "H" = high, "M" = medium, "L" = low
    ,"maximumGaussianPoint": 8               //Maximum number of Gaussian points, 8-50
    ,"exposure":0               //Whether to enable exposure optimization: 0/1. Default is 0 (disabled), 1 enables it
    ,"portability":"ON"          //Whether to enable cross-platform optimization: "ON"/"OFF", enabled by default
    ,"createJobFolder":"ON"       //Whether to create a subdirectory named after the job under outputFolder: "ON"/"OFF"
    ,"multiNodeRun":"ON"          //In cluster mode, whether multi-node parallel computation is allowed for acceleration
    ,"hookUrl":"http://localhost:8080/lcc_cloud/job_progress_hook_sample" //Hook URL for execution status synchronization
    ,"executionNodes":["192.168.11.11:8080","192.168.11.11:8081"]
}'

Note:
1. Mind whether a parameter field is a string or a number; using the wrong type causes a parameter format error.
2. If a required parameter field is missing, adding or running the job will fail.
3. While a reconstruction job runs, the /work directory on the container node needs 5x the size of the input data in free disk space, otherwise the job may fail.

Zorunlu (kod tarafından uygulanır): accessKey, name, droneFolder, outputFolder (yazılabilir olmalıdır).
(quality varsayılan olarak M değerini alır.)

Yanıt Parametreleri

{
    "code":0,     // 0 means the API call succeeded; any other value means an unexpected error occurred
    "msg":"",     // On error, the message is returned here
    "data":{
        "bizCode": 0,//Business return code: 0 = success. Other values indicate an error, see bizMsg for details
        "bizMsg": "", //Business processing message
        "jobQueueEnabled":true  //Whether the current server automatically processes jobs in the queue
    }
}

4.9 Yeniden Oluşturma İşini Zorla Durdurma

Çalışan bir işi zorla durdurur. İşlem sonlandırıldığı için işin olağan dışı biçimde bittiğini ve "FAIL" durumuna geçtiğini unutmayın.

Daha sonra [Yeniden oluşturma işini yeniden başlatma] API'si ile yeniden başlatabilirsiniz. İş, başarıyla tamamlanan son adımdan devam eder.

İstek Parametreleri

curl --location --request POST 'http://127.0.0.1:8080/lcc_cloud/stop_reconstruction' \
--header 'Content-Type: application/json' \
--data-raw '{
    "accessKey": "y6vera"      //Required. The API authentication KEY specified when the container was started
   ,"jobId":"xxxx"             //Required. The jobID of the job to force-abort
}

Yanıt Parametreleri

{
    "code":0,     // 0 means the API call succeeded; any other value means an unexpected error occurred
    "msg":"",     // On error, the message is returned here
    "data":{
        "bizCode": 0,//Business return code: 0 = success. Other values indicate an error, see bizMsg for details
        "bizMsg": "", //Business processing message
    }
}

4.10 Video Yeniden Oluşturma İşi Oluşturma

İstek parametreleri - doğrudan video dosyası girdisi

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",                //Required. Quality: "H" = high, "M" = medium, "L" = low
"maximumGaussianPoint":8,    //Maximum number of Gaussian points, 8-50
"name":"video-test",
"samplingFrameRate":1,         //Sampling rate (frames sampled per second): 1 / 2 / 4
"createJobFolder":"ON",
"portability":"ON",         //Whether to enable cross-platform optimization: "ON"/"OFF", enabled by default
"exposure":0,                 //Whether to enable exposure optimization: 0 = disabled, 1 = enabled, default 0 (disabled)
"inputType":"video",         //Required: video = direct video file input
"outputFolder":"/data/lcc_test_data_110/result",
"videoFile1Path":"/data/lcc_test_data_110/video/VID_20250703_102244.mp4"
}'

İstek parametreleri - ayıklanmış kare görüntü dizini girdisi

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", //Required. Quality: "H" = high, "M" = medium, "L" = low
"maximumGaussianPoint":8,  //Maximum number of Gaussian points, 8-50
"name":"iamges-test",
"samplingFrameRate":1,    //This field is not used in image mode
"createJobFolder":"ON",  
"portability":"ON",     //Whether to enable cross-platform optimization: "ON"/"OFF", enabled by default
"exposure":0,         //Whether to enable exposure optimization: 0 = disabled, 1 = enabled, default 0 (disabled)
"inputType":"image", //Required: image = direct extracted-frame image file input
"outputFolder":"/data/lcc_test_data_110/result",
"inputFolder":"/data/lcc_test_data_110/images" //In image mode the image directory must be passed
}'

Zorunlu (kod tarafından uygulanır): accessKey, outputFolder; video modu ayrıca {1,2,4} değerlerinden biri olan samplingFrameRate ile videoFile1Path gerektirir, görüntü modu ayrıca inputFolder gerektirir.
(name ve quality verilmemesi engellenmez; quality varsayılan olarak M değerini alır. Ancak işin iş listesinde kolay tanınması için name değerinin açıkça verilmesi önerilir.)

Yanıt Parametreleri

{
    "code":0,     // 0 means the API call succeeded; any other value means an unexpected error occurred
    "msg":"",     // On error, the message is returned here
    "data":{
        "bizCode": 0,//Business return code: 0 = success. Other values indicate an error, see bizMsg for details
        "bizMsg": "", //Business processing message
    }
}

API Kullanım Notları

Kimlik Doğrulama

• accessKey: zorunludur. İstek, yalnızca konteyner başlatılırken eklenen SERVICE_ACCESS_KEY değerine (yapılandırma öğesi config_app.AccessKey) tam olarak eşitse geçirilir.
• Sunucuda bu KEY yapılandırılmamışsa (boşsa) istekler doğrulama yapılmadan geçirilir; yapılandırıldıktan sonra eşleşmeme durumunda {"code":403,"msg":"Http authentication failed"} döndürülür.

Yanıt Zarfı

Tüm uç noktalar aynı zarfı döndürür:

{
  "code": 0,          // 0 = the call succeeded at the HTTP layer; non-zero = an error reading/parsing/authenticating the request (data is null in that case)
  "msg": "",          // Message on error
  "data": {
    "bizCode": 0,     // Business code: 0 = accepted (started or queued); non-zero = not accepted, see bizMsg for the reason
    "bizMsg": "",     // Business message (STARTED / SCHEDULED / failure reason)
    "jobId": "xxxx"   // ID of this job (may be empty if it was not accepted)
  }
}

bizCode Anlamları

Yol Kuralları

• inputFolder / outputFolder / droneFolder / hdImageFolder / videoFile*Path değerlerinin tümü konteyner içindeki yollardır (Docker'a bağlanan yollar), ana makine yolları değildir.
• Girdi yolları virgül , içermemelidir (doğrulama bunları reddeder).
• Yeniden oluşturma için boş /work disk alanında girdi verisi boyutunun yaklaşık 5 katı gerekir.

jobId Yaşam Döngüsü

• jobId verilmezse sistem bir tane üretir (zaman damgası ve 4 karakterlik rastgele bir dizeden oluşan, YYYYMMDD-HHMMSS-xxxx biçiminde). Siz bir tane verirseniz olduğu gibi kullanılır (çağıran tarafından tanımlanan idempotency kimlikleri için kullanışlıdır).
• jobId, iş kaydına ve çıktı dizinine bağlıdır. Varsayılan olarak çıktı dizini <outputFolder>/<jobId>/ biçiminde yapılandırılır ("Parametre ayrıntıları" altındaki createJobFolder bölümüne bakın).

Yürütme modeli: eşzamanlı kabul + eşzamansız doğrulama

Tüm API uç noktaları, istek kabul edilir edilmez yanıt döndürür: HTTP hızlıca bizCode=0 döndürür; girdi verilerinin gerçek doğrulaması, indirme ve yeniden oluşturma işlemleri ise arka planda bir eş yordamda (coroutine) çalışır. Bu nedenle isteğin başarıyla kabul edilmesi, yeniden oluşturmanın başarılı olduğu anlamına gelmez. Gerçek sonucu daha sonra check_reconstruction uç noktasını sorgulayarak ya da hookUrl geri çağrısı üzerinden (buildErrCode/buildErrLog alanlarını içerir) almanız gerekir.

---

Parametre Ayrıntıları

createJobFolder (ON/OFF, varsayılan OFF)

Çıktı dizininin nereye yazılacağını belirler:

• OFF (varsayılan): yeniden oluşturma sonuçları doğrudan outputFolder dizinine yazılır.
• ON: yeniden oluşturma sonuçları outputFolder/<jobId>/ alt dizinine yazılır.

quality (H/M/L)

Yeniden Oluşturma Kalite Seviyesi

• H: yüksek — daha yoğun örnekleme, daha yavaş, daha yüksek video belleği kullanımı, daha ince sonuçlar.
• M: orta (varsayılan).
• L: düşük — daha hızlı, daha az video belleği kullanır, daha kaba sonuçlar.

Temelde kullanılan kare çıkarma stratejisi cihaz ailelerine göre farklılık gösterir (L1/L2 kare adımı, L2Pro ise kare hızı kullanır). Ancak H daha yavaş ve daha ince, L ise daha hızlı ve daha hafiftir.

maximumGaussianPoint (sayı, aralık 8-50, varsayılan 12)

Gauss noktası sayısı üst sınırı, milyon nokta cinsindendir (dahili olarak x 1.000.000).

• <= 0 girilirse otomatik olarak 12 kullanılır.
• < 8 girilirse dahili olarak 8 kabul edilir (günlüğe bir uyarı yazılır).
• > 50 girilirse çoklu harita/hava/video işleri isteği doğrudan reddeder (hata kodu 0x3404102C); tek harita işi ise isteği açıkça reddetmez ve değeri yalnızca aşağıdaki video belleği formülüne göre kısaltır.
• Hangi değeri girerseniz girin, değer yine GPU video belleği formülü ile sınırlandırılır (üst sınırı aşan değerler sınıra indirilir):

Örnek: 24 GB VRAM üzerinde tek harita için üst sınır yaklaşık (24-1,5) x 2,304 ≈ 51,8 olduğundan 50 değeri 50 olarak kabul edilir. 8 GB VRAM ile üst sınır yaklaşık (8-1,5) x 2,304 ≈ 15 olduğundan 50 değeri 15'e kısaltılır.

portability (ON/OFF, varsayılan ON)

"Platformlar arası optimizasyon":

• ON (varsayılan) → küresel harmonik verileri üretilmez; platformlar arası uyumluluk korunur.
• OFF → platformlar arası iyileştirmeyi kapatır ve küresel harmonik verisi üretir.

Yani küresel harmonik verisi üretimini tetikleyen seçenek "OFF" değeridir. Küresel harmonik verisi veya daha yüksek kaliteli aydınlatma istiyorsanız (ve platformlar arası uyumluluk sizin için önemli değilse) "OFF" girin; aksi halde varsayılan ON değerini koruyun.

pointCloudParticipationRate (H/L, varsayılan algoritma değeridir)

Nokta bulutunun yeniden oluşturmaya katılım oranı (PPR):

• H: yüksek bütünlük
• L: düşük bütünlük
• Belirtilmezse varsayılan değer kullanılır (H ile eşdeğerdir).

jobQueueEnabled (0/1) — yalnızca tek harita için geçerlidir

Bu alan şu anda yalnızca tek harita uç noktasında anlamlıdır:

• Tek harita =0 (varsayılan): geçerli düğümde zaten çalışan bir iş varsa, iş kuyruğa alınmaz ve LAST TASK STILL IN PROGRESS (bizCode 1) hatasıyla hemen başarısız olur.
• Tek harita =1: düğüm meşgulse iş kuyruğa katılır ve bekler.

Çoklu harita/hava/video uç noktaları bu alanı okumaz: meşgul olduklarında jobQueueEnabled değerinden bağımsız olarak işi her zaman otomatik olarak kuyruğa alır.

subTasks[] (çoklu harita için zorunludur)

Alt görevlerin listesi, 1-50 girdi. Her alt görev:

droneFolder (çoklu harita / hava)

• Hava: zorunludur, drone görüntü dizinidir.
• Çoklu harita: isteğe bağlıdır; droneFolder girildiği ve dizin mevcut olduğu anda iş otomatik olarak "harita birleştirme" türünden "hava-yer birleştirme" türüne geçer (ek bir anahtar gerekmez).
• Drone görüntü koşulları: en az 100 görüntü, JPG/JPEG biçimi, çözünürlük >= 1024x768 ve RTK bilgisi içermelidir (hava-yer birleştirme için RTK'lı görüntülerin oranı >= %80 olmalıdır).

Video yeniden oluşturma girdisi: inputType + videoFile1Path / inputFolder

• inputType: "video" (varsayılan) veya "image".

  • video modu: videoFile1Path değerini okur (tek bir video dosyası).
  • image modu: inputFolder değerini okur (görüntü dizini; kare çıkarma atlanır ve görüntüler doğrudan çıkarılmış kareler olarak kullanılır).
• samplingFrameRate (örnekleme kare hızı): video modunda 1/2/4 değerlerinden biri olmalıdır, aksi halde istek reddedilir; image modunda yok sayılır.

Gelişmiş Özellik Anahtarları