{"id":19295816,"url":"https://github.com/waldoj/fips-to-gnis","last_synced_at":"2025-04-22T08:30:55.040Z","repository":{"id":18401073,"uuid":"21582566","full_name":"waldoj/FIPS-to-GNIS","owner":"waldoj","description":"A list of every FIPS code (Census Code) and its corresponding GNIS ID.","archived":false,"fork":false,"pushed_at":"2023-09-02T02:24:34.000Z","size":1085,"stargazers_count":5,"open_issues_count":3,"forks_count":4,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-01T21:13:56.723Z","etag":null,"topics":["api","census","fips","geodata","geospatial","gnis"],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"cc0-1.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/waldoj.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2014-07-07T18:48:48.000Z","updated_at":"2024-04-16T21:08:24.000Z","dependencies_parsed_at":"2023-09-21T19:24:39.626Z","dependency_job_id":null,"html_url":"https://github.com/waldoj/FIPS-to-GNIS","commit_stats":{"total_commits":19,"total_committers":2,"mean_commits":9.5,"dds":"0.052631578947368474","last_synced_commit":"b206587f657ad2f525d6324dcfa7e8168f884404"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waldoj%2FFIPS-to-GNIS","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waldoj%2FFIPS-to-GNIS/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waldoj%2FFIPS-to-GNIS/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waldoj%2FFIPS-to-GNIS/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/waldoj","download_url":"https://codeload.github.com/waldoj/FIPS-to-GNIS/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250206053,"owners_count":21392175,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","census","fips","geodata","geospatial","gnis"],"created_at":"2024-11-09T22:44:32.054Z","updated_at":"2025-04-22T08:30:54.530Z","avatar_url":"https://github.com/waldoj.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# FIPS to GNIS Conversion\n\nA 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.\n\n## Query the API\n\nThis 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:\n\n```json\n{\n  \"fips\": \"410494\",\n  \"gnis\": \"36061\"\n}\n```\n\nThe 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.\n\nIt'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).\n\n## Generate Your Own CSV\n\nYou can generate your own, more up-to-date version of this.\n\n1. Clone or download this repository.\n2. Edit the included `run.sh` script to remove everything after `csv.sh`.\n3. Run `run.sh` (`./run.sh`).\n\n## Generate Your Own API\n\nMake your own API.\n\n1. Clone or download this repository.\n2. 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.\n3. Run `run.sh` (`./run.sh`).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwaldoj%2Ffips-to-gnis","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwaldoj%2Ffips-to-gnis","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwaldoj%2Ffips-to-gnis/lists"}