Guida all'accesso

Panoramica del prodotto

L'Open API di Modellazione spaziale strutturata è pensata per i sistemi di terze parti. Offre un'elaborazione cloud automatizzata che trasforma i dati di acquisizione 3D in modelli modificabili.

Flusso: carica un pacchetto di scena LCC2, una nuvola di punti LAS o una nuvola di punti PLY → il cloud genera automaticamente il modello → vengono prodotti i modelli 3D DXF / GLB / BLEND, insieme a un modello Revit (RVT).

Casi d'uso

Consegna di disegni as-built: ottieni piante e sezioni di base direttamente dalle scansioni in loco, senza rimodellare a mano.
Progettazione di ristrutturazioni: ottieni muri, porte e finestre con le relative quote e progetta direttamente in CAD.
Gestione immobiliare e patrimoniale: produci piante e tabelle delle superfici in batch.
Studi di fattibilità e stima delle quantità: leggi i dati strutturati per valutare demolizioni e modifiche e stimare i materiali.

Limiti di utilizzo

Voce	Limite
Concorrenza delle API	10 richieste / secondo per API
Concorrenza delle attività di modellazione	Illimitata; le attività entrano in coda subito dopo l'invio
Dimensione della query in batch	Fino a 50 modelId per richiesta di dettagli attività
Intervallo di polling	Consigliato non inferiore a 5 secondi
Validità delle credenziali temporanee di caricamento	12 ore
Numero massimo di parti	10.000 parti
Timeout dell'heartbeat di caricamento	180 secondi; le attività scadute passano allo stato di caricamento non riuscito
Limite di frequenza per modelId	Le API Avvia attività e Ottieni di nuovo le credenziali di caricamento hanno un limite di frequenza di 3 secondi

Acquisto

Il servizio è disponibile su AWS Marketplace. Abbonati dalla pagina del prodotto su AWS Marketplace.

Ottenere le credenziali dell'applicazione

Richiedi in anticipo un'applicazione per ottenere le seguenti credenziali.

Credenziale	Descrizione
APP-ID	Identificativo univoco dell'applicazione
APP-Secret	Segreto dell'applicazione, usato per generare le firme

Nota: conserva l'APP-Secret in modo sicuro e non divulgarlo mai. Usalo solo lato server per generare le firme. Non distribuirlo mai ai client né inserirlo nel codice frontend.

La regione di archiviazione dei dati viene associata al momento della richiesta dell'applicazione, quindi non è necessario passarla quando chiami le API.

Meccanismo di firma

Elementi della firma

Elemento	Origine	Regola
httpMethod	Metodo della richiesta	In maiuscolo. Tutte le API di questo documento usano `POST`
path	Percorso della richiesta	Percorso completo, incluso il prefisso `/open-apis`
timestamp	X-Timestamp	Timestamp in secondi, identico al valore nell'intestazione
nonce	X-Nonce	Stringa casuale, identica al valore nell'intestazione

Stringa da firmare

\n è un carattere di a capo. Il corpo della richiesta non è incluso nella firma.

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

Esempio:

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

Algoritmo di firma

Voce	Valore
Algoritmo	HMAC-SHA256
Chiave	APP-Secret
Output	Stringa codificata in Base64

Codice di esempio

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. Costruisci la stringa da firmare
    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. Codifica Base64
    System.out.println(Base64.getEncoder().encodeToString(rawHmac));
}

Una volta completata la configurazione, leggi Flusso di modellazione per il flusso di chiamate completo.