Kennismaking met Data Bundles

Een data bundle is de container voor één opname: ruwe invoerbestanden (puntenwolken, trajecten, afbeeldingen, enzovoort) plus de verwerkte uitvoer die het platform daaruit genereert. De RealityConnect API stelt dezelfde bundle-levenscyclus beschikbaar als de Prevu3D-UI gebruikt, zodat integraties bundles kunnen maken, gegevens kunnen uploaden, verwerking kunnen starten, voortgang kunnen volgen en invoerbestanden kunnen ophalen zonder browser.

Dit document gaat ervan uit dat u een OAuth-flow hebt voltooid en een access_token, uw regionale api_url en uw organization_id hebt. Zie de flowgidsen als dat niet zo is.

Alle endpoints voor data bundle-workflows (/v1/bundles/..., /v1/organization/.../data-bundle-input-tree en /v1/nodes/.../bundle) zijn gemarkeerd als experimenteel. Verwacht dat het contract evolueert totdat ze stabiel worden. Zie Experimentele endpoints.

Vereiste scopes

Scope	Gebruikt voor
read:bundle	De apparaatinvoerboom ophalen, uploadsessies opsommen, verwerkingsopties opsommen, verwerkingsrecords opsommen, download-URL’s voor invoerbestanden opsommen
write:bundle	Een bundle maken, uploadsessies openen en voltooien, verwerking starten

U hebt ook inhoudstoegang en noderechten nodig op de bovenliggende node waar de bundle wordt gemaakt, en op de bundle zelf voor latere stappen.

End-to-end-flow

flowchart LR
  A["1. Invoerboom ophalen"] --> B["2. Bundle maken"]
  B --> C["3. Invoerbestanden uploaden"]
  C --> D["4. Verwerkingsopties opsommen"]
  D --> E["5. Verwerking starten"]
  E --> F["6. Verwerkingsrecords pollen"]

Elke genummerde stap komt overeen met een specifieke gids:

Stap	Gids	Samenvatting
1–2	Een data bundle maken	De apparaatinvoerboom ophalen, een leaf-dbuPath kiezen, de bundle onder een bovenliggende node maken
3	Gegevens uploaden naar een data bundle	Een uploadsessie openen, elk bestand via multipart naar S3 uploaden, voltooien
4–6	Verwerking en bewaking	Beschikbare uitvoer opsommen, verwerking starten, pollen totdat elke taak een eindtoestand bereikt

Invoerbestanden downloaden is optioneel: gebruik dit alleen wanneer u de geüploade invoerbestanden van de bundle opnieuw moet ophalen.

Validatiemodel

Structurele regels (verplichte bestandstypen, toegestane extensies, cross-type-afhankelijkheden, multipliciteit) worden beschreven in de requirements-array die wordt geretourneerd wanneer u een uploadsessie opent. Het is de verantwoordelijkheid van de gebruiker om die structuur te volgen vóór het uploaden en vóór het starten van de verwerking.

De upload-API registreert elk bestand onder het type dat u opgeeft en voltooit de sessie op basis van het aantal alleen. Diepgaande inhoudsvalidatie (of een .las een echte apparaatopname is, of metadata-JSON correct verwijst naar zijn afbeelding) gebeurt na het starten van een verwerking, niet op het moment van uploaden. Een correct benoemd maar misvormd bestand wordt zonder fout geüpload en mislukt later tijdens de verwerking.

Verwerkingsfouten die worden veroorzaakt door een onjuiste uploadstructuur (ontbrekende verplichte typen, verbroken afhankelijkheden, verkeerde extensies, enzovoort) worden niet terugbetaald.