Skip to content

Map Quizzer Chrome extension. Opens on blank Chrome tabs, with question about a random free-to-use Library of Congress map. *Not an official product of Library of Congress

License

Notifications You must be signed in to change notification settings

reliztrent/map-quizzer

Repository files navigation

Map Quizzer

Installation

  1. Download this repository as a .zip file cy clicking the green Code button > Download ZIP.
  2. Open the zip file, to unzip it into a folder.
  3. In Chrome, go to chrome://extensions (in the search/URL bar).
  4. Toggle on developer mode.
  5. Click on "Load unpacked extension".
  6. Open the unzipped folder.
  7. Turn off developer mode.
  8. All done! Open a new tab to start the Map Quizzer.

Summary

This repo contains the files for a Chrome extension that opens a map quiz every time a blank tab is opened in Chrome. The quiz pulls a random map from the online collections of the Library of Congress and asks you to guess which year the map was published. Three options are given: the correct publication year and two other years pulled randomly from the same corpus of maps.

The extension is built using Vue.js (a JavaScript framework) and Tify (a IIIF image viewer and zoomer, from the Göttingen State and University Library).

Two screenshots of Map Quizzer. Main page with map and three date options. Zoom page with ten-second countdown.

Data

Map Quizzer selects from a pre-processed json-formatted list of maps online from Library of Congress at loc.gov/maps. The data was pulled using the loc.gov API, and maps were bias sampled with the following filters:

  1. Maps must be published to loc.gov via the Library of Congress catalog. This excludes maps from the Sanborn set.
  2. The publication year must be known (no question marks in the date field)
  3. Approximately 3/5 of English-only language maps were filtered out, to increase hetergeneity of data.
  4. Common publication years were thinned. Years with 100+ maps often represent homogenous map series or US Civil War maps.

The IIIF links pulled from the API were also altered to increase or decrease the image size to better fit the extension layout. For example, this IIIF url provided by the API would return an image 1052px wide, which is much wider than the extension needs:

Whereas this slightly altered URL returns the same image at only 673px wide:

Using Vue.js, the data is loaded directly from the background.js file.

About

Map Quizzer Chrome extension. Opens on blank Chrome tabs, with question about a random free-to-use Library of Congress map. *Not an official product of Library of Congress

Resources

License

Stars

Watchers

Forks

Packages

No packages published