osmdata 0.3.0
CRAN release: 2025-08-23
Breaking changes
- Remove
magrittr
from imports. User code relaying on reexported pipe%>%
fromosmdata
must explicitly load it withlibrary(magrittr)
. Code examples, tests and vignettes now use the pipe from base (|>
) available since R 4.1 (#361) -
getbb(..., format_out = "polygon")
return polygons following [https://www.ogc.org/standards/sfa/]. Polygons are defined by a list of matrices of coordinates. The first ring defines the exterior boundary, and the following rings define holes if present. Also fixgetbb(..., format_out = "sf_polygon")
returning each (multi)polygon as a row in ansf
object. Before, every ring was an independent polygon, even for holes or multipolygons, and forformat_out = "sf_polygon"
, the features were split in a list with polygons in one item and multipolygons in another (#378).
Major changes
- Implemented
c.osmdata_sc
method to joinosmdata_sc
objects (#333) - Depends on R >= 4.1 to use the base pipe (
|>
) in examples and vignettes (#371) - Deprecate
nodes_only
argument inopq()
. Superseded by argumentosm_types
(#370) - Deprecate
osmdata_sp
(#372) - Pre-prend class names
osmdata_sf
andosmdata
rather than append; thanks to @agila5 (#373) - Add
osmadata_data.frame
class toosmdata_data_frame()
results (#378) - Reimplement
trim_osmdata()
usingsf
instead ofsp
. Now, it checks the full geometry instead of just the points to determine if an object is properly contained in the bbox (only forosmdata_sf
objects,osdmata_sc
still wrong) (#382).
Minor changes
- Improved
get_bb(..., format_out = "sf_polygon")
to return full metadata along with geometries (#338 thanks to @RegularnaMatrica) - Mention key-only feature requests in README (#342 thanks to @joostschouppe)
- Merge any columns in
osmdata_sf()
with mixed-case duplicated names (#348) - Set encoding to UTF-8 for tags and user names (#347)
- Document the use of the input query as character strings for
osmdata_*()
(#349) - Consistent
NA
values throughout all multi-* matrices returned byosmdata_sf()
(#355) - Fix dates and remove
lubridate
from imports (#360) - Restructure class definitions of
osmdata_sf()
andosmdata_sc()
objects (#373, #374) - Revert added
osmdata
class toosmdata_data_frame()
andosmdata_sc()
+ Fix docs to better represent classes accepted bytrim_osmdata()
,osm_poly2line()
and extract function (#380) - Use
terra
functions instead ofraster
(obsolete) inosm_elevation()
(#383) - Joan Maspons is the new mantainer (#384).
osmdata 0.2.5
CRAN release: 2023-08-14
Major changes
- v0.2.4 was removed without notice from CRAN because of #329; this is a rapid re-submission
osmdata 0.2.4
CRAN release: 2023-08-11
Minor changes
- Bug fix to stop getbb call to Nominatim returning 405 error (#328)
osmdata 0.2.2
CRAN release: 2023-04-24
Major changes:
-
osmdata_data_frame
adds columnsosm_center_lat
andosm_center_lon
forout * center;
queries (#316, #319). - Add parameters from
opq
toopq_osm_id
: out, datetime, datetime2, adiff, timeout and memsize (#320) - Fix
available_tags()
function which no longer worked (#322 thanks to @boiled-data) - Implement
out:csv
queries (#321).
osmdata 0.2.0
CRAN release: 2023-02-09
This release welcomes a new package author @jmaspons. The lists of changes here gives an overview of the amazing work he has contributed to this new major version.
Major changes:
- New
osmdata_data_frame()
function to return non-spatialdata.frame
structures directly from overpass; thanks to @jmaspons (#285). - Improved
add_osm_features
so that key-values pairs can be submitted as a list, rather than escape-delimited character strings; thanks to @elipousson (#277, #278). -
opq()
can now utilise overpass ability to filter results by area; thanks to @jmaspons (#286). -
opq()
now has additional “out” parameter to control the kinds of data returned by overpass; thanks to @jmaspons (#288). -
opq()
now has additional “osm_types” parameter to provide finer control of which kinds of data are returned by overpass; thanks to @jmaspons (#295). - Fix key modifications for non-valid column names and handle duplicated column names in
osmdata_*
functions; by @jmaspons (#303) - @elipousson is new package contributor, thanks to the above work.
- @jmaspons is new package author, thanks to #285 (plus most of the above, and a whole lot more!)
osmdata 0.1.10
CRAN release: 2022-06-09
Major changes:
- Changed httr dependency for httr2 (#272)
- Removed two authors of code formerly including for stubbing results; which is now done via
httptest2
package.
osmdata 0.1.9
CRAN release: 2022-01-26
Major changes:
- New function
opq_around
to query features within a specified radius around a defined location; thanks to @barryrowlingson via #199 and @maellecoursonnais via #238 - New vignette on splitting large queries thanks to @Machin6 (via #262)
Minor changes:
- New dependency on
reproj
package, so thattrim_osmdata()
can be applied to re-projected coordinates.
osmdata 0.1.7
CRAN release: 2021-10-07
Minor changes:
-
add_osm_feature
bug fix to revert AND behaviour (#240 thanks to @anthonynorth)
osmdata 0.1.5
CRAN release: 2021-03-22
Minor changes:
- Bug fix in
getbb()
via #232, thanks to @changwoo-lee - hard-code WKT string for EPSG:4326, to avoid obsolete proj4strings (#218)
- bug fix in
print
method via #236; thanks to @odeleongt
osmdata 0.1.4
CRAN release: 2020-11-03
Major changes:
- New
osm_enclosing()
function; thanks to @barryrowlingson via #199 -
opq()
now has additionaldatetime
anddatetime2
parameters which can be used to extract historical data prior todatetime
, or differences between two datetimes by specifyingdatetime2
; thanks to @neogeomat for the idea in issue#179. - opq() also has additional
nodes_only
parameter to return nodes as points only, for efficient extraction of strictly point-based OSM data; thanks to @gdkrmr for the idea in issue#221.
Minor changes:
- New contributor Enrico Spinielli (@espinielli), via #207, #210, #211, #212 - Thanks!
osmdata 0.1.3
CRAN release: 2020-02-09
Major changes:
-
osmdata_pbf
function removed as the overpass server no longer provides the experimental API for pbf-format data. - Remove deprecated
add_feature()
function; entirely replaced byadd_osm_feature()
. -
get_bb()
with polygon output formats now returns ALL polygon and multipolygon objects by default (issue#195)
Minor changes:
- New Contributors: Andrea Gilardi (@agila5)
- Bug fix for issue#205
osmdata 0.1.2
CRAN release: 2019-12-14
Major changes:
- New function
unname_osmdata_sf
, to remove row names fromsf
-format geometry objects that may cause issues with some plotting routines such as leaflet.
Minor changes:
-
getbb
now allows arbitraryfeaturetype
specification, no longer just those pertaining to settlement forms. - available_tags returns tags with underscore precisely as required for
add_osm_feature
- previous version returned text values with spaces instead of underscore. - Fix bug in
osmdata_sf
for data with no names and/or no key-val pairs - Fix bug in
trim_osmdata
for multi* objects; thanks to @stragu - Implement
trim_osmdata.sc
method - retry httr calls to nominatim, which has lately been timing out quite often
osmdata 0.1.0
CRAN release: 2019-04-25
Major changes:
- New function,
osm_elevation
to insert elevation data intoSC
-format data returned byosmdata_sc
function. - New vignette on
osmdata_sc
function and elevation data. -
opq()
function now accepts polygonal bounding boxes generated withgetbb(..., format_out = "polygon")
.
osmdata 0.0.10
CRAN release: 2019-03-21
Minor changes:
- Bug fix for vectorized lists of values in
add_osm_feature
, so only listed items are returns (see #139; thanks @loreabad6) - But fix to ensure all
sf
data.frame
objects havestringsAsFactors = FALSE
osmdata 0.0.9
CRAN release: 2018-12-19
Major changes:
- New function
osmdata_sc
to return data insilicate::SC
format (see github.com/hypertidy/silicate; this also requires additional dependency ontibble
) - Structure of
osmdata
object modified to replace former$timestamp
field with$meta
field containing a list of$timestamp
,$OSM_version
(currently 0.6), and$overpass_version
. - add_osm_feature() now accepts vectors of multiple values (see #139).
- osmdata_sf() objects default to character vectors, not factors (see #44).
Minor changes:
- vignette updated
- Overpass URL now randomly selected from the four primary servers (see https://wiki.openstreetmap.org/wiki/Overpass_API#Public_Overpass_API_instances), thanks to @JimShady.
- bug fix for osmdata_sp() (see #56)
- osmdata_sp() fixed to return osm_id values (see #131; thanks @JimShady).
osmdata 0.0.8
CRAN release: 2018-10-22
- Fix bug in
trim_osmdata
so that all sf attributes are reinstated, and also issue message that sf-preload is necessary for this function - Fix bug with opq (key_exact = FALSE) so value_exact is always also set to FALSE
osmdata 0.0.7
CRAN release: 2018-05-17
- Fix bug in
c
method so it works whensf
not loaded - Fix bug in overpass query syntax to match new QL requirements
osmdata 0.0.6
CRAN release: 2018-02-22
- Add new function ‘osm_poly2line()’ to coerce the ‘osmdataosm_lnes’. This is important for street networks (‘add_osm_objects (key = “highway”)’), which are otherwise separated between these two components.
- Add new function
opq_osm_id
to query by OSM identifier alone - Add
timeout
andmemsize
options toopq()
to improve handling large queries. - Return useful information from overpass server when it returns neither error nor useful data
- Make C++ code interruptible so long processing can be cancelled
- Fix minor yet important C++ code lines that prevented package being used as dependency by other packages on some systems
osmdata 0.0.5
CRAN release: 2017-08-13
- Add extraction of bounding polygons with
getbb (..., format_out = "polygon")
- Add
trim_osmdata
function to trim anosmdata
object to within a bounding polygon (thanks @sytpp) - Add
unique_osmdata
function which reduces each component of anosmdata
object only to unique elements (so$osm_points
, for example, only contains points that are not represented in other - line, polygon, whatever - objects). - Rename
add_feature
toadd_osm_feature
(and deprecate old version)
osmdata 0.0.4
CRAN release: 2017-06-21
- Enable alternative overpass API services through
get_overpass_url()
andset_overpass_url()
functions - Extend and improve vignette