NEWS.md
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.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.