NEWS.md
oe_providers() and removed the argument quiet. Now the function is always quiet. The corresponding message is included in the docs..osm.pbf and .gpkg files downloaded or created by this package has changed from tempdir() to tools::R_user_dir("osmextract", "data") (#302).tools::R_user_dir() since that function was introduced in R 4.0.0 (#302).oe_get() and related functions (oe_get_boundary(), oe_get_network(), …) when a sf/sfc/bbox is provided as input for place. If boundary is not NA, it is automatically set to match place so only the relevant portion of the extract is processed (#313). Thanks to @juanfonsecaLS1.oe_vectortranslate is now always in synch with the one provided by sf or GDAL. A fall-back is provided in case of problems (#261).version argument to oe_match to simplify the download of old extracts from Geofabrik provider (#295)oe_get_network so that the queries are compatible with GDAL 3.10 (#298).oe_get_network does not drop elements tagged as access = 'no' as long as the foot/bicycle/motor_vehicle (according to the chosen mode of transport) key is equal to yes, permissive, or designated (#289).osmconf.ini file to be in synch with the GDAL version.oneway column by default when using oe_get_network(mode = "driving"), which indicates if a link represents a uni-directional road (#296)oe_get_network(mode = "driving") always include the motor_vehicle field (see #303).ogr2ogr options detected by GDAL v3.9 (#291).oe_match() that occurred every time the function found an exact match between the input place and a non-default OSM data provider (i.e. everything but Geofabrik). In those cases, the downloaded file was named as geofabrik_xyz.osm.pbf instead of differentprovider_xyz.osm.pbf. Reported by @GretaTimaite, thanks. See #246. This is a major bug and, for safety, we suggest you erase all .pbf and .gpkg files currently stored in the persistent download directory (see also oe_clean()).oe_get_keys() that occurred when the value for a given key was either empty or equal to \n (#250).oe_vectortranslate() that occurred when the attributes specified in the extra_tags argument included the character :. In fact, the presence of attributes like “lanes:left” always triggered the vectortranslate operations (#260).oe_get_boundary() that can be used to obtain administrative geographical boundaries of a given area (#206).read_poly() to read .poly files (#277).pbf.internal, history, taginfo, updates, bz2, and shp from geofabrik_zones; last_modified, type, base_url and poly_url from bbbike_zones.oe_match_pattern() now accepts numeric/sfc/bbox/sf inputs, following the same logic as oe_match() (#266).boundary argument can be specified using bbox objects. The bbox object is converted to sfc object with sf::st_as_sfc() and preserves the same CRS.oe_get() or oe_read() are run with empty or unnamed arguments in ... (#234 and #241).oe_get_keys() gains a new argument named download_directory that can be used to specify the path of the directory that stores the .osm.pbf files.oe_clean() to remove all .pbf and .gpkg files stored in a given directory. Default value is oe_download_directory().oe_download() and removed a warning from oe_read(). The message is printed every time a user downloads a new OSM extract from a certain provider, whereas the warning used to be raised when a given query selected a layer different from the layer argument (#240).oe_find() named return_pbf and return_gpkg. They can be used to select which file formats should the function return (#253).oe_download() fails, explaining that partially downloaded .pbf files should be removed to avoid problems while running other functions (#221).testthat and we implemented the so-called test-fixtures to run tests in a more isolated environment (#255). This is however still experimental for us.oe_get_keys() (#251).oe_download() is specified using / instead of \\ separator on Windows.oe_download() takes into account the timeout option again. Unfortunately, we forgot to adjust the code when switching from download.file to httr.oe_vectortranslate() function tries to correct the possible geometrical problem(s) of the input boundary using sf::st_make_valid().geofabrik_zones database (#270).Help files below man/ have been re-generated, so that they give rise to valid HTML5 (#259).
httr and jsonlite (#231, #232).oe_download() and oe_search() now take advantage of httr functionalities. They return informative messages in case of errors (#231, #232).oe_vectortranslate() that occurred when reading multilinestrings or other_relations layers with one or more extra tags (#229).oe_get()/oe_read() that could return a warning message when reading an existing GPKG file with a query argument.extra_tags are now removed before modifying the osmconf.ini file. Duplicated tags means something like extra_tags = c("A", "A") or even fields that are included by default (i.e. extra_tags = "highway" for the lines layer). See discussion in #229.oe_get_network() to import a road network used by a specific mode of transport. For the moment, we support the following modes of transport: cycling (default), walking, and driving. Check ?oe_get_network for more details and examples (#218).layer argument is now converted to lower case before checking if the required layer is admissible.oe_get() and oe_vectortranslate() for sf v1.0.2.suppressMessages() in oe_match() (#217).oe_get_keys() function can be used to extract the values associated with all or some keys. We also defined an ad-hoc printing method and fixed several bugs. The examples were improved. Moreover, the function tries to match an input zone with one of the OSM extracts previously downloaded (#201 and #196).place represents an sf/sfc/bbox object with missing CRS, then oe_match() raises a warning message and sets CRS = 4326. This has relevant consequences on other functions (like oe_get()) that wrap oe_match().sf > 0.9.8, the function oe_vectortranslate() stops with an error when there is a problem in the argument vectortranslate_options and quiet = FALSE (instead of raising a warning or crashing the R session). See here for more details.c("-f", "GPKG", "-overwrite", "-oo", "CONFIG_FILE=", path-to-config-file, "-lco", "GEOMETRY_NAME=geometry", layer) are always appended at the end of vectortranslate_options argument unless the user explicitly sets different default parameters for the arguments -f, -oo and -lco (#200). We believe those are sensible defaults and can help users creating less verbose specifications for ogr2ogr utility.oe_vectortranslate() (therefore also in oe_get() and oe_read()) named boundary and boundary_type. They can be used to create an ad-hoc spatial filter during the vectortranslate operations (and create even less verbose specifications in vectortranslate_options argument). See docs and introductory vignette for more details.provider was removed from oe_match_pattern() since the function automatically checks all available providers (#208).force_vectortranslate is checked before reading the layers of an existing gpkg file. If force_vectortranslate is TRUE, then oe_vectortranslate() doesn’t check the existing layers. This is important for user that run oe_vectortranslate() after stopping the vectortranslate process.extra_tags and osmconf_ini are not ignored when vectortranslate_options is not NULL (#182).sf v1.0 (#194).oe_read() via ... are compared with the formals of st_read.character, st_as_sf.data.frame, and read_sf.oe_match for bbox objects (#185).oe_get_keys() function can be applied to .osm.pbf objects (#188).oe_match().This is a minor release.
Published on CRAN!
level parameter to oe_match(). It is used to choose between multiple hierarchically nested OSM extracts. The default behaviour is to select the smallest administrative unit (#160).oe_match(). The function checks all implemented providers in case the input place is not matched with any geographical zone for the chosen provider (#155).oe_match() to geolocate text strings that cannot be found in the providers (#155).oe_find() and oe_search()