min_time
(minimum seconds elapsed per query) value to 1 (60 queries per minute) for the Location IQ service (#166).mapquest_open
as mapbox_open
.api_options
parameter is not compatible with the specified method
.flatten=FALSE
is ignored for Geocodio and Mapquest (the output of these services requires flattening to avoid errors)."cascade"
method for geo()
. Use geo_combine()
or geocode_combine()
instead.geo_census()
geo_osm()
geo_geocodio()
geo_iq()
geo_google()
geo_opencage()
geo_mapbox()
geo_here()
geo_tomtom()
geo_mapquest()
geo_bing()
geo_arcgis()
geo_cascade()
. Use the geo()
function instead.geo()
and reverse_geo()
: iq_region
, geocodio_v
, param_error
, mapbox_permanent
, here_request_id
, mapquest_open
. Use the api_options
parameter instead.geo()
: cascade_order
, batch_limit_error
, return_type
. Instead of return_type
, use the api_options
parameter. The cascade_order
and batch_limit_error
parameters are no longer needed now that the "cascade"
method is removed.quiet
parameter in geo()
and reverse_geo()
.R CMD check
(ie. devtools::check()
).geocode_combine()
and geo_combine()
to combine the results of multiple geocoding queries. These functions are meant to replace geo(method = "cascade")
.method = "cascade"
and the cascade_order
, param_error
, and batch_limit_error
arguments for geo()
.return_type
, geocodio_v
, mapbox_permanent
, mapquest_open
, iq_region
, and here_request_id
arguments in favor of the new api_options
parameter for the geo()
and reverse_geo()
functions.api_options = list(geocodio_hipaa = TRUE/FALSE))
option to geo()
and reverse_geo()
functions to allow the toggling of the HIPAA-compliant Geocodio API endpoint (#137).progress_bar = FALSE
(a new parameter for the geo()
and reverse_geo()
functions). Similar to the readr package, progress bars are shown by default if the session is interactive and the code being run is not part of an RStudio Notebook chunk or R Markdown knitting process.quiet = TRUE
(a new parameter for the geo()
and reverse_geo()
functions).options()
for verbose
, quiet
, and progress_bar
. For instance options(tidygeocoder.verbose = TRUE)
changes the default value of verbose
from FALSE to TRUE.geo()
when no results are found (#112).reverse_geo()
and reverse_geocode()
functions. mapbox_permanent
, here_request_id
, and mapquest_open
parameters to the geo()
and reverse_geo()
functions.limit
argument can now be used with the "google" and "census" methods to control the number of results returned. These two services do not have limit arguments in their APIs so the limit is applied after the results are returned.batch_limit
is now automatically set according to the specified geocoding service unless otherwise specified.method
to "osm"
(Nominatim) for the geo()
function (it was previously "census"
).geo_<method>
functions are now deprecated.return_input
argument to geocode()
and reverse_geocode()
to provide more flexibility when using dataframes as inputs in geocoder queries.limit = NULL
can now be passed to use the default limit
value for the geocoding service.min_time_reference
, batch_limit_reference
, api_key_reference
, and api_info_reference
datasets to more accessibly store values for min_time
, batch_limit
, the names of environmental variables for API keys, and information for documentation (such as API documentation links).geocode()
and reverse_geocode()
now require limit = 1
(default) unless return_input = FALSE
. This fixes a bug where geocoding results could be misaligned with the input dataset when limit > 1
. (#88).batch_limit_error
argument in the geo()
function and batch_limit_error
is set to FALSE if method = "cascade"
. When batch_limit_error
is FALSE then the batch query size is limited to the batch limit and executed (which was the default behavior in the previous version).address_list
argument of query_api()
has been renamed to input_list
to reflect that it is used for both forward and reverse queries when using the Geocodio service for batch geocoding.query_api()
function now returns a named list which contains the response content and the HTTP status code. The geo()
and reverse_geo()
functions now use the HTTP status code directly to determine if a response is valid.geo()
and reverse_geo()
).param_error
parameter in geo()
(or geocode()
).custom_query
argument with Geocodio batch geocoding (#48).order()
is no longer called on data frames (#57).query_api()
and get_api_query()
.full_results = TRUE
. This will return all data provided by the geocoding service instead of just latitude and longitude coordinates. Additionally, the return_type = 'geographies'
argument for the Census geocoder will return geography columns.street
, city
, county
, postalcode
, country
).limit
and custom_query
arguments (see the geo()
function for details).min_time
argument in geo()
) to respect usage limits. This should fix the past issue of users being locked out of the OSM service due to usage limit violations.cascade
method can now be customized by using the cascade_order
argument (see geo()
documentation)verbose = TRUE
tibble
, dplyr
, jsonlite
, and httr
. The package no longer has direct dependencies on tmaptools
, stringr
, purrr
, tidyr
, and rlang
.httr
. The inbuilt api_parameter_reference
dataset is used to map standard "generic" parameter names to the parameter names used by each specific geocoding service.geo()
function. Users can still use geocode()
, geo_osm()
, and geo_census()
as before. However, geo_osm()
and geo_census()
are now just convenience functions that call geo()
and geocode()
passes all addresses to geo()
for geocoding.Per CRAN request, fixed an issue where the example for R/geocode.R
failed. The only change required was to add a library(dplyr)
statement.
Initial CRAN release. Per CRAN request:
print()
with warning()
to make suppressing console output possible.\dontrun
with \donttest
in .R files