For editors and owners
Send deliveries through a drop folder
Drop a delivery of 3D models, orthophotos, CAD plans or layers into your own storage bucket; Cartema picks it up, reads it, and a person who manages the app confirms where it goes with Buddy Pro.
Instead of sending large deliveries by download links, your organisation can put them into a drop folder: a folder of your own storage bucket (Amazon S3 or compatible) that Cartema reads. Cartema picks up each new delivery by itself, reads it, and posts it in the app's room on Projects. Nothing goes into an app until a person who may change that app looks at it and presses Confirm.
The drop folder is set up for your workspace by Cartema support: they tell you the bucket and the folder, and which access Cartema needs to it.
How a delivery is laid out
Each delivery is one folder, under the app it is for and the kind of what it holds:
<drop folder>/<app>/<kind>/<delivery name>/<your files>
- app: the app's short name, as it is in its address (
/p/<workspace>/<app>); - kind: one of
3d— 3D models: an archive (ZIP, RAR or 7z) of ContextCapture 3MX exports or 3D Tiles sets, or the export's folders as they are;orthophotos— orthophoto sheets and surface models: one archive, or the images themselves;cad— a plan as a drawing (DWG or DXF);vector— layers: a shapefile's parts, GeoJSON, GeoPackage, KML, a CSV with coordinates;
- delivery name: anything that tells it apart, for example the date and the area —
20261025 north section.
For example, a delivery for the fictional Cedar Valley app:
cedar-valley/3d/20261025 CV1/CV1-11 models.7zcedar-valley/orthophotos/20261025 CV1/20261025 Cedar Valley CV1-11.jp2cedar-valley/cad/Plan 204-0725937/plan.dwg
When Cartema takes it
A delivery is taken once it is complete: put an empty file named READY into its folder when the upload is done, or simply leave it — after 15 minutes with nothing changing, Cartema takes it. Cartema looks every 10 minutes.
Each delivery is taken once. Changing its files afterwards does not load it again: Cartema says so, and a new version goes into a new delivery folder.
What Cartema writes back
Cartema writes one file into each delivery folder, _cartema.json, saying how the delivery stands:
seen— found, not yet complete;converting— being downloaded and read;waiting for Confirm— read, and waiting in the app's room for a person to confirm it;placed— in the app;failed— not taken, with the reason (for example, no app of that name, or a file that cannot be read);changed— changed after it was taken, so not loaded again;undone— taken back out of the app;expired— nobody confirmed it within 14 days; send it again to load it.
Cartema never changes or deletes your files: only _cartema.json is written.
Confirm it in the app's room
- Open Projects, then the app. In its team room a card shows the delivery: what it holds (3D scenes, images and their dates, layers or a drawing), its size, and where it goes:
- 3D models into the app's 3D panel, by date, hidden when the app opens;
- orthophotos into Background maps, the newest on top, switched off when the app opens;
- a CAD plan into Plans, in a folder of its own;
- layers into the app's own layers.
- Press Review and confirm with Buddy Pro. Buddy Pro shows the full preview of the task, exactly as when you attach the file yourself: each item and where it goes.
- Press Confirm. The card follows it until it is in the app; Undo takes it back.
Only a person who may change the app's structure sees the button and can confirm, with the same rights as doing it by hand. Usage is counted as for the same task done with a file you attach, and grows with the size of the delivery.
Limits
- 3D models: up to 8 GB a delivery; orthophotos: up to 2 GB; plans and layers: up to 100 MB.
- At most 20,000 files in one delivery, at most 12 folders deep.
- File and folder names: letters (any language), digits, spaces, dots, dashes and underscores.