Scripts to convert David Rumsey Map Collection metadata to Georeference Annotations

First make sure that Bun is installed on your system. Then install dependencies by running this command in the root of the repo:

bun install

Before running the script you need to download the file luna_omo_metadata_56628_20220724.zip from this dataset: David Rumsey Map Collection: Georeferenced Maps Metadata.

Unzip the file and place luna_omo_metadata_56628_20220724.csv in the _data directory (create this directory if it isn't there).

To run the script:

bun convert

The script will output a single ndjson file in the _output directory. You can use the --format flag to change the format of each line in this file:

bun convert --format annotations ## georeference annotations (default)
bun convert --format maps ## internal map format used by Allmaps
bun convert --format minimal ## minimal map format

Todo

• Combine maps into Annotation Pages based on identical metadata
• Offer an option to output separate json files
• Add a script to scrape image width and height from public IIIF Image API endpoints
• Add a filter for reviewed maps
• Process some of the metadata in order to add e.g. labels to partOf objects.
• Publish annotations to Allmaps API

Credits

Huge thanks to Katherine McDonough and the MapReader team for making this data publicly available and pointing us to the dataset!

This project was created using bun init in bun v1.1.24. Bun is a fast all-in-one JavaScript runtime.