Integratiehandleiding

Productoverzicht

De Open API voor Gestructureerde ruimtelijke modellering is bedoeld voor systemen van derden. De API verwerkt 3D-opnamegegevens automatisch in de cloud tot bewerkbare modellen.

Werkwijze: upload een LCC2-scènepakket, een LAS-puntenwolk of een PLY-puntenwolk → de cloud bouwt het model automatisch → er worden 3D-modellen in DXF / GLB / BLEND gemaakt, samen met een Revit-model (RVT).

Toepassingen

Revisietekeningen opleveren: Haal plattegronden en doorsneden rechtstreeks uit scans ter plaatse, zonder handmatig opnieuw te modelleren.
Renovatieontwerp: Krijg wanden, deuren en ramen met maatvoering en ontwerp direct verder in CAD.
Vastgoed- en assetbeheer: Maak plattegronden en oppervlaktetabellen in batches.
Haalbaarheid en hoeveelheden: Lees gestructureerde gegevens uit om sloop en verbouwingen te beoordelen en materialen te ramen.

Gebruikslimieten

Onderdeel	Limiet
API-gelijktijdigheid	10 verzoeken / seconde per API
Gelijktijdige modelleringstaken	Onbeperkt; taken komen direct na indienen in de wachtrij
Batchgrootte bij opvragen	Maximaal 50 modelIds per verzoek om taakdetails
Polling-interval	Aanbevolen: niet korter dan 5 seconden
Geldigheid tijdelijke uploadreferenties	12 uur
Maximaal aantal delen	10.000 delen
Time-out uploadheartbeat	180 seconden; taken met een time-out krijgen de status Upload mislukt
Frequentielimiet per modelId	Voor de API's Taak starten en Uploadreferenties opnieuw ophalen geldt een limiet van 3 seconden

Aankoop

Deze dienst is beschikbaar via AWS Marketplace. Neem een abonnement op de productpagina op AWS Marketplace.

Applicatiereferenties verkrijgen

Vraag vooraf een applicatie aan om de volgende referenties te krijgen.

Referentie	Beschrijving
APP-ID	Unieke identificatie van de applicatie
APP-Secret	Applicatiegeheim, gebruikt om handtekeningen te genereren

Opmerking: Bewaar het APP-Secret veilig en maak het nooit openbaar. Gebruik het alleen aan de serverkant om handtekeningen te genereren. Verspreid het nooit naar clients en neem het nooit op in frontendcode.

De regio voor gegevensopslag wordt bij de aanvraag van de applicatie vastgelegd. Je hoeft deze dus niet mee te geven bij het aanroepen van de API's.

Handtekeningmechanisme

Elementen van de handtekening

Element	Bron	Regel
httpMethod	Verzoekmethode	Hoofdletters. Alle API's in dit document gebruiken `POST`
path	Verzoekpad	Volledig pad inclusief het voorvoegsel `/open-apis`
timestamp	X-Timestamp	Tijdstempel in seconden, gelijk aan de waarde in de header
nonce	X-Nonce	Willekeurige tekenreeks, gelijk aan de waarde in de header

Te ondertekenen tekenreeks

\n is een regeleinde. De request body maakt geen deel uit van de handtekening.

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

Voorbeeld:

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

Handtekeningalgoritme

Onderdeel	Waarde
Algoritme	HMAC-SHA256
Sleutel	APP-Secret
Uitvoer	Base64-gecodeerde tekenreeks

Voorbeeldcode

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. Stel de te ondertekenen tekenreeks samen
    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-codering
    System.out.println(Base64.getEncoder().encodeToString(rawHmac));
}

Lees na de voorbereiding de Modelleringsworkflow voor de volledige aanroepvolgorde.