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 geocoder 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 geocoder 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_query
argument in the geo()
function and batch_limit_query
is set to FALSE if using the “cascade” method. When batch_limit_query
is FALSE then the batch query is limited to the batch limit and executed. In the past, all batch queries that exceeded the batch query limit would be limited to the batch limit and no error was thrown.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 (content
) and the HTTP status code (status
). 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 geocoder 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 geocoder 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. Only change required was to add a library(dplyr) statement.
Initial CRAN release. Per CRAN request: * Replaced print()
with warning()
to make suppressing console output possible. * Replaced \dontrun
with \donttest
in .R files