acs.fetch function requires an "API key" to use when
downloading data from the US Census API. Rather than pass this rather
long string to the function each time, users can save the key as part of
the package installation, using the
Once installed, an api key is saved on the system and available for use
in future sessions. (To replace a key, simply call the function again
with the new key.)
The API key provided to the user upon registering with the US Census Developer's page. A string.
An alternate name to use when storing key; reserved for future use.
The requirement for a key seems to be laxly enforced by the Census API,
but is nonetheless coded into the acs package. Users without a key may
find success by simply installing a blank key (i.e., key="") via
api.key.install(key=""); similarly, calls to
geo.make(..., check=T) may succeed with a
Note that while this may work today, it may fail in the future if the
API decides to start enforcing the requirement.
Saves the key and exits silently, unless an error is encountered.
Ezra Haber Glenn [email protected]
To request an API key, see http://www.census.gov/developers/
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.