API Genel Bakış

Bu bölüm, MipMapEngine SDK için tüm mevcut arayüzler, parametre açıklamaları ve kullanım örnekleri dahil olmak üzere tam API referans dokümantasyonu sağlar.

Başlamadan Önce

Henüz SDK'yı yüklemediyseniz, lütfen önce Kurulum Kılavuzu'na bakın. İlk kez kullanan kullanıcılar için Hızlı Başlangıç ile başlamanız önerilir.

MipMapEngine SDK, farklı kullanım senaryolarını karşılamak için çeşitli arayüzler sağlar:

🏗️ SDK Mimarisi

MipMapEngine SDK Mimari Katmanları

Uygulama Katmanı

• Uygulamanız | Python/C++/CLI | Web Servisleri

API Arayüz Katmanı

• ReconstructFull (Tam İşlem) | ReconstructAT (Hava Triangülasyonu) | Reconstruct3D (3D Yeniden Yapılandırma)

Çekirdek Motor

• Fotogrametri Algoritmaları | GPU Hızlandırma | Paralel İşleme

Sistem Katmanı

• NVIDIA CUDA | Dosya Sistemi | Lisans Yönetimi

📚 Arayüz Kategorileri

1. Toplu İşleme Arayüzleri

Büyük miktarlarda verinin çevrimdışı işlenmesi için uygundur:

Arayüz	İşlev	Kullanım Durumu
ReconstructFull	Tam işlem yeniden yapılandırma	Hızlı başlangıç, otomatik işleme
ReconstructAT	Hava triangülasyonu	İnce kontrol, profesyonel kullanıcılar
Reconstruct3D	3D yeniden yapılandırma	AT sonuçlarından model üretme
OptimizeAT	AT optimizasyonu	Doğruluğu artırmak için kontrol noktaları kullanma
DivideTiles	Döşeme işleme	Büyük ölçekli veri bloğu yeniden yapılandırma

2. Yardımcı Araçlar

Araç	İşlev
License Engine	Lisans yönetimi
Progress Monitor	İlerleme izleme

🔄 Tipik İş Akışları

Seçenek 1: Hızlı Tam İşlem (Yeni Başlayanlar İçin Önerilen)

Hızlı Tam İşlem

ReconstructFull → Çıktı Sonuçları

Tek adımlı çözüm, tüm işlemleri otomatik olarak halleder

Seçenek 2: Adım Adım İşleme (Profesyonel Kullanıcılar)

Adım Adım İşleme Akışı

ReconstructAT → OptimizeAT (İsteğe bağlı) → Reconstruct3D → Çıktı Sonuçları

Her adım üzerinde ince kontrol, ara sonuç kontrolü ve optimizasyonu destekler

📝 Arayüz Çağırma Yöntemleri

1. Komut Satırı Çağrısı

SDK, her motor için doğrudan komut satırı çağrılarını destekler:

# Genel format
<engine_name> [options] -task_json <config_file>

# Örnek: ReconstructFull çağırma
reconstruct_full_engine -reconstruct_type 0 -task_json config.json

Kurulum Doğrulama

İlk kurulumdan sonra, doğrulama testleri için lütfen Kurulum Kılavuzu'na bakın.

2. Program Entegrasyonu

İşlem çağrıları yoluyla uygulamanıza entegre edin:

import subprocess
import json

# Yapılandırma hazırlama
config = {
    "license_id": 9200,
    "working_dir": "./output",
    "gdal_folder": "./data",
    # ... diğer parametreler
}

# Yapılandırma dosyasını kaydetme
with open("task.json", "w") as f:
    json.dump(config, f)

# SDK çağırma
result = subprocess.run([
    "reconstruct_full_engine.exe",
    "-reconstruct_type", "0",
    "-task_json", "task.json"
], capture_output=True, text=True)

print(result.stdout)

🎯 Doğru Arayüzü Seçme

Arayüz Seçimi Önerileri

Eğer siz...	Önerilen	Sebep
SDK'yı ilk kez kullanıyorsanız	ReconstructFull	Tüm detayları otomatik halleder, en basit
Kontrol noktaları kullanmanız gerekiyorsa	ReconstructAT + OptimizeAT	Kontrol noktası optimizasyonunu destekler
Ultra büyük veri işliyorsanız	DivideTiles + Reconstruct3D	Blok paralel işlemeyi destekler
Ara sonuçlara ihtiyacınız varsa	Adım adım işleme	Ara sonuçları kontrol edebilir ve ayarlayabilir

📖 Ortak Kavramlar

JSON Yapılandırma Dosyaları

Tüm arayüzler JSON formatında yapılandırma dosyaları kullanır, temel yapı:

{
  "license_id": 9200,           // Gerekli: Lisans ID'si
  "working_dir": "string",      // Gerekli: Çalışma dizini
  "gdal_folder": "string",      // Gerekli: GDAL veri dizini
  // ... diğer parametreler arayüze bağlıdır
}

Koordinat Sistemi Tanımı

{
  "coordinate_system": {
    "type": 2,                  // 0=LocalENU, 1=Local, 2=Geographic, 3=Projected, 4=ECEF
    "epsg_code": 4326,         // EPSG kodu (isteğe bağlı)
    "wkt": "string",           // WKT dizesi (isteğe bağlı)
    "origin_point": [lon, lat, alt]  // LocalENU başlangıcı (sadece type=0 olduğunda gerekli)
  }
}

Hata İşleme

Tüm arayüzler tamsayı hata kodları döndürür:

• 0: Başarı
• Negatif sayılar: Çeşitli hata koşulları

Detaylar için hata kodu referansına bakın.

🚀 Sonraki Adımlar

• 📚 ReconstructFull arayüzü hakkında daha fazla bilgi edinin (yeni başlayanlar için önerilen)
• 🔧 ReconstructAT arayüzünü inceleyin (gelişmiş özellikler)
• 💡 Pratik kullanım için tam örnekleri kontrol edin

---

İpucu: Çoğu kullanıcının ihtiyaçları ReconstructFull ile karşılanabilir. Diğer arayüzleri sadece ince kontrol gerektiğinde kullanın.