InnerWeb
Skip to main content

Linking building solids with a GeoJSON file

The online map can show a raw file of solids, or solids linked with the plant structure: floors, names and areas. The second variant is switched on with a configuration flag that is off by default. Below are notes for the map administrator: how to enable linking, how to check it and what to watch for before the buildings are made available to users.

1
GeoJSON file with solids per plant
Source: card
1:1
relation of an area to a solid on the online map
Source: card

Where a solid comes from and what the structure adds

Building solids come from one GeoJSON file per plant. What the user draws or names in the editor is stored in the database and linked with the file. Uploading the file again does not delete manual work. This separation gives the administrator confidence that an external geometry update will not destroy the names, floors and assignments the team entered in the editor.

Linking solids with the structure is switched on by a configuration flag and is off by default. Without it, the online map shows the raw solids file, with no link to floors. The user then sees the shapes of the buildings, but a double-click does not open floors that correspond to the plant structure.

Order for switching on linking

Switching on the flag is not the only step. The order below limits the risk that users see an incomplete picture.

1. Prepare the structure in the editor

Before you switch on linking, make sure the buildings, floors and names have been entered in the editor. Linking relies on this structure, and empty fields will produce empty results.

2. Upload the GeoJSON file

Upload one solids file for the plant. Before uploading, check that it contains solids for all the buildings that should be opened with a double-click.

3. Switch on the linking flag

Switch on the configuration flag for the plant. Until it is on, the online map shows the raw file.

4. Open the solids mapping report

The solids mapping report works in read-only mode, so it does not change any data. Review it before making the map available to users and look for solids without a match.

5. Check several buildings on the online map

Enter at least three buildings with different numbers of floors by double-clicking. Check the names, the floors and whether the walls in front of the camera lower to 1 m.

Sample mapping report for 40 solids before corrections

Sample mapping report for 40 solids before correctionsDonut chart: of 40 solids, 34 are matched, 4 have several candidates and 2 have no area.Matched and named: 34 solids (85%)Several candidates: 4 solids (10%)No area: 2 solids (5%)40solidsMatched and named34 solids (85%)Several candidates4 solids (10%)No area2 solids (5%)
Source: Example calculation: an illustration of the report structure, not data from a facility

How the system matches solids and what it does not guess

A click on a solid is matched to an area by its identifier, and when there is none, by whose outline contains the centre of the solid. Buildings take precedence over organisational areas, and among equal candidates the tightest outline wins. When more than one candidate fits a solid, the system does not guess and does not assign a name. Instead, the solid is left without a name, and the administrator sees this in the report.

This rule protects against wrong assignments: it is better for a building to be unnamed than for the dispatcher to end up in the wrong facility. The lack of a name is a signal to clarify the outline or the identifier.

Ownership of geometry and the consistency rule

A building drawn in the editor owns its geometry. A building describing an existing solid from the file keeps the more accurate outline from the file. The administrator should therefore know which building is of which kind, because that determines when an update of the file will change the shape and when it will not.

The consistency rule states: one area is exactly one solid on the online map. Before making the map available, compare the number of building areas in the structure with the number of linked solids. A discrepancy means that one building has two solids or none at all.

  • the number of building areas equals the number of linked solids
  • no solids with several candidates remain in the report
  • every building opens with a double-click
  • floors match the structure

What to do when the report shows mismatches

A mismatch is not a failure, only missing information. For a solid without a name, check whether its corresponding area has an outline and a height and whether the identifier is correct. For a solid with several candidates, refine the area's outline so that the centre of the solid falls within only one of them.

After the corrections, open the report again. Because it works in read-only mode, you can run it as often as needed. Only when no mismatches remain should you make the map available to users and let them know that buildings open with a double-click.

Video

Frequently asked questions

What will users see without the flag switched on?

The raw solids file, with no link to floors. Linking with the structure is off by default.

Will uploading the file again delete the names from the editor?

No. What was drawn or named in the editor is stored in the database and linked with the file.

Why did a solid not get a name?

It most likely fits more than one candidate. The system does not guess, so refine the outline or the identifier.

Does the mapping report change data?

No. It works in read-only mode, so it can be opened as many times as needed.

Sources

Link the solids with your plant structure

We will switch on linking of solids and check the mapping report on your GeoJSON file. Book a conversation.

Let's talk