For setting up your pilot, we need a metadata sheet which will give us the necessary information about your images/scans. It is a table with the list of the identifiers, links and metadata records. The list should be submitted to in the form of Microsoft Excel / OpenOffice (XLS file or CSV with utf-8 encoding) with the column names in the first row as described in this document and relevant data one record per row.

Mandatory columns:

  • id: Your unique identifier for each row. The ids of the images or records in your existing cataloging system.
If you upload the images to our IIIFHosting ( then:
  • filename: with a name of an uploaded file. It should not contain spaces, not commas. If you have uploaded images in directories, then this column in the spreadsheet must contain also the name of the folder where the image is located. For example: M001.tiff folder "atlas" will have filename "atlas/m001.tif"
If you host the images on your own image service (such as on your server) then:
  • image_format: Type of the image service, eg. "Iiif", or "Zoomify"; can be omitted if all maps have the same format (usually they have for one collection)
  • image_url: Direct link to the zoomable image presentation; eg. for Zoomify, it ends with "ImageProperties.xml", to be specified for other formats.

Optional columns:

  • link (IMPORTANT): URL of the map page in the library website (where to send people). On this page can be easily placed the backlink to Georeferencer service
  • viewer: URL to the zoomable viewer of the scan on the web 
  • catalog: URL to the catalog, with detailed authoritative metadata record
  • title (IMPORTANT): Title of the map
  • date (IMPORTANT): Date of what is depicted on the map, ie. not the publishing date;
    if you know the exact date, then in either YYYY, YYYY-MM or YYYY-MM-DD format
    if you know only the century, then as YYXX; eg. 16XX for the 1600-1699
    alternatively for a range of dates: date_from and date_to  (it is possible to fill only the "date" column or only the range of dates using the combination of "date_from" and "date_to" column!)
  • pubdate: Date of the publication (if known) - a supplement to 'date' to recognize reprints and school atlas maps from true old maps.
    alternatively for a range of dates: pubdate_from and pubdate_to
  • description: Description of what is on the map as a simple text, ie. not HTML, not entity escaped
  • creator: Name of the cartographer, surveyor, etc.; NOT "anonymous"
  • contributor: Name of the engraver; NOT "anonymous"
  • publisher: Name of the publisher; NOT "anonymous"
  • width: Physical width of the map in millimeters
  • height: Physical height of the map in millimeters
  • scale: Metric scale denominator; ie. if the scale is 1 meter : 10,000 meters, the value is 10000
  • dpi: The information about scans - for precise estimation of scale in the MapAnalyst
Optional location columns:

    Either you provide the whole bounding box
  • north: Latitude of the north-most point
  • south: Latitude of the south-most point
  • east: Longitude of the east-most point
  • west: Longitude of the west-most point
    Or you can provide just the center point
  • latitude: Latitude of the center
  • longitude: Longitude of the center
    In either case, coordinates are given as real numbers in decimal degrees on the WGS84 datum. 

Note: Do not use the NULL value or "anonymous". If the value is missing, simply omit it (empty string).
Petr Pridal,
Nov 26, 2013, 7:45 AM