Bu sayfa, bir modelleme görevinin oluşturulmasından çıktılarının indirilmesine kadar olan tüm akışı, görev durumu geçişlerini ve modelleme çıktılarının içeriğini açıklar. API'leri çağırmadan önce Erişim Kılavuzu içindeki kurulumu tamamlayın.
Girdi Verisi Gereksinimleri
Girdi verisini modelleme ihtiyaçlarınıza göre seçin:
| Girdi türü | Açıklama | Öneri |
|---|---|---|
| LCC2 sahne paketi | Tarama yörüngesini içeren, info/poses.json gibi ilgili kaynaklarla birlikte eksiksiz sahne dizini | İnce model ayrıntısı, net dokular ve okunabilir metin gerektiğinde tercih edin |
| LAS nokta bulutu | Tarama yörüngesi içermeyen LiDAR nokta bulutu. RGB renk içermelidir (Point Data Record Format 2 / 3 / 5 / 7 / 8 / 10). Renksiz LAS desteklenmez | Yüksek boyutsal doğruluk gerektiğinde tercih edin |
| PLY nokta bulutu | Eksiksiz 3DGS nokta bulutu; tarama yörüngesi olmadan işlenebilir | Ne LCC2 sahne paketi ne de LAS nokta bulutu mevcut olduğunda kullanın |
İki yükleme biçimi desteklenir:
- Dizin biçimi: Birden fazla dosyayı göreli yollarını koruyarak doğrudan
inputdizinine yükleyin. - Arşiv biçimi: Bir
.zipdosyası yükleyin; sunucu arşivi otomatik olarak açar.
Minimum Entegrasyon Akışı
- Görev oluşturma: Görev Oluşturma ve Yükleme Kimlik Bilgilerini Alma API'sini çağırın. Otomatik modelleme varsayılan olarak etkindir (
autoRebuild = 1). Yanıt, görevinmodelIddeğerini ve yükleme için gerekli geçici kimlik bilgilerini içerir. - Girdi verilerini yükleme: Önceki adımda alınan geçici kimlik bilgileriyle, ilgili bulut sağlayıcısının nesne depolama API'si üzerinden dosyaları parçalar halinde yükleyin. Bkz. Geçici Yükleme Kimlik Bilgileri. Nihai dosya anahtarı (Key),
savePathile dosyanın göreli yolunun birleşimidir; örneğinsavePath + "render2/info/poses.json". - Yükleme tamamlandığını bildirme: Tüm dosyalar yüklendikten sonra Yükleme Durumunu Güncelleme API'sini
status = 3ile çağırın. Sistem modellemeyi otomatik olarak başlatır. - Görev ilerlemesini sorgulama: Sayfalı Görev Listesi veya Görev Ayrıntıları API'sini çağırın ve
statusilepercentdeğerlerini izleyin.status = 8modellemenin tamamlandığını,status = 9modellemenin başarısız olduğunu gösterir. Sorgulamayı 5 saniyeden daha sık yapmayın. - Çıktıları indirme: Geçici indirme bağlantılarını almak için Modelleme Sonuçlarını İndirme API'sini çağırın.
Not: Modelleme görevi eşzamanlılığı sınırlı değildir. Aynı anda birden fazla görev gönderebilirsiniz; her görev gönderildikten hemen sonra kuyruğa girer ve düğümler boşaldıkça hesaplama merkezi tarafından planlanır.
Desteklenen Diğer Akışlar
Kesintiden Devam Eden Yükleme ve Süresi Dolan Kimlik Bilgileri
Yükleme kesilirse veya geçici kimlik bilgilerinin süresi dolarsa yeni geçici yükleme kimlik bilgilerini almak için Yükleme Kimlik Bilgilerini Yeniden Alma API'sini çağırın, ardından çok parçalı yüklemeye devam edin.
Modellemeyi Manuel Başlatma
Görev autoRebuild = 0 ile oluşturulduğunda ve tüm girdi verileri yüklendiğinde geçerlidir. Modellemeyi manuel olarak başlatmak için Görevi Başlatma API'sini çağırın.
Görev Durum Makinesi
| status | Anlamı | Açıklama |
|---|---|---|
| 0 | Yükleme bekleniyor | Görev oluşturuldu, yükleme başlamadı |
| 1 | Yükleniyor | Görev oluşturulduktan sonraki varsayılan durum |
| 2 | Yükleme duraklatıldı | Entegratör tarafından bildirilen duraklatma |
| 3 | Yükleme tamamlandı | Bildirimden sonra sunucu input dizinini tarar; autoRebuild = 1 ise modelleme otomatik olarak başlar |
| 4 | Yükleme başarısız | Entegratör tarafından bildirilen hata |
| 5 | Kuyruğa girmesi bekleniyor | Ayrılmış durum; Open API senaryolarında oluşmaz |
| 6 | Kuyrukta | Hesaplama merkezine gönderildi, boş bir düğüm bekleniyor |
| 7 | Modelleniyor | Modelleme ilerlemesi için percent değerini izleyin |
| 8 | Modelleme tamamlandı | Çıktıları almak için indirme API'sini çağırın |
| 9 | Modelleme başarısız oldu | Nedeni bulmak için errorCode ve failedReason değerlerini okuyun |
Otomatik modellemede durum geçişleri:
0 Waiting for upload → 1 Uploading → 3 Upload completed → 6 Queued → 7 Modeling → 8 Modeling completed
↓ ↓
4 Upload failed 9 Modeling failedModelleme Çıktıları
Modelleme tamamlandığında aşağıdaki çıktılar üretilir. Ana indirmeler, LCC yerel koordinatlarındaki üç dosyadır.
| Çıktı dosyası | type değeri | Açıklama | Birimler ve koordinatlar |
|---|---|---|---|
model_align_scan.dxf | DXF | Düzenlenebilir vektör çizim, 3D 3DFACE mesh | Milimetre, 1:1, LCC yerel koordinatları |
model_align_scan.glb | GLB | GLB 3D model; önizleme veya oyun motorları için hazırdır | Metre, açıkça Z-yukarı, LCC yerel koordinatları |
model_align_scan.blend | BLEND | Düzenlenebilir Blender proje dosyası | LCC yerel koordinatları |
model_align_scan.rvt | RVT | Revit modeli | LCC yerel koordinatları |
Diğer yardımcı çıktılar arasında kat planı BEV görüntüsü, nokta bulutu bindirme görüntüsü, mobilya yerleşim görüntüsü, genel görüntülenmiş önizleme ve koordinat dönüşümü meta verisi coordinate_transform.json bulunur.
Bu bölüm XGRIDS'in resmî kullanım kılavuzundan Türkçeye çevrildi; ekran görüntüleri ve arayüz adları özgün haliyle İngilizcedir. İngilizce aslı (yeni sekmede açılır) · Güncelleme:
