Browse B-Plans
Using the Browse B-Plans tool, you can search and filter
XPlanung-compliant development plans (B-Plans), integrate
them into the map application, and convert them into an intuitive 3D representation. In addition, attribute data
related to the plans can be easily retrieved, and linked documents can be downloaded. Integrating development plans
into an existing 3D city model and converting them into a 3D view helps make plan contents and regulations visible,
transparent, and easy to understand.
| XPlanung is the legally binding data standard and the central data exchange format for IT systems in spatial planning, state and regional planning, urban land-use planning, and landscape planning in Germany. Because of this, the tool is primarily intended for users in Germany who have corresponding XPlanung data and wish to analyze it. |
Clicking the button starts the tool and opens the corresponding dialog
window. Working with B-Plans generally involves two steps:
-
First step: Existing B-Plans can be queried based on various search criteria. From the search results, choose the B-Plans to add to the map application.
-
Second step: The added B-Plans can then be analyzed in more detail, including visualizing plan contents as a 2D map, hiding surrounding 3D buildings with plan-level precision, and generating a 3D representation for one or more B-Plans.
Search and filter development plans
Searching for B-Plans takes place in the Overview tab of the tool window. The overview is also opened as the default view when the tool starts. All B-Plans that meet the specified search criteria are listed here in the results list.
A B-Plan search is initiated via the search bar at the top of the tab. In the input field next to the magnifying glass
icon , you can enter a single keyword for a quick search.
Clicking the filter button
opens a separate filter dialog,
which allows searching based on additional criteria.
Filter dialog
Using the filter dialog Filter B-Plans, you can filter B-Plans based on
their spatial location and attribute data. The dialog window is divided into two sections: Spatial filter and
Attribute filter. The following table describes the supported search criteria and the corresponding XPlanung
attributes:
| Search criterion | Description | XPlanung attribute |
|---|---|---|
Spatial Extent |
Using the button |
|
Municipality name |
Text search for the municipality name to which the B-Plan applies. |
|
Plan number |
Text search for the B-Plan number. |
|
Plan name |
Text search for the B-Plan name. |
|
Legal status |
Filtering by the legal status of the B-Plan. The values from the XPlanung standard are organized into the
groups Legally binding, In drafting, and Archived. Multiple selections are allowed. Only B-Plans with
the corresponding legal status are found. The assignment of legal statuses to the groups is displayed by hovering
over |
|
Date of entry into force |
Date indicating when the development plan must have come into effect. The date is set using a calendar dialog. To use this filter, the corresponding checkbox must also be activated |
|
Several search criteria can be specified at the same time. If multiple criteria are defined, all criteria must be met by a B-Plan (AND combination) for it to appear in the search result.
For input fields that allow text search, case sensitivity is ignored, and it is sufficient to enter only part of the
desired attribute value. In addition, the placeholders . (represents exactly one arbitrary character) and *
(represents any number of characters) can be used in the search expression to enable a flexible and more general
search query. The character \ serves as an escape character to search for these placeholders as normal characters.
An entered value can be easily deleted and removed from the filter using the button
at the end of the text field.
| The behavior of the text search described here is the standard behavior. Depending on the backend used for querying B-Plans, the behavior of the text search may vary. |
Using the buttons in the section headers, both the spatial filter and the inputs for
the attribute filter can be deleted separately. This makes it very easy to reset all filter settings.
By clicking Apply, the filter criteria are adopted and the search is started. The found B-Plans are listed in the results list.
| If no filter criteria are set, all available B-Plans are queried and included in the results list. |
Quick search
The quick search above the results list makes it possible to narrow down
the results specifically based on the entered search term. By default, the search term is applied to the plan name of
the development plans.
The quick search is directly linked to the corresponding input field of the filter dialog. This allows the search criterion to be conveniently adjusted without having to open the entire filter dialog. Entries in the quick search are automatically synchronized with the entries in the filter dialog. Furthermore, the same search functions for text search are available (see above).
|
Results list
The results list in the Overview tab displays all development plans by their plan name that meet the specified search criteria from the filter dialog and the quick search. The found B-Plans are divided into the sections Legally binding, In drafting, and Archived, and within each section they are sorted alphabetically by plan name. The number of search results per section is shown in the section header. Depending on the configuration, not all three sections may be displayed.
The classification of B-Plans into one of the three sections is based on their current legal status, which is defined
in the XPlanung document via the attribute BP_Plan/rechtsstand. The following table shows the relationship between
the list sections and the attribute values for the different legal statuses:
| Section | Attribute value (text and code) |
|---|---|
Legally binding |
Satzung (3000), InKraftGetreten (4000), TeilweiseUntergegangen (4500), TeilweiseAufgehoben (45000), TeilweiseAusserKraft (45001) |
In drafting |
Aufstellungsbeschluss (1000), ImVerfahren/Entwurf (2000), FruehzeitigeBehoerdenBeteiligung (2100), FruehzeitigeOeffentlichkeitsBeteiligung (2200), Entwurfsbeschluss (2250), BehoerdenBeteiligung (2300), OeffentlicheAuslegung (2400) |
Archived |
Untergegangen (5000), Aufgehoben (50000), AusserKraft (50001) |
Additionally, the spatial extent of the B-Plans is displayed in the current map view of the VC Map, so the plans are also geographically located. The fill color for the spatial extent differs for each list section to make the assignment visually clear in the map.
| Depending on the filter criteria, the B-Plan search may return a large number of results. To ensure smooth operation even in these cases, the search results within each section are divided into multiple pages, which can be accessed via a paging function. In the map view, only the spatial extents of the B-Plans on the currently active results page are displayed — not all B-Plans that meet the search criteria. |
Working with the results list
An entry in the results list can be selected with a single click. When selected, the entry is highlighted in the list, and an attribute data display for the corresponding B-Plan opens in a separate window. This display lists the most important attributes of the B-Plan in tabular form and includes download links for external documents linked to the plan. This makes it easy to view and retrieve all relevant information about a B-Plan.
In addition, when an entry is selected, the spatial extent of the B-Plan is highlighted in a different color in the
map view. Using the Zoom to B-Plan action in the menu of each list entry, the map view
is centered on the spatial extent of the selected B-Plan.
By clicking the button at the end of the list entry, a B-Plan is added to the second tab,
Added plans, in the tool window and becomes available for further analysis. When a plan is added, a 2D map
representation of the B-Plan is automatically loaded and displayed in the map view. The button icon then changes to
, marking all added B-Plans so they are immediately visible. Clicking this
icon
again removes the B-Plan from Added plans.
If you hold down the Ctrl key while selecting, multiple B-Plans can be selected at the same time. For such
multi-selection, the menu in the header of each list section provides the following
actions:
| Action for multi-selection | Description |
|---|---|
Select all |
Selects all B-Plans on the current page of the results list. |
Clear selection |
Removes the selection for all selected B-Plans. |
Zoom to selection |
Zooms and centers the map view so that the spatial extents of all selected B-Plans are visible. |
Add selection |
Adds all selected B-Plans to the Added plans tab. |
Remove selection |
Removes all selected B-Plans from Added plans. |
Results in the map view
A B-Plan from the results list can also be selected directly in the map view. To do this, first activate the Info tool in the VC Map toolbar. Then, a left-click on the spatial extent of the B-Plan in the map is sufficient to select the corresponding list entry and open the attribute data display for the B-Plan. However, multiple selection in the map view is not possible.
By right-clicking on the spatial extent of a B-Plan, the VC Map context menu opens. In addition to the usual options,
it offers the action Add B-Plan, which allows the B-Plan to be transferred to the
Added plans tab. If the B-Plan has already been added, the context menu instead contains the option
Remove B-Plan, which removes it from Added plans.
Using the checkbox in the header of each list section, the display of the
spatial extents of all associated B-Plans in the map view can be activated or deactivated.
Analyze added development plans
After relevant B-Plans have been identified using the search and filter options and transferred to the Added plans tab, they can be examined and analyzed further in the second step. The following actions are available for this purpose:
-
Display plan contents as a 2D map using XPlanung-compliant plan symbols
-
Query attribute data for the various plan contents of the B-Plan
-
Generate a 3D representation for relevant plan contents of the B-Plan and apply predefined visualization styles
-
Hide an existing 3D base model within the spatial extent of a B-Plan
| You can switch between the two tabs at any time. This means that even after transferring B-Plans, additional searches can be performed in the Overview tab using new search criteria to gradually expand the list of added B-Plans. |
Content list
The basic structure of the Added plans tab follows the structure of the Overview. The transferred B-Plans are organized by their plan name in a list view, divided into the three sections Legally binding, In drafting, and Archived. The assignment to these sections is again based on the legal status of the B-Plans (see here). Within a section, the B-Plans are sorted alphabetically. Depending on the configuration, not all three sections may be displayed.
At the top of the tab, the search field allows you to search the list
contents and reduce them to matching entries. Filtering is based on the plan name of the B-Plans. As with the quick
search in the Overview, case sensitivity is ignored, and partial entries are sufficient. However, wildcards are
not supported.
| This search field is independent of the quick search and filter options in the Overview and applies exclusively to the content list of added B-Plans. A new B-Plan search must be started in the Overview. |
Each B-Plan added to the content list is represented as a group of two map layers:
B-Plan and
3D building site.
These layers can be expanded and are explained below. As in the general Content window
of the VC Map, a left-click on a map layer toggles its visibility in the map view (indicated by
). Unlike in the results list of the Overview, a left-click therefore does not
trigger a selection.
The menu of the group entry (plan name) provides the following actions:
| Action on group entry | Description |
|---|---|
Zoom to B-Plan |
Zooms and centers the map view on the spatial extent of the B-Plan. |
Remove B-Plan |
Removes the B-Plan from Added plans. |
In addition, the header of each list section contains buttons and an extra menu for
quick actions that apply to all B-Plan layers within the section. These actions can also be performed individually
for each map layer:
| Quick action | Description |
|---|---|
Toggles the 3D base model within the spatial extents of all B-Plans (see Hide 3D base model). |
|
Activates or deactivates the 2D map representation for all B-Plans. |
|
Calculates 3D building sites for all B-Plans and shows or hides them. |
|
Export all 3D building sites |
Exports the 3D building sites of all B-Plans as a GeoJSON file. |
Style all 3D building sites |
Applies a visualization style to all 3D building sites. |
Remove all |
Removes all B-Plans from the Added plans tab. |
2D map representation of the development plan
The layer B-Plan contains a thematic 2D map representation of the plan,
which is displayed in the map view. It is automatically loaded and activated as soon as a B-Plan is transferred to
Added plans.
The 2D map representation visualizes the contents of the B-Plan using XPlanung-compliant drawing conventions. If the B-Plan is fully vectorized, all object types are displayed individually and color-coded. For partially vectorized B-Plans, the map representation is limited to the plan outline. Plan drawings captured as raster images are not displayed by default.
| The type of 2D map representation depends on the backend used to manage the XPlanung data and generate the visualization. The behavior described here applies when using xPlanBox. |
By clicking on the B-Plan layer, the 2D map representation for this
B-Plan can be deactivated or reactivated at any time.
Attribute data query for plan contents
Through the 2D map representation in the map view, attribute data for individual plan contents can be queried and displayed in a separate window. To do this, first activate the info tool in the VC Map toolbar.
Then, a click on the 2D map representation opens the attribute data display for the plan contents at the selected location. For orientation and reference, the clicked location is highlighted in the map with a point symbol. The attribute data display lists the most important attributes of the affected plan contents in tabular form and includes download links for external documents linked to these contents. For fully vectorized B-Plans, this query enables a detailed analysis of all object types contained in the plan and their attributes, going beyond the general summary provided in the Overview tab.
Calculate and display 3D building sites
A core functionality of the tool is the dynamic calculation and visualization of 3D building sites based on plan
contents such as areas permitted for building and their associated attributes. This is controlled via the layer
3D Building site for a B-Plan in the content list.
|
Calculating 3D building sites requires a fully vectorized B-Plan. For partially vectorized B-Plans, this function
is not available. In such cases, the layer |
After a B-Plan is added to Added plans, the layer is deactivated by default and can be activated with a click. This triggers the calculation of the 3D building sites in the background. Once the calculation is complete, the resulting 3D objects are displayed in the 3D map view.
Each 3D building site shows where construction is permitted within the B-Plan. The height of the 3D object is derived from corresponding attributes in the B-Plan — either from absolute or relative height specifications or from the number of above-ground storeys. Height specifications always take priority for calculation and visualization. Only if no relevant height data is available is the block height determined based on storey information and a standard height for full storeys. If storey information is available, horizontal dividing lines are drawn at the corresponding heights to make the number of permitted full storeys visible in the 3D representation.
| The 3D building sites do not represent possible actual buildings but illustrate the constraints for such construction. For this reason, the 3D geometries are visualized by default as semi-transparent and translucent. |
If the info tool in VC Map is activated, a click on a 3D building site in the map view opens an attribute data display with additional information. The displayed attributes of the 3D building site are partly taken directly from the underlying B-Plan (height and storey specifications, dimensions of structural use, type of structural use) or show calculated or derived values. The attribute data display is divided into the following sections:
| Section | Description |
|---|---|
Calculated heights |
Contains height data used for the 3D visualization, such as the absolute terrain height derived from the terrain model or the assumed storey height if the object height is based on a standard storey height rather than explicit height data. |
Height specifications |
Shows the building height specifications. Multiple entries may exist per object type. The icon
|
Storey specifications |
Shows the storey specifications. Multiple entries may exist per object type. The icon
|
Dimensions of structural use |
Displays the dimensions of structural use specified in the B-Plan for the 3D building site. |
Type of structural use |
Indicates the type of structural use for the 3D building site as defined in the B-Plan. |
| If multiple height or storey specifications exist, display priorities determine which specifications are used for visualizing the 3D building sites. These priorities are defined during plugin configuration. |
For each 3D Building site layer, additional actions are available, which can
be accessed via the buttons to the right of the layer name.
Hide 3D base model
The button is used to hide the 3D base model within the spatial extent of the
B-Plan. This makes it easy to isolate the B-Plan and the derived 3D building sites in the 3D map view. Clicking the
button again reactivates the 3D base model.
Styling 3D building sites
When 3D building sites are activated, they are colored using a default style. The button
allows this coloring to be adjusted. Clicking the button opens a menu with
predefined styles. The currently applied style is highlighted. Through the general
legend component of VC Map, a legend explaining the color values can
be displayed.
The also provides access to the additional action Export 3D building site, which exports
the 3D geometry of the building site as a GeoJSON file for further use in external GIS tools.