arcgisgeocode (version 0.4.0)

list_geocoders: List Available Geocoder Services

Description

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()

Value

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

Arguments

token

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

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()

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