This page displays the built-in datasets that are used in the tidygeocoder package to set parameters and settings for geocoder queries. Refer to the table on the home page for a summary of the supported geocoder services.

API Parameters

The api_parameter_reference maps geocoder service API parameters to a common set of “generic” parameters. Refer to ?api_parameter_reference for more details.

Minimum Time Per Query

The minimum time (in seconds) required per query to comply with the usage limitations is stored in the min_time_reference dataset. See ?min_time_reference.

method min_time description
osm 1.00 1 query per second
geocodio 0.06 1000 queries per minute (free tier)
iq 0.50 2 queries per second (free tier)
google 0.02 50 queries per second
opencage 1.00 1 query/second
mapbox 0.10 600 queries per minute (free tier)
tomtom 0.20 5 queries per second (free tier)
here 0.20 5 queries per second (free tier)

Batch Query Limits

The maximum number of inputs (geographic coordinates or addresses) per batch query is stored in the batch_limit_reference dataset. See ?batch_limit_reference.

method batch_limit
census 10,000
geocodio 10,000
tomtom 10,000
here 1,000,000
mapquest 100
bing 50

API Key Retrieval

API keys are retrieved from environmental variables. The name of the environmental variable used for each service is stored in the api_key_reference dataset. See ?api_key_reference.

method env_var
geocodio GEOCODIO_API_KEY
iq LOCATIONIQ_API_KEY
google GOOGLEGEOCODE_API_KEY
opencage OPENCAGE_KEY
mapbox MAPBOX_API_KEY
here HERE_API_KEY
tomtom TOMTOM_API_KEY
mapquest MAPQUEST_API_KEY
bing BINGMAPS_API_KEY

API Documentation

Links to the API documentation for each geocoder service:

API Usage Policies

Links to the usage policies for each geocoder service: