add_osm_feature

0th

Percentile

Add a feature to an Overpass query

Add a feature to an Overpass query

Usage
add_osm_feature(opq, key, value, key_exact = TRUE, value_exact = TRUE,
  match_case = TRUE, bbox = NULL)

add_feature(opq, key, value, key_exact = TRUE, value_exact = TRUE, match_case = TRUE, bbox = NULL)

Arguments
opq

An overpass_query object

key

feature key

value

value for feature key; can be negated with an initial exclamation mark, value = "!this", and can also be a vector, value = c ("this", "that").

key_exact

If FALSE, key is not interpreted exactly; see https://wiki.openstreetmap.org/wiki/Overpass_API

value_exact

If FALSE, value is not interpreted exactly

match_case

If FALSE, matching for both key and value is not sensitive to case

bbox

optional bounding box for the feature query; must be set if no opq query bbox has been set

Value

opq object

Note

key_exact should generally be TRUE, because OSM uses a reasonably well defined set of possible keys, as returned by available_features. Setting key_exact = FALSE allows matching of regular expressions on OSM keys, as described in Section 6.1.5 of http://wiki.openstreetmap.org/wiki/Overpass_API/Overpass_QL. The actual query submitted to the overpass API can be obtained from opq_string.

add_feature is deprecated; please use add_osm_feature.

References

http://wiki.openstreetmap.org/wiki/Map_Features

Aliases
  • add_osm_feature
  • add_feature
Examples
# NOT RUN {
q <- opq ("portsmouth usa") %>%
                add_osm_feature(key = "amenity",
                                value = "restaurant") %>%
                add_osm_feature(key = "amenity", value = "pub") 
osmdata_sf (q) # all objects that are restaurants AND pubs (there are none!)
q1 <- opq ("portsmouth usa") %>%
                add_osm_feature(key = "amenity",
                                value = "restaurant") 
q2 <- opq ("portsmouth usa") %>%
                add_osm_feature(key = "amenity", value = "pub") 
c (osmdata_sf (q1), osmdata_sf (q2)) # all objects that are restaurants OR pubs
# Use of negation to extract all non-primary highways
q <- opq ("portsmouth uk") %>%
        add_osm_feature (key = "highway", value = "!primary") 
# }
Documentation reproduced from package osmdata, version 0.1.1, License: GPL-3

Community examples

Looks like there are no examples yet.