Skip to contents

Heliports

bkg_heliports.Rd

Get heliports in Germany. Based on data from third-party providers and image classification of aerial imagery.

Usage

bkg_heliports(
  ...,
  bbox = NULL,
  poly = NULL,
  predicate = "intersects",
  filter = NULL,
  epsg = 3035,
  properties = NULL,
  max = NULL
)

Arguments

...

Used to construct CQL filters. Dot arguments accept an R-like syntax that is converted to CQL queries internally. These queries basically consist of a property name on the left, an aribtrary vector on the right, and an operator that links both sides. If multiple queries are provided, they will be chained with AND. The following operators and their respective equivalents in CQL and XML are supported:

RCQLXML
===PropertyIsEqualTo
!=<>PropertyIsNotEqualTo
<<PropertyIsLessThan
>>PropertyIsGreaterThan
>=>=PropertyIsGreaterThanOrEqualTo
<=<=PropertyIsLessThanOrEqualTo
%LIKE%LIKEPropertyIsLike
%ILIKE%ILIKE
%in%IN

To construct more complex queries, you can use the filter argument to pass CQL queries directly. Also note that you can switch between CQL and XML queries using options(ffm_query_language = "xml"). See also wfs_filter.

bbox

An sf geometry or a boundary box vector of the format c(xmin, ymin, xmax, ymax). Used as a geometric filter to include only those geometries that relate to bbox according to the predicate specified in predicate. If an sf geometry is provided, coordinates are automatically transformed to ESPG:25832 (the default CRS), otherwise they are expected to be in EPSG:25832.

poly

An sf geometry. Used as a geometric filter to include only those geometries that relate to poly according to the predicate specified in predicate. Coordinates are automatically transformed to ESPG:25832 (the default CRS).

predicate

A spatial predicate that is used to relate the output geometries with the object specified in bbox or poly. For example, if predicate = "within", and bbox is specified, returns only those geometries that lie within bbox. Can be one of "equals", "disjoint", "intersects", "touches", "crosses", "within", "contains", "overlaps", "relate", "dwithin", or "beyond". Defaults to "intersects".

filter

A character string containing a valid CQL or XML filter. This string is appended to the query constructed through .... Use this argument to construct more complex filters. Defaults to NULL.

epsg

An EPSG code specifying a coordinate reference system of the output. If you're unsure what this means, try running sf::st_crs(...)$epsg on a spatial object that you are working with. Defaults to 3035.

properties

Vector of columns to include in the output.

max

Maximum number of results to return.

Value

A dataframe with the following columns:

  • name: Geographical name of the POI

  • gemeinde: Municipality name

  • verwaltung: Administrative association name

  • kreis: District name

  • regierungs: Government region name

  • bundesland: Federal state name

  • code: Identifier of the heliport

  • name_bkg: Name of the landing site according to BKG

  • name_dfs: Name of the landing size according to Deutsche Flugsicherung (DFS)

  • airport_pk: Identifier according to the LFS aviation manual

  • befestigun: Pavement type of the landing site. Can be:

    • befestigt: paved

    • teilweise befestigt: partially paved

    • unbefestigt: unpaved

  • kennzeich: Marking of the landing size. Can be:

    • gekennzeichnet: marked

    • nicht gekennzeichnet: not marked

  • lage: Location of the landing size. Can be:

    • D: Roof

    • F: Field

    • PG: Platform next to a hospital

    • W: Pasture

    • LP: Landing site

    • PP: Parking lot

    • LP / W: Paved landing size on pasture

    • F / W: Field or pasture

    • LP / Str.: Landing size next to a street

  • typ: Type of heliport. Can be:

    • H: Heliport

    • HH: Heliport at a hospital

    • MH: Military heliport

  • typ2: Additional heliport type for landing sites with an air rescue station. Can be:

    • HRLS: Helicopter air rescue station

    • ITH: Intensive transport helicopter

  • betreiber: Operator of the heliport

  • helikopter: Name of the helicopter belonging to the air rescue station

  • status: Whether the point geometry was edited by the BKG. Can be:

    • Original: not edited

    • Verschoben: moved

    • neu: newly added

  • quelle: Source of the information. Can be:

    • BKG: Own research by the BKG

    • DFS-Liste: Provided by DFS

    • LBA-Liste: Provided by the Federal Aviation Office (LBA)

    • MHW: Provided by the Medical Disaster Relief Organization (MHW)

    • RTH.Info: Provided by rth.info

Query language

By default, WFS requests use CQL (Contextual Query Language) queries for simplicity. CQL queries only work together with GET requests. This means that when the URL is longer than 2048 characters, they fail. While POST requests are much more flexible and able to accommodate long queries, XML is really a pain to work with and I'm not confident in my approach to construct XML queries. You can control whether to send GET or POST requests by setting options(ffm_query_language = "XML") or options(ffm_query_language = "CQL").

See also

wfs_poi_open documentation

wfs_poi_open MIS record

Other points of interest: bkg_airports(), bkg_crossings(), bkg_kilometrage(), bkg_seaports(), bkg_stations(), bkg_trauma_centers()

Examples

if (FALSE) { # getFromNamespace("ffm_run_examples", ns = "ffm")()
# Get only military heliports
bkg_heliports(typ == "MH")

# Get only rooftop heliports
bkg_heliports(lage == "D")
}