]> git.openstreetmap.org Git - nominatim.git/blob - data-sources/us-tiger/README.md
Merge pull request #1445 from mtmail/hierarchy-endpoint-broke
[nominatim.git] / data-sources / us-tiger / README.md
1 # US TIGER address data
2
3 Convert [TIGER](https://www.census.gov/geo/maps-data/data/tiger.html)/Line dataset of the US Census Bureau to SQL files which can be imported by Nominatim. The created tables in the Nominatim database are separate from OpenStreetMap tables and get queried at search time separately.
4
5 The dataset gets updated once per year. Downloading is prown to be slow (can take a full day) and converting them can take hours as well.
6
7 Replace '2018' with the current year throughout.
8
9   1. Install the GDAL library and python bindings and the unzip tool
10
11         # Ubuntu:
12         sudo apt-get install python-gdal unzip
13         # CentOS:
14         sudo yum install gdal-python unzip
15
16   2. Get the TIGER 2018 data. You will need the EDGES files
17      (3,233 zip files, 11GB total).
18
19          wget -r ftp://ftp2.census.gov/geo/tiger/TIGER2018/EDGES/
20
21   3. Convert the data into SQL statements. Adjust the file paths in the scripts as needed
22
23         cd data-sources/us-tiger
24         ./convert.sh <input-path> <output-path>
25         
26   4. Maybe: package the created files
27   
28         tar -czf tiger2018-nominatim-preprocessed.tar.gz tiger
29