Skip to content

Georeferencing tool for natural history collections

License

Notifications You must be signed in to change notification settings

Naturhistoriska/Georg

Repository files navigation

Try out Georg

Click this link to try out Georg!

Georg

Build Status codecov License: MIT

Georg is a web application designed to support georeferencing, or, the process of obtaining geographic coordinates from a locality description, for natural history collections data. It allows a user to select among suggested matches to the entered text string or by choosing a map point and then selecting a named place based on geographic proximity to the marker. Georg currently supports single-locality queries as well as limited batch processing for uploaded lists of localities.

Georeferencing is a prerequisite to using natural history collections data in research or visualization that relies on geospatial interpretations. At natural history collections and herbaria, locality data often represents rigorous interpretation of expedition or collecting data. Our intention is to facilitate use of these interpretations while encouraging greater refinement of existing georeferencing workflows.

Data capture at natural history collections often takes place with an emphasis on particular geographic regions, taxonomic groups, or expeditions. Customized subsets of localities compiled under these georeferencing themes are used in Georg to assign coordinates in the context of relevant interpretations available from the biodiversity informatics community. This is also likely to improve feedback on the original data through more rigorous evaluation under novel georeferencing themes, a process that is otherwise limited to basic validation prior to data use or visualization.

How to setup Georg

This guide will help you to setup georg on server.

How Georg works

Georg consists of four parts:

  • georg-pelias,
  • georg-service,
  • georg-ui
  • georg-data.

georg-pelias

Forked out from Pelias/Docker. It is a search engine for places over the Nordic countries and possible to expand over the world. georg-pelias is dockerized. Currently data imported into georg-pelias are:

georg-service

API build on top of georg-pelias. It allows user to send a text with locality information, or coordinates and get back location suggestions (in JSON format). API is also possible for users to upload a csv file with list of locality information, and get back the best match location suggestion for each locality (in both JSON or CSV format). Current API provides five endpoints:

  • search
  • reverse geocoding (with latitude and longitude)
  • reverse geocoding (with coordinates as a text in dd, dms, ddm format )
  • suggest
  • batch upload

georg-ui

A web based application that allows user to type in text with locality information and get back location suggestions, and display location on map. georg-ui is also allows user type in coordinates or click on map for reverse geo-coding. The batch upload inteface allows user to select csv file with list of locality information from local computer and upload that file to API for georeferencing. georg-ui uses leaflet map component for displaying search results. Currently georg-ui uses three map layers:

  • OpenStreetMap
  • Lantmäteriet topografish
  • Lantmäeriet nedtonad

    It is possible to add additional map layers into the map.

georg-data

A tool for processing customized dataset before importing them into georg-pelias

How does georg work in practice?

  • We gather locality information for georeferenced locations from different data sources.
  • We process the information to make the locations searchable before we import them into Georg.
  • When you search, Georg compiles and ranks the result so that you get the most relevant search hits.

The locations are displayed on a map, with coordinates provided in a number of formats so that you can copy them into your system. For each location, you can view the information in JSON format. We have made an example of how to use the JSON information to geocode directly from FileMaker: FileMaker example (Github).

License

Georg and its source code is distributed under the MIT license.

Funding

Georg development was funded in 2019 by the Swedish Taxonomy Initiative and in 2021 by SYNTHESYS+.