API, widgets, and links to build up your own project web

Institutions with configured georeferencing pilot receive their own domain (like https://demo.georeferencer.com/) - where "demo" is their own selected name.

The website has adjusted style (logo, colors, fonts) which mimics the website of the institution. Institutions are encouraged to implement their own website presenting the crowdsourcing project landing page and possibly also blog or other widgets using:

Widgets and crowdsourcing statistics

Widgets showing the progress of the georeferencing pilot and statistics for work done by individual people. These may be used internally in the institution or publicly for a crowdsourcing pilot. The widgets can be embedded in other websites via HTML iFrame.

Data from widgets are available in JSON format as well - for closer integration by programmers with custom-developed systems.


(please replace the "demo" in the link with your own [INSTITUTION] domain name - to get the right links.

Linking into Georeferencer from your catalog or website

An institution can integrate a link from their existing websites, online catalog, or digital repository for individual maps directly into Georeferencer service with an easy-to-use link APIs - using the institution identifiers ([CUSTOM-ID] supplied during the import of metadata into the system.


API for simple linking to the latest available georeference on the Georeferencer service with a custom institution identifier:

https://[INSTITUTION].georeferencer.com/id/[CUSTOM-ID]

To receive a random not yet georeferenced map from the given institution:

https://[INSTITUTION].georeferencer.com/random

Link to the officially reviewed version of georeference:

https://[INSTITUTION].georeferencer.com/id/[CUSTOM-ID]/reviewed

Link to the original website of a particular map:

https://[INSTITUTION].georeferencer.com/id/[CUSTOM-ID]/link

Links for implementing intelligent buttons via JavaScript with JSONP query:

https://[INSTITUTION].georeferencer.com/id/[CUSTOM-ID]/state?callback=foo

This call provides back one of: 'georeferenced' or 'ungeoreferenced' or 'not_found':
JavaScript can then create different links or buttons with dependency on the status of a map - for example, do not show links to maps that are not part of Georeferencer.
A sample code with jQuery is available at http://jsfiddle.net/aPBRA/3/
This means you can create "INTELLIGENT BUTTONS / LINKS " telling people you need their help to georeference a map - or telling them to view an already located map - based on the status of the map.

Results of the crowdsourcing pilot

After the pilot is finished there are several outputs:

Spreadsheet with geo-metadata exports

Spreadsheet table with the produced metadata (including MARC 034 field, bounding boxes, geo envelope, etc). This table is in the Microsoft Excel format (XLS) and it helps to use the data for enrichment of cataloging library system or for backups.

Download GeoTIFF & use map services

Access to raw produced data is via the "This map" page. It gives you the possibility to generate GeoTIFF from your scanned map with georeferencing information from the Georefrencer service.

"This map" page also provides links to Map Services (OGC WMTS standard) to all logged-in users. These can be opened in desktop software or online GIS tools - such as ArcGIS or QGIS.

On-request (if our working time is covered) we can also provide exports in additional data formats.

Have a look also at the FAQ