public_library_map/README.md
Hugh Rundle 96e28cb31e Update README.md
fix leftover merge conflict litter
2024-08-10 11:13:24 +10:00

2.3 KiB

Public library data map

This project collects and maps data from public libraries across the Australia and the external Territories of Christmas Island and the Cocos (Keeling) Islands.

You should be able to find the location of every public library in Australia territory, plus the standard loan period for each libary service, and whether they charge overdue fines (if known, in both cases).

Check out the map at librarymap.hugh.run.

Find more on this project at about.

Attributions

See sources.

Want to help?

See contributing, especially which files to update.

Deployment

The website for this project uses git-webhooks with a customisation to run the process.js file that is found in this repository on each pull. The file is stored with the webhooks files so that everything can be npm installed together.

This process.js file syncs any changes from the csv files into the topojson attributes (e.g. when a library changes their ILS).

Updating the topojson

Update boundaries

  • make a copy of /public_library_map/boundaries.geo.json
  • update in qgis
  • save the copied file

Simplify to reduce the file size

Option 1

  • upload to https://mapshaper.org/ and 'simplify' the boundaries
  • download the simplified version
  • replace /public_library_map/boundaries.geo.json

Option 2

sudo npm install -g mapshaper
mapshaper boundaries.geo.json snap -clean -o force precision=0.0001 format=geojson boundaries.geo.json

Turn it into topojson:

sudo npm install -g topojson-server
geo2topo boundaries.geo.json -q 50000 > website/data/boundaries.topo.json

Contributing

To contribute to the map data you can contact Hugh at librarymap [at] hugh.run. If necessary, I will add an account for you on git.suboptimal.solutions if you want to contribute to the code.

Contributors are listed at contributors.txt.

Licenses

/website/data: CC-BY-SA

everything else: GPL-3.0-or-later