get_openstreetmap()
accesses a tile server for OpenStreetMap and
downloads/formats a map image. This is simply a wrapper for the web-based
version at https://www.openstreetmap.org/. If you don't know how to get
the map you want, go there, navigate to the map extent that you want, click
the export tab at the top of the page, and copy the information into this
function.
Arguments
- bbox
a bounding box in the format c(lowerleftlon, lowerleftlat, upperrightlon, upperrightlat)
- scale
scale parameter, see https://wiki.openstreetmap.org/wiki/MinScaleDenominator. smaller scales provide a finer degree of detail, where larger scales produce more coarse detail. The scale argument is a tricky number to correctly specify. In most cases, if you get an error when downloading an openstreetmap the error is attributable to an improper scale specification.
OSM_scale_lookup()
can help; but the best way to get in the correct range is to go to https://www.openstreetmap.org/, navigate to the map of interest, click export at the top of the page, click 'map image' and then copy down the scale listed.- format
character string providing image format - png, jpeg, svg, pdf, and ps formats
- messaging
turn messaging on/off
- urlonly
return url only
- filename
destination file for download (file extension added according to format). Default
NULL
means a randomtempfile()
.- color
color or black-and-white
- ...
...
Details
In some cases the OSM server is unavailable, in these cases you will receive
an error message from utils::download.file()
with the message HTTP status
'503 Service Unavailable'. You can confirm this by setting urlonly = TRUE
,
and then entering the URL in a web browser. the solution is either (1)
change sources or (2) wait for the OSM servers to come back up.
See https://www.openstreetmap.org/copyright/ for license and copyright information.
Author
David Kahle david@kahle.io