Erişim Kılavuzu

Ürüne Genel Bakış

Structured Spatial Modeling Open API, üçüncü taraf sistemler için tasarlanmıştır. 3B yakalama verilerini düzenlenebilir modellere dönüştüren otomatik bulut işleme sunar.

İş akışı: bir LCC2 sahne paketi, LAS nokta bulutu veya PLY nokta bulutu yükleyin → bulut modeli otomatik olarak oluşturur → DXF / GLB / BLEND 3B modelleri ve bir Revit modeli (RVT) üretilir.

Kullanım Senaryoları

Uygulama sonrası çizim teslimi: Kat planı ve kesit altlık çizimlerini elle yeniden modelleme yapmadan doğrudan sahadaki taramalardan alın.
Yenileme tasarımı: Duvarları, kapıları ve pencereleri ölçüleri ve tasarımıyla birlikte doğrudan CAD'de alın.
Mülk ve varlık yönetimi: Kat planlarını ve alan tablolarını toplu olarak üretin.
Fizibilite ve metraj tahmini: Yıkım ve değişiklikleri değerlendirmek ve malzemeleri tahmin etmek için yapılandırılmış verileri okuyun.

Kullanım Sınırları

Öğe	Sınır
API eşzamanlılığı	API başına saniyede 10 istek
Modelleme görevi eşzamanlılığı	Sınırsız; görevler gönderildikten hemen sonra kuyruğa girer
Toplu sorgu boyutu	Görev ayrıntısı isteği başına en fazla 50 modelId
Yoklama aralığı	En az 5 saniye önerilir
Yükleme geçici kimlik bilgisi geçerlilik süresi	12 saat
Maksimum parça sayısı	10.000 parça
Yükleme heartbeat zaman aşımı	180 saniye; zaman aşımına uğrayan görevler yükleme başarısız durumuna alınır
modelId başına hız sınırı	Start Task ve Get Upload Credentials Again API'lerinde 3 saniyelik hız sınırı vardır

Satın Alma

Bu hizmet AWS Marketplace üzerinde sunulmaktadır. AWS Marketplace ürün sayfasından abone olun.

Uygulama Kimlik Bilgilerini Edinme

Aşağıdaki kimlik bilgilerini almak için önceden bir uygulama başvurusu yapın.

Kimlik Bilgisi	Açıklama
APP-ID	Uygulamanın benzersiz tanımlayıcısı
APP-Secret	İmza oluşturmak için kullanılan uygulama gizli anahtarı

Not: APP-Secret değerini güvenli tutun ve kimseyle paylaşmayın. Yalnızca sunucu tarafında imza oluşturmak için kullanın. İstemcilere dağıtmayın ve ön yüz koduna eklemeyin.

Veri depolama bölgesi uygulamaya başvururken belirlenir. Bu nedenle API'leri çağırırken bölgeyi iletmeniz gerekmez.

İmza Mekanizması

İmza Öğeleri

Öğe	Source	Kural
httpMethod	İstek yöntemi	Büyük harfle yazılır. Bu belgedeki tüm API'ler `POST` kullanır
path	İstek yolu	`/open-apis` öneki dahil tam yol
timestamp	X-Timestamp	Saniye cinsinden zaman damgası, başlıktaki değerle aynıdır
nonce	X-Nonce	Rastgele dize, başlıktaki değerle aynıdır

İmzalanacak Dize

\n satır başı karakteridir. İstek gövdesi imzaya dahil edilmez.

httpMethod + "\n" + path + "\n" + timestamp + "\n" + nonce

Örnek:

POST
/open-apis/spatial-model/v1/model/create
1791763200
a3f91c2d8e7b4a6590fd12cb77ae40d1

İmza Algoritması

Öğe	Değer
Algoritma	HMAC-SHA256
Anahtar	APP-Secret
Çıkış	Base64 ile kodlanmış dize

Örnek kod

public static void main(String[] args) throws Exception {
    String httpMethod = "POST";
    String path = "/open-apis/spatial-model/v1/model/create";
    long timestamp = System.currentTimeMillis() / 1000;
    String nonce = UUID.randomUUID().toString().replaceAll("-", "");
    // 1. Build the string to sign
    String signContent = httpMethod + "\n" + path + "\n" + timestamp + "\n" + nonce;

    // 2. HMAC-SHA256
    String appSecret = "xxxxxxxxxxxxxxxxxxx";
    Mac mac = Mac.getInstance("HmacSHA256");
    SecretKeySpec secretKey =
            new SecretKeySpec(appSecret.getBytes(StandardCharsets.UTF_8), "HmacSHA256");
    mac.init(secretKey);
    byte[] rawHmac = mac.doFinal(signContent.getBytes(StandardCharsets.UTF_8));

    // 3. Base64 encode
    System.out.println(Base64.getEncoder().encodeToString(rawHmac));
}

Kurulumu tamamladıktan sonra çağrı akışının tamamı için Modelleme İş Akışı bölümünü okuyun.

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: 02.11.2026