Przewodnik integracji

Przegląd produktu

Open API Strukturalnego modelowania przestrzennego jest przeznaczone dla systemów zewnętrznych. Zapewnia zautomatyzowane przetwarzanie w chmurze, które przekształca dane skanowania 3D w edytowalne modele.

Przebieg: prześlij pakiet sceny LCC2, chmurę punktów LAS lub chmurę punktów PLY → chmura automatycznie buduje model → powstają modele 3D DXF / GLB / BLEND oraz model Revit (RVT).

Zastosowania

Dokumentacja powykonawcza: Uzyskaj podkłady rzutów i przekrojów bezpośrednio ze skanów wykonanych na miejscu, bez ręcznego modelowania od nowa.
Projektowanie remontów: Pracuj bezpośrednio w CAD na ścianach, drzwiach i oknach z wymiarami.
Zarządzanie nieruchomościami i majątkiem: Generuj seryjnie rzuty kondygnacji i zestawienia powierzchni.
Analiza wykonalności i szacowanie ilości: Odczytuj dane strukturalne, aby ocenić zakres rozbiórek i przeróbek oraz oszacować ilość materiałów.

Limity użycia

Pozycja	Limit
Współbieżność API	10 żądań / sekundę na każde API
Współbieżność zadań modelowania	Bez limitu; zadania trafiają do kolejki natychmiast po przesłaniu
Rozmiar zapytania zbiorczego	Do 50 modelId w jednym żądaniu szczegółów zadania
Interwał odpytywania	Zalecany nie krótszy niż 5 sekund
Ważność tymczasowych poświadczeń przesyłania	12 godzin
Maksymalna liczba części	10 000 części
Limit czasu sygnału aktywności przesyłania	180 sekund; zadania, które przekroczą limit, otrzymują status przesyłania nieudanego
Limit częstotliwości na modelId	API Uruchomienie zadania oraz Ponowne pobranie poświadczeń przesyłania mają 3-sekundowy limit częstotliwości

Zakup

Usługa jest dostępna w AWS Marketplace. Subskrybuj ją na stronie produktu w AWS Marketplace.

Uzyskanie poświadczeń aplikacji

Złóż wcześniej wniosek o aplikację, aby otrzymać poniższe poświadczenia.

Poświadczenie	Opis
APP-ID	Unikalny identyfikator aplikacji
APP-Secret	Sekret aplikacji, używany do generowania podpisów

Uwaga: Przechowuj APP-Secret w bezpiecznym miejscu i nigdy go nie ujawniaj. Używaj go wyłącznie po stronie serwera do generowania podpisów. Nigdy nie przekazuj go klientom ani nie umieszczaj w kodzie frontendu.

Region przechowywania danych jest przypisywany podczas składania wniosku o aplikację, więc nie trzeba go przekazywać przy wywoływaniu API.

Mechanizm podpisu

Elementy podpisu

Element	Źródło	Reguła
httpMethod	Metoda żądania	Wielkimi literami. Wszystkie API w tej dokumentacji używają `POST`
path	Ścieżka żądania	Pełna ścieżka z prefiksem `/open-apis`
timestamp	X-Timestamp	Znacznik czasu w sekundach, identyczny z wartością w nagłówku
nonce	X-Nonce	Losowy ciąg znaków, identyczny z wartością w nagłówku

Ciąg do podpisania

\n oznacza znak nowego wiersza. Treść żądania nie jest uwzględniana w podpisie.

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

Przykład:

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

Algorytm podpisu

Pozycja	Wartość
Algorytm	HMAC-SHA256
Klucz	APP-Secret
Wynik	Ciąg zakodowany w Base64

Przykładowy 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. Zbuduj ciąg do podpisania
    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. Kodowanie Base64
    System.out.println(Base64.getEncoder().encodeToString(rawHmac));
}

Po zakończeniu konfiguracji przeczytaj Przebieg modelowania, aby poznać pełny przebieg wywołań.