Aurora’s 3D Modeling Service allows users to request 3D models within the Aurora application. 3D models can also be requested via the API. The 3D Modeling Service is a paid service. You must have sufficient credits available to make a 3D Modeling Request (aka a design request). You can only request designs for residential projects.

Once you make a design request, a team of professional CAD designers will create an accurate 3D model of your work site (including buildings and trees). The requests are fulfilled during business hours. Our team aims to complete them within 3 hours. As an organization, you then have the choice between manually reviewing the designed 3D model in the Aurora application, or programmatically accepting it without a review via the API. The choice allows you to strike an appropriate balance of speed vs. quality given your specific business constraints. For example, you can accept 90% of all design requests in CA via the API and leave the 10% for a manual review, while manually reviewing all design requests in other states. Please note: once you have accepted a completed 3D model, a Design containing the model of the site will automatically be created in the Project.

Given the asynchronous nature of a design request, Aurora allows enterprise clients to receive webhook calls on completion or rejection of a design request. To set up a webhook, please contact your Aurora Account Executive or the Aurora support team at [email protected] The webhook is a GET request and the URL should be in the following format: https://HOST/PATH/<DESIGN_REQUEST_UUID_IN_AURORA>?status=<STATUS>.
If required, multiple authentication mechanism are possible (HTTP basic auth, secret HTTP headers etc.).

Each design request has a status. There are 3 possible flows of a design request through the state machine.

  1. A design request object is created and is rejected by the CAD designers. No 3D model is generated. The state transition for that design request object is: submitted => designer_rejected.
    This can occur due to:
  • missing or unclear imagery for the project location.

  • an ambiguous project location where the designer is unclear which building needs to be modelled, e.g. the project marker falls on a street or between two large homes.

  • the building displayed is a commercial roof top, which is currently not supported.

  1. A design request object is created and afterwards successfully fulfilled by our professional designers. You accept the design request and it is then converted into an actual design object within the project. You can accept the design request manually through the Aurora application or programmatically via the API. The state transition for that design request object is: submitted => designer_completed => accepted.

  2. A design request object is created and afterwards successfully fulfilled by our professional designers. You manually review the design request through the Aurora application. The quality of the generated 3D model does not meet your expectations and you reject the request. A rejection always requires feedback because it allows us to improve the quality of the service. The rejection is not possible via the API. The state transition for that design request object is: submitted => designer_completed => rejected.

📘

Please note that only one design request can be in progress (in either status submitted or designer_completed) for a given Project at any given time.