https://github.com/waldoj/fips-to-gnis

A list of every FIPS code (Census Code) and its corresponding GNIS ID.
https://github.com/waldoj/fips-to-gnis

api census fips geodata geospatial gnis

Last synced: 3 days ago
JSON representation

A list of every FIPS code (Census Code) and its corresponding GNIS ID.

• Host: GitHub
• URL: https://github.com/waldoj/fips-to-gnis
• Owner: waldoj
• License: cc0-1.0
• Created: 2014-07-07T18:48:48.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2023-09-02T02:24:34.000Z (about 1 year ago)
• Last Synced: 2024-06-11T19:17:44.240Z (5 months ago)
• Topics: api, census, fips, geodata, geospatial, gnis
• Language: Shell
• Size: 1.03 MB
• Stars: 5
• Watchers: 4
• Forks: 4
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# FIPS to GNIS Conversion

A list of every FIPS code (Census Code) and its corresponding GNIS ID. This is nothing but a long CSV file, listing only the IDs. This includes every FIPS code—not every GNIS ID—and is derived from [`NationalFedCodes_20140601.zip`](http://geonames.usgs.gov/docs/federalcodes/NationalFedCodes_20140601.zip) at the U.S. Board of Geographic Names' website. It's simply that file, with all data stripped out other than our two fields.

## Query the API

This data is available via an API, in the format `https://fipsgnis.com/FIPSCODE.json`, e.g. a query for for New York, New York, to [`https://fipsgnis.com/410494.json`](https://fipsgnis.com/410494.json), returns the following:

```json

{

  "fips": "410494",

  "gnis": "36061"

}

```

The API consists of static files hosted on S3, provided via CloudFront, so there's no need to be gentle—query all you need, at whatever rate you need. But if you prefer something local and faster, you can generate your own copy.

It's not yet possible to query by GNIS ID, only by FIPS code. But [that's planned](https://github.com/waldoj/FIPS-to-GNIS/issues/3).

## Generate Your Own CSV

You can generate your own, more up-to-date version of this.

1. Clone or download this repository.

2. Edit the included `run.sh` script to remove everything after `csv.sh`.

3. Run `run.sh` (`./run.sh`).

## Generate Your Own API

Make your own API.

1. Clone or download this repository.

2. Have `awscli` installed and configured on your system (to write files to S3). Alternately, edit `run.sh` to erase everything after `api.sh` and upload the resulting files wherever you care to host your API.

3. Run `run.sh` (`./run.sh`).