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, colours, 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 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 ingrate 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]

There is also a link to the officially reviewed version of georeference (confirmed by an appointed reviewer from the institution):

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

Then a link to original website of particular map is:

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

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

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

and links for implementing intelligent buttons (with different text or graphics depending on the status of the individual map) 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 map - for example do not show links to maps which 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 already located map - based on the status of the map.

For linking into Georeferencer you may display the button georeferencer-banner-link-small.png from the design page.

Results of the crowdsourcing pilot

After the pilot is finished there are several outputs:

Spreadsheet with geometadata 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 cataloguing library system or for backups.

Download GeoTIFF & use map services

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

"This map" page also provide 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 the 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 FAQ