Skip to content

osm-nz/missing-streets

Repository files navigation

Finds streets that are missing in OpenStreetMap

build Lines of code

Please see the wiki page for information about this project. Or click here to open the tool.

If all three status badges above are green, then the script is automatically running once a week (on Wednesday morning NZ time)

Documentation for software developers (click to expand)

Running the script:

# first install nodejs and yarn

# For some regions, you don't need any API keys.
# For other networks like NZ, you will need to:
# Then generate an API from https://data.linz.govt.nz/my/api
# with "Full access to Exports Access"
# create a file called `.env.local` in this folder, and add
# REACT_APP_LDS_KEY=XXXXX
# where XXXXX is the token you just generated.

npm start NZ preprocess # this will request an export of the dataset from LINZ

# now wait up to 1 hour for the export to be generated.
# Login to https://data.linz.govt.nz to check progress

npm start NZ downloadPlanet
npm start NZ downloadSourceData
npm start NZ preprocessPlanet
npm start NZ preprocessSourceData
npm start NZ conflate
# generates the final file: ./public/conflationResult.geo.json

# finally, the results should be uploaded to the CDN. This is done by the GitHub CI


# to run the process for other regions, just replace "NZ"
# with the region ID like "AU_NSW"

Running the client:

# first, run the script above
yarn client:start

# then visit http://127.0.0.1:3000
# you must use 127.0.0.1 instead of localhost

The client is automatically deployed to github pages.

Other Regions

This tool supports many different regions. You can add your local area by:

  • adding a new folder in script/regions which exports an object conforming to the standard structure.
  • Implementing the code for downloading and preprocessing your region's dataset
  • Adding other fields like the URL to download an extract of the planet file for your region.
  • Exporting that folder from script/regions/index.ts and choose a region ID.
  • Adding the same region ID to the matrix in .github/workflows/sync.yml.

About

Finds streets that are missing in OpenStreetMap using government datasets from various countries

Resources

Stars

Watchers

Forks

Contributors

Languages