A drone flies in the nature

Digital Platform for Unmanned Aviation

General

The Digital Platform for Unmanned Aviation (dipul) project of the Federal Ministry for Digital and Transport (BMDV) uses spatial data services. These services are standardized through the Open Geospatial Consortium (OGC). The geospatial reference data are provided via the Web Map Service (WMS).

These instructions give an overview of the use of the Web Map Service.

The WMS is a web service that exchanges spatial data via a standardized interface and then visualizes them. Users must send a request to the geoservice via an internet address (URL). Communication takes place through GET requests via HTTP. Each request must contain a number of mandatory parameters, such as the layer to be displayed, the section of the map to be displayed or the expected output data format. The geoservice responds to the request and provides the desired data.

The WMS is based on both raster and vector data, which are displayed either as a section of the map in a simple raster graphics format or as metadata. Users can choose various query options to return the required data accordingly.

 Back to Contents


General use

Internal usage:
The data provided via the WMS can be used within an application that is created for the sole use by of its owner.

The following applies for applications which can be used by third parties:

The data of the WMS may be used in non-commercial applications created for the purpose of increasing the situational awareness of private drone pilots over geographical areas that are defined in accordance with §21h LuftVO Paragraph 3. The usage hereby means any processing, transfer and visualisation of the data directly or indirectly in an application, e.g. mobile app, web application, applications for other electronic devices. 

The data of the WMS may only be used in non-commercial applications and the data source (DFS and BMDV) must be indicated. The following source information must be clearly displayed: "Source geodata: DFS, BKG [2022]". 

It is not permitted to process, reproduce, pass on or visualise the data of the WMS in commercially operated applications (in return for payment or monetary benefits of any kind from and to third parties) or outside the permitted purpose of use.

 Back to Contents


General use

As already described, users can make a request to a geoservice via URL.

URL queries used must comply with the IETF RFC 2396 URL specification. Among other things, this international standard states that certain characters are reserved for use in URL queries (see Table 1). If one of these characters, or other special characters, is to be used as part of the parameter value, it must be coded according to the specified standard. 

Character

Use in query

?

Separator indicating that a query starts

&

Separator between two parameters of a query

=

Separator between parameter name and parameter value

,

Separators between individual values of a list parameter

+

Symbol for space

The dipul geoservice can be queried via the following URL:

https://uas-betrieb.de/geoservices/dipul/wms?<query parameter>

 Back to Contents

Query options

The WMS distinguishes three different query options – GetCapabilities, GetMap, GetFeatureInfo – whose principles are explained in this chapter.

As described above, the WMS is standardized and specified by the Open Geospatial Consortium (OGC). For further information, please refer to the specification according to the OGC website (https://www.ogc.org/standards/wms).

 Back to Contents


GetCapabilities

The GetCapabilities option allows you to query the capabilities and metadata of a service. As a response, the geoservice provides all requested metadata in the required format, which can then be opened with suitable software (e.g. directly in the web browser or a text editor).

The metadata obtained can be divided into three areas:

  • General information: includes a brief description, contact person as well as the terms of use.
  • Formats: Includes the available formats for each query.  This information can then be used for the further GetMap or GetFeatureInfo queries. The following parameters are obligatory or optional for a valid GetCapabilities query:
  • Layer: Includes all available layers as well as coordinate systems.

This information can then be used for the further GetMap or GetFeatureInfo queries.

The following parameters are obligatory or optional for a valid GetCapabilities query:

Parameter

Required
Yes/no

Description

service

yes

Specifies the name of the service. For a WMS query, the value must be set to WMS.

version

yes

Specifies the version to be used. All versions are supported (1.0.0, 1.0.1, 1.1.1, 1.3.0).

request

yes

Specifies the chosen query option. Must be set to getCapabilities for this query.

namespace

no

Limits the response to the layer of the set namespace.

format

no

Specifies the chosen format of the output.

Example of a getCapabilities query:

https://uas-betrieb.de/geoservices/dipul/wms?service=WMS&version=1.3.0&request=GetCapabilities

Output of the sample query (partial screenshot only):

Figure shows following code for example:<WMS_Capabilities xmlns="http://www.opengis.net/wms" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="1.3.0" updateSequence="1323" xsi:schemaLocation="http://www.opengis.net/wms https://uas-betrieb.dfs.de/geoserver/schemas/wms/1.3.0/capabilities_1_3_0.xsd"> <Service> <Name>WMS</Name> <Title>DPUL Layers</Title> <Abstract>Geodata layers for unmanned aviation services provided by DPUL.</Abstract> <KeywordList/> <OnlineResource xlink:type="simple" xlink:href="https://uas-betrieb.dfs.de/geoserver/"/> <ContactInformation> <ContactPersonPrimary> <ContactPerson>System manager of the day</ContactPerson> <ContactOrganization>DFS Deutsche Flugsicherung GmbH</ContactOrganization> </ContactPersonPrimary>

 

Another output option is visualization using third-party websites and tools that support a WMS import. This allows the geographical zones to be displayed outside the Digital Platform for Unmanned Aviation (dipul).

 Back to Contents


GetMap

The GetMap query can be used to request a section of a map in a raster image format from the geoservice. Some of the available values of the different query options can be displayed via the getCapabilities query.

As already described, special characters must be encoded in the parameter values according to the standards:

Special characters

Encoding

:

%3A

,

%2C

/

%2F

The output is a map image in the requested format.

A valid GetMap query must or can contain the following parameters: 

Parameter 

Required
yes/no 

Description 

Service

yes

Specifies the name of the service. For a WMS query, the value must be set to WMS.

Version

yes

Specifies the service version to be used. All versions are supported (1.0.0, 1.0.1, 1.1.1, 1.3.0).

Request

yes

Specifies the chosen query option. Must be set to getMap for this query.

Layers

yes

Specifies the layers to be displayed in the map section. The prefix ‘dipul%3A’ must be specified for each layer. All available layers are listed in Annex 1.

Format: Comma-separated list

Styles

yes

Specifies the style in which the layers are to be displayed. If no style is explicitly specified, the default style is used.

Srs or crs

yes

Specifies the coordinate reference system to be used. The srs parameter is used for versions 1.0.0, 1.0.1 and 1.1.1. The crs parameter is used for version 1.3.0.

Bbox

yes

Specifies the coordinates of the map section to be displayed. The values must correspond to the coordinate reference system used.

 Format: comma-separated values (minx,miny,maxx,maxy)

Width

yes

Specifies the width of the map image in pixels.

Height

yes

Specifies the height of the map image in pixels. 

Format

yes

Specifies the chosen format of the output. 

Transparent

no

Specifies whether the map background should be transparent or not.

 Mögliche Werte: true/false

Bgcolor

no

Specifies the background colour of the map image. The default value is white (FFFFFF).

 Format: RRGGBB

Time

no

Specifies the time stamp or time period of the map data.

Format: yyyy-MM-ddThh:mm:ss.SSSZ

Sld

no

Specifies a URL encoded styledLayerDescriptor XML file. This file can be used to check and improve the map layers and the map styling.

Sld_body

no

Specifies a URL encoded styledLayerDescriptor XML file. This file can be used to check and improve the map layers and the map styling.

Example of a GetMap query:

https://uas-betrieb.de/geoservices/dipul/wms?service=WMS&version=1.3.0&request=GetMap&layers=dipul%3Aflugplaetze,dipul%3Aflughaefen,dipul%3Abundesautobahnen&bbox=49.960939%2C8.444366%2C50.174699%2C8.979950&width=808&height=500&srs=EPSG%3A4326&format=image%2Fpng

Output of the sample query:

 

reduced map, only with Bundesautobahnen (highways) and no-fly zones.


 Back to Contents


GetFeatureInfo 

The GetFeatureInfo operation allows users to search for special attributes of the characteristics of a location on a map. The geoservice responds to the query with specified additional information. Depending on the query, this information can be output in different data formats and displayed in a corresponding tool.

The following parameters are obligatory or optional for a valid GetCapabilities query:

Parameter 

Required
yes/no

Description

Service

yes

Specifies the name of the service. For a WMS query, the value must be set to WMS.

Version

yes

Specifies the service version to be used. All versions are supported (1.0.0, 1.0.1, 1.1.1, 1.3.0).

Request

yes

Specifies the chosen query option. Must be set to getFeatureInfo for this query.

Layers

yes

Specifies the layers to be displayed in the map section. The prefix ‘dipul:’ must be specified for each layer. All available layers are listed in Annex 1. 

Format: Comma-separated list

Styles

yes

Specifies the style in which the layers are to be displayed. If no style is explicitly specified, the default style is used. 

Format: Comma-separated list

Srs or crs

yes

Specifies the coordinate reference system to be used. The srs parameter is used for versions 1.0.0, 1.0.1 and 1.1.1. The crs parameter is used for version 1.3.0.

Bbox

yes

Specifies the coordinates of the map section to be displayed. The values must correspond to the coordinate reference system used.

Format: comma-separated values (minx,miny,maxx,maxy)

Width

yes

Specifies the width of the map image in pixels.

Height

yes

Specifies the height of the map image in pixels. 

Query_layers

yes

Specifies the layers to be queried. 

Format: Comma-separated list.

Info_format

yes

Specifies the chosen format of the output.

I/X

yes

Specifies the x-coordinate in the coordinate reference system.

The parameter I is used in WMS version 1.3.

The parameter X is used in older WMS versions.

J/Y

yes

Specifies the y-coordinate in the coordinate reference system.

The parameter J is used in WMS version 1.3.

The parameter Y is used in older WMS versions.

exception

no

Specifies the chosen output format for exceptions.

feature_count

no

Specifies the number of features about which information is to be returned. The default is 1.

Example of a getFeatureInfo query:

https://uas-betrieb.de/geoservices/dipul/wms?i=400&j=60&service=WMS&version=1.3.0&request=GetFeatureInfo&query_layers=dipul%3Aflugplaetze&layers=dipul%3Aflugplaetze&bbox=49.960939%2C8.444366%2C50.174699%2C8.979950&width=808&height=500&srs=EPSG%3A4326&feature_count=1

Output of the sample query:

Figure shows following output text: Results for FeatureType 'de.dfs.dpul:flugplaetze': -------------------------------------------- geom = [GEOMETRY (Polygon) with 33 points] id = flugplatz.fid--39974a14_17dac8e5679_-380d name = Frankfurt-Main BG Unfallklinik type = FLUGPLATZ lower_limit_altitude = 0 lower_limit_unit = M lower_limit_reference = GND upper_limit_altitude = 99999 upper_limit_unit = M upper_limit_reference = GND legal_ref = § 21h, Abs. 3 (1.) LuftVO --------------------------------------------


 Back to Contents


Annex 1 – List of all available map layers

Layer

WMS Layer

Aerodromes

 

dipul:flugplaetze

 

Airports

 

dipul:flughaefen

 

Control zones

 

dipul:kontrollzonen

Restricted flying zones

dipul:flugbeschraenkungsgebiete

 

Federal motorways

 

dipul:bundesautobahnen

 

Federal highways

 

dipul:bundesstrassen

 

Railway installations

 

dipul:bahnanlagen

 

Inland waterways

 

dipul:binnenwasserstrassen

 

Maritime waterways

 

dipul:seewasserstrassen

 

Shipping installations

 

dipul:schifffahrtsanlagen

 

Residential property

 

dipul:wohngrundstuecke

 

Outdoor pools and beaches

 

dipul:freibaeder

 

Industrial installations

 

dipul:industrieanlagen

 

Power plants

 

dipul:kraftwerke

 

Substations

dipul:umspannwerke

 

Power lines

dipul:stromleitungen

 

Wind farms

 

dipul:windkraftanlagen

Prisons and secure psychiatric units

dipul:justizvollzugsanstalten

 

Military installations and organizations

BSL-4 facilities

dipul:militaerische_anlagen

dipul:labore

Constitutional bodies of the Federation and the federal states

 

dipul:verfassungsorgane

 

Top-level authorities of the Federation and the federal states

 

dipul:oberste_behoerden

 

Diplomatic and consular missions

 

dipul:diplomatische_vertretungen

 

International organizations within the context of international law

 

dipul:internationale_organisationen

 

Police property

 

dipul:polizei

 

Other security authorities

 

dipul:sicherheitsbehoerden

 

Hospitals

 

dipul:krankenhaeuser

 

National parks

 

dipul:nationalparks

 

Nature reserves

 

dipul:naturschutzgebiete

 

Habitats Directive sites

 

dipul:ffh-gebiete

 

Bird sanctuaries

 

dipul:vogelschutzgebiete

 

 Back to Contents