Browse B-Plans

icon xplanTool 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 icon xplanTool starts the tool and opens the corresponding dialog window. Working with B-Plans generally involves two steps:

  1. 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.

  2. 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 icon searchOrg, you can enter a single keyword for a quick search. Clicking the filter button icon filter2 opens a separate filter dialog, which allows searching based on additional criteria.

Filter dialog

Using the filter dialog icon filter2 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 icon boundingBox, a bounding box can be drawn in the map view. Only B-Plans whose spatial extent overlaps with the bounding box meet this criterion. After drawing the bounding box, the coordinates of the lower-left and upper-right corners are displayed in the filter dialog to indicate that a spatial filter is active.

BP_Plan/raeumlicher
Geltungsbereich

Municipality name

Text search for the municipality name to which the B-Plan applies.

BP_Plan/gemeinde/
XP_Gemeinde/gemeindeName

Plan number

Text search for the B-Plan number.

BP_Plan/nummer

Plan name

Text search for the B-Plan name.

BP_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 icon help and is also shown here.

BP_Plan/rechtsstand

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

BP_Plan/
inkrafttretensDatum

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 icon closeWindow 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 icon return 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 icon searchOrg 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).

  • When the filter dialog is opened, the input field of the quick search is automatically locked to prevent parallel entries.

  • Depending on the configuration, the quick search may also refer to another search criterion of the filter dialog. The search criterion is displayed in the help text of the input field.

  • Even if only the search term in the quick search is adjusted, all search criteria defined in the filter dialog must still be met by a B-Plan.

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 icon kebab menu of each list entry, the map view is centered on the spatial extent of the selected B-Plan.

By clicking the icon plus 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 icon map check, marking all added B-Plans so they are immediately visible. Clicking this icon icon map check 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 icon kebab 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 icon plus 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 icon map check Remove B-Plan, which removes it from Added plans.

Using the checkbox icon checkboxChecked 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:

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 icon searchOrg 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: icon mapSimple B-Plan and icon cube 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 icon checkboxChecked). Unlike in the results list of the Overview, a left-click therefore does not trigger a selection.

The icon kebab 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 icon kebab 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

icon homeOff

Toggles the 3D base model within the spatial extents of all B-Plans (see Hide 3D base model).

icon mapSimple

Activates or deactivates the 2D map representation for all B-Plans.

icon cube

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 icon mapSimple 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 icon mapSimple 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 icon cube 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 icon cube 3D Building site does not appear.

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 icon checkCircle identifies the specification applied for calculation and visualization. The “Source” column indicates whether the specification comes from the areas permitted for building (UGF) or the spatially related building zone sub-area (BTF), with UGF specifications always taking priority.

Storey specifications

Shows the storey specifications. Multiple entries may exist per object type. The icon icon checkCircle identifies the specification applied for calculation and visualization. The “Source” column indicates whether the specification comes from the areas permitted for building (UGF) or the spatially related building zone sub-area (BTF), with UGF specifications always taking priority.

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 icon cube 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 icon homeOff 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 icon colorSwatch allows this coloring to be adjusted. Clicking the button opens a menu with predefined styles. The currently applied style is highlighted. Through the general icon legendOrg legend component of VC Map, a legend explaining the color values can be displayed.

The icon kebab 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.