NZGB ➡️ OSM place name conflation

This repository contains the code that regularly compares place names in OpenStreetMap with the New Zealand Geographic Board (Ngā Pou Taunaha o Aotearoa) Gazetteer.

How this works:

• The list of place names is downloaded from the NZGB
• An extract of the OpenStreetMap planet is downloaded (containing only Oceania & Antarctica)
• The OpenStreetMap planet is compared with the gazetteer, and any discrepancies are identified and categorized
• The result of the conflation process is converted into a format that allows OpenStreetMap mappers to review each place using the same tools as the LINZ-to-OSM address import.

Setup

If you want to contribute to the code, the following needs to be done manually:

1. Clone this repository
2. Download nodejs v18 or later
3. Install yarn (run npm i -g yarn)
4. Run yarn
5. Run yarn 1 to download the data (10mins)
6. Manually download the planet (West side as tmp/osm-west.csv and East side as tmp/osm-east.csv)
7. Manually download NZGB Lines as tmp/nzgb-lines.csv
8. Manually download NZGB Areas as tmp/nzgb-areas.csv
9. Run yarn 2 to preprocess the data (3mins)
10. Run yarn 3 to conflate the data (2mins)
11. Run yarn 4 to generate the HTML report (1sec)
12. Use the generated osmPatch files to update the place names in OSM