Configure the Overpass and Nominatim endpoints, HTTP behaviour and caching
used by all ox_* download functions. Called with no arguments it returns
the current settings as a list; called with named arguments it updates them
and returns the previous values invisibly.
Details
timeout (seconds) applies both to the HTTP request and to the Overpass
server-side query timeout. max_tries is the total number of attempts per
request: transient failures — HTTP 429, 500, 502, 503, 504 and dropped
connections, which busy Overpass/Nominatim servers routinely return — are
retried with exponential backoff (honouring any Retry-After header)
before an error is raised. cache toggles the in-session response cache
(see ox_clear_cache()).
References
osmnxr is an R port of OSMnx. If you use it, please cite:
Boeing, G. (2025). Modeling and analyzing urban networks and amenities with OSMnx. Geographical Analysis, 57(4), 567–577. doi:10.1111/gean.70009
Examples
ox_settings()
#> $overpass_url
#> [1] "https://overpass-api.de/api/interpreter"
#>
#> $nominatim_url
#> [1] "https://nominatim.openstreetmap.org"
#>
#> $user_agent
#> [1] "osmnxr R package (https://github.com/StrategicProjects/osmnxr)"
#>
#> $timeout
#> [1] 180
#>
#> $max_tries
#> [1] 3
#>
#> $cache
#> [1] TRUE
#>
old <- ox_settings(timeout = 300)
ox_settings(timeout = old$timeout) # restore