Help

Consistent terms throughout: project → concept → scenario → version

Contents
Hints in the site data wizard and the scenario tour are shown once
The first steps checklist on the Home screen

Getting started

Lesson
How to design buildings and infrastructure on your site

From the site boundary and development rules to KPIs, the editor and export

7 sections, 10 minutes
  1. 1
    Create a project

    On the “Projects” screen, click “Create project” and enter a name, city and description. The project appears as a card and a point on the map

  2. 2
    Set the site data

    In the site data wizard, upload the site boundary in GeoJSON (EPSG:4326), surroundings from OpenStreetMap or your own file, site contents, restricted zones and terrain, and utility connection points. Each file is validated on upload and errors are highlighted on the map

  3. 3
    Choose parameters and start generation

    On the project card, click “New concept”. On the “Parameters and options” screen, select options, a parameter set and a norm profile, choose 1 to 5 scenarios and click “Start”. One scenario uses one generation

  4. 4
    Wait for the result in the queue

    Follow progress on the “Generation queue” screen and in notifications. Cancel a queued task to recover its generation, or retry a failed task

  5. 5
    Open a scenario

    In the “Concepts” tree, open a completed scenario to see the development map, KPIs, economics and files. Star the best ones, compare two to four scenarios and make changes in the editor if needed

Screens

Projects
Company projects as cards or on a map, with search, sorting and filters by status and person responsible. Deleted projects remain in the bin for 30 days and can be restored
Project and site data
The project card has tabs for “Concepts”, “Site data”, “Drone survey”, “Files”, “Parameter sets”, “About the project” and “Activity log”. The site data wizard has six steps: “About the project”, “Boundaries”, “What is already on the site”, “Surroundings”, “Restricted zones and terrain” and “Utility connection points”
Generation
The “Parameters and options” screen includes nine options, a parameter set and a norm profile, quick start using key parameters, readiness checks, scenario count and cost in generations. The “Generation queue” screen shows queued, generating, ready, error and cancelled statuses, progress stages, cancellation and retry
Scenario
A full-screen 2D and 3D map with “Roads”, “Plots and urban blocks”, “Buildings” and “Networks” modes and sublayers, a legend, ruler and “Go to site” button. The right panel has KPIs, Economics, Parameters, Options, Files and Scenario list tabs. Save a PNG map image, download all files in one archive, add to favourites and leave a comment
Comparison
View two to four completed scenarios side by side, using “Key”, “All” or “Custom list” indicator sets, highlighted best values, synchronised maps and XLSX export
Editor
Edit roads, plots, buildings and networks: select, move, rotate, scale, draw, add vertices, copy and delete, with undo and redo for up to 50 steps. KPIs and economics update immediately. Saving creates a new version; “Regenerate with edits” costs one generation; drawings export to DXF
Versions
Scenario version history covers generation, edits, regeneration, rollback and import. Open any version, compare two versions and roll back to the desired one after confirmation
Import
The three-step “Import concept” wizard: “Files”, “Parameters” and “Review”. Seven GeoJSON layers, four required: roads, plots, urban blocks, and buildings and sites. Files are validated in the browser; importing does not use generations
Team and plan
Team members and roles, with invitations by link and email. The “Plan and billing” tab shows the current plan, generations remaining, limits, top-ups by card or payment receipt, and charge history with CSV export
Activity log
Company activity log for the company owner and project lead: all actions on projects, generations, edits, exports, invitations, roles and payments. Filter by team member, action and period, with 50 rows per page and CSV export
Notifications
The header bell shows the latest 10 events: completed scenarios and imports, errors, invitations, payments and low generation balances. All notifications have a dedicated page; important ones are also sent by email

Drone survey

The orthophoto appears beneath the boundary and scenarios; photos appear as points with the camera direction. Upload in the project card’s “Drone survey” tab or at the wizard’s “Boundaries” step

Formats
Orthophoto: GeoTIFF (.tif) up to 2 GB, preferably WGS84 (EPSG:4326) or UTM. PT-TM06 (EPSG:3763), Lisboa (EPSG:20790, 20791), ETRS89 UTM 29-31 and Web Mercator are also supported. Photos: JPEG with GPS in EXIF; HEIC does not open in all browsers
DroneDeploy
Map → Export → Orthomosaic, GeoTIFF format, WGS84 or UTM projection; use a resolution no finer than 5 cm/pixel if the file exceeds 2 GB
Pix4D
Processing Options → DSM, Orthomosaic and Index → GeoTIFF; the output file is in 3_dsm_ortho/2_mosaic. Prefer WGS84/UTM for the project coordinate system
OpenDroneMap
Use odm_orthophoto/odm_orthophoto.tif from the task results. In WebODM: Download Assets → Orthophoto (GeoTIFF)
Photos
Enable coordinate recording in drone photos. Camera position and heading come from EXIF and DJI XMP. Photos without GPS can be positioned manually on the map in the “Drone survey” tab
What is stored
The image is read in the browser and reduced to 4096 pixels; the original GeoTIFF is not uploaded. For photos, a 2048-pixel copy and a preview are stored

Glossary

Concept
A set of options, parameters and a norm profile for the project site. One or more scenarios are generated within a concept. “Start generation” on the project card creates a new concept: 1-5 development options with the same parameters
Scenario
One site development option within a concept, with its own KPIs, economics and files
Version
A saved scenario state. A new version is created after generation, editor changes, regeneration, rollback or import
KPIs
Key performance indicators: areas, population, places in nurseries, schools and other facilities, provision against norms and shortfalls
FSI
Floor Space Index: total floor area of buildings divided by site area
GSI
Ground Space Index: building footprint area divided by site area
Norm profile
Norms used to calculate requirements and constraints, for example “Russia, SP 42.13330 and regional urban planning standards”
Parameter set
Saved generation parameter values from the reference catalogue: number of storeys, density, commercial share, housing classes and others
Restricted zones
Zones with special land-use conditions: utility protection zones, sanitary zones and water protection zones. Development within them is restricted
NPV
Net present value: the sum of project cash flows discounted to today using the discount rate
Phase
A stage of development over time. The phase schedule and yearly cash flows are shown in the “Economics” tab
For integrations: keys, endpoints and webhooks Open API
Cannot find an answer? Contact support: info@allportugal.one