Table of contents

• Table of contents
• About the prototype
• Preview
• Built with
• Getting Started
  • Install by using git and package manager
    • Prerequisites
    • Install
• License
• Contact
• Related links

About the prototype

This repository is a code-sandbox for the planned OGT project, places of Gestapo terror in present-day at Lower Saxony.

As a first prototype, a simple HTML/JS/CSS/SPARQL website will be implemented without including a web server, a frontend framework, a backend framework or a Wikibase instance. The website shall visualize an OpenStreetMap and information from Wikidata on it.

The prototype will be used to test/evaluate the following:

• Comparison of (open source) web map frameworks APIs:
  • ✔️ Leaflet (repository), an open-source JavaScript library for mobile-friendly interactive maps,
  • MapLibre GL, a community led fork derived from mapbox-gl-js prior to their switch to a non-OSS license,
  • OpenLayers (repository), a high-performance, feature-packed library for all your mapping needs.
  • MapBox (repository), a non-OSS JavaScript library for interactive, customizable vector maps on the web
• Map features like
  • ✔️ Default zoom-in/out control
  • ✔️ Tile layer providers switch option
  • ✔️ Show markers that have detailed info in a popup window
  • ✔️ Marker zoom-in option
  • ✔️ Hide/Show markers option
  • Add a time slider
• ✔️ The Wikidata API & SPARQL by displaying Wikidata information on the map.
• Add Wikidata login control.
• ✔️ An option to retrieve geo-coordinates for multiple addresses at once.
• A historical (geo-referenced) map as overlay

Preview

Leaflet map displaying Wikidata infos:

Geo-search on Leaflet map:

Geo-search by address list:

Built with

• Leaflet (repository), a JavaScript library for mobile-friendly interactive maps.
• leaflet-geosearch (repository), a geocoding/address-lookup library supporting various api providers.
• npm (repository), a package manager for JavaScript.

Getting Started

Instructions for setting up project locally. To get a local copy up and running follow these steps.

Install by using git and package manager

Prerequisites

Software you need to use the prototype and how to install them for Ubuntu.

• git (not required, if you download project zip package)

  sudo apt update && sudo apt upgrade
  sudo apt install git

• npm

  npm install npm@latest -g

Install

1. Clone the repo

   git clone https://git.tib.eu/nfdi4culture/ogt/ogt-prototype-simple-webpage.git

   or download zip package from GitLab (or GitHub) and unzip into a directory.

2. Install libs with NPM

   cd ogt-prototype-simple-webpage/
   npm install

License

Distributed under the GNU GPLv3 License. See LICENSE for more information.

Contact

Nils Casties - 📬

Related links

• OpenStreetMap Frameworks