Zugangsleitfaden

Produktübersicht

Die Open API für Strukturierte räumliche Modellierung ist für Drittsysteme konzipiert. Sie bietet eine automatisierte Cloud-Verarbeitung, die 3D-Erfassungsdaten in bearbeitbare Modelle umwandelt.

Ablauf: LCC2-Szenenpaket, LAS-Punktwolke oder PLY-Punktwolke hochladen → die Cloud erstellt das Modell automatisch → es entstehen 3D-Modelle im Format DXF / GLB / BLEND sowie ein Revit-Modell (RVT).

Anwendungsfälle

Bestandsplanlieferung: Grundriss- und Schnittgrundlagen direkt aus Vor-Ort-Scans erhalten, statt manuell neu zu modellieren.
Umbauplanung: Wände, Türen und Fenster mit Abmessungen erhalten und direkt in CAD weiterplanen.
Immobilien- und Anlagenverwaltung: Grundrisse und Flächentabellen stapelweise erstellen.
Machbarkeits- und Mengenermittlung: Strukturierte Daten auslesen, um Abbruch und Umbauten zu bewerten und den Materialbedarf abzuschätzen.

Nutzungsgrenzen

Element	Grenze
API-Parallelität	10 Anfragen / Sekunde pro API
Parallelität der Modellierungsaufgaben	Unbegrenzt; Aufgaben werden nach dem Absenden sofort in die Warteschlange gestellt
Größe von Stapelabfragen	Bis zu 50 modelIds pro Anfrage für Aufgabendetails
Abfrageintervall	Mindestens 5 Sekunden empfohlen
Gültigkeit der temporären Upload-Zugangsdaten	12 Stunden
Maximale Anzahl an Teilen	10.000 Teile
Heartbeat-Timeout beim Upload	180 Sekunden; Aufgaben mit Zeitüberschreitung werden auf „Upload fehlgeschlagen“ gesetzt
Ratenbegrenzung pro modelId	Die APIs „Aufgabe starten“ und „Upload-Zugangsdaten erneut abrufen“ haben eine Ratenbegrenzung von 3 Sekunden

Erwerb

Dieser Dienst ist im AWS Marketplace verfügbar. Abonnieren Sie ihn auf der Produktseite im AWS Marketplace.

Anwendungs-Zugangsdaten erhalten

Beantragen Sie vorab eine Anwendung, um die folgenden Zugangsdaten zu erhalten.

Zugangsdaten	Beschreibung
APP-ID	Eindeutige Kennung der Anwendung
APP-Secret	Anwendungsschlüssel zum Erzeugen von Signaturen

Hinweis: Bewahren Sie das APP-Secret sicher auf und geben Sie es niemals weiter. Verwenden Sie es nur serverseitig zum Erzeugen von Signaturen. Verteilen Sie es niemals an Clients und legen Sie es nicht im Frontend-Code ab.

Die Datenspeicherregion wird bei der Beantragung der Anwendung festgelegt, sodass Sie sie beim Aufruf der APIs nicht übergeben müssen.

Signaturmechanismus

Signaturelemente

Element	Quelle	Regel
httpMethod	Anfragemethode	Großbuchstaben. Alle APIs in diesem Dokument verwenden `POST`
path	Anfragepfad	Vollständiger Pfad einschließlich des Präfixes `/open-apis`
timestamp	X-Timestamp	Zeitstempel in Sekunden, identisch mit dem Wert im Header
nonce	X-Nonce	Zufallszeichenfolge, identisch mit dem Wert im Header

Zu signierende Zeichenfolge

\n ist ein Zeilenumbruch. Der Anfragekörper ist nicht Teil der Signatur.

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

Beispiel:

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

Signaturalgorithmus

Element	Wert
Algorithmus	HMAC-SHA256
Schlüssel	APP-Secret
Ausgabe	Base64-codierte Zeichenfolge

Beispielcode

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. Zu signierende Zeichenfolge erstellen
    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-Codierung
    System.out.println(Base64.getEncoder().encodeToString(rawHmac));
}

Wenn die Einrichtung abgeschlossen ist, lesen Sie den Modellierungsablauf für den vollständigen Aufrufablauf.