List Available Geocoder Services

Evaluates the logged in user from an authorization token and returns a data.frame containing the available geocoding services for the associated token.

For users who have not signed into a private portal or ArcGIS Online, the public ArcGIS World Geocoder is used. Otherwise, the first available geocoding service associated with your authorization token is used.

Usage

list_geocoders(token = arc_token())

default_geocoder(token = arc_token())

world_geocoder()

Arguments

token

an object of class httr2_token as generated by auth_code() or related function

Value

a data.frame with columns url, northLat, southLat, eastLon, westLon, name, suggest, zoomScale, placefinding, batch.

Details

The default_geocoder() will return the ArcGIS World Geocoder if no token is available. list_geocoder() requires an authorization token.

The ArcGIS World Geocoder is made publicly available for some uses. The world_geocoder() is used as the default GeocodeServer object in default_geocoder() when no authorization token is found. The find_address_candidates(), reverse_geocode(), and suggest_places() can be used without an authorization token. The geocode_addresses() funciton requires an authorization token to be used for batch geocoding.

To manually create a GeocodeServer object, see geocode_server().

Examples

# Default geocoder object
# ArcGIS World Geocoder b/c no token
default_geocoder()
#> <GeocodeServer>
#> Description: World Geocoder
#> Version: 11.4
#> CRS: 4326

# Requires an Authorization Token
if (FALSE) { # \dontrun{
list_geocoders()
} # }