Metadata

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 our team via the ClientPortal ticketing system in a 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.


Download sample spreadsheet


You can DOWNLOAD SAMPLE XLS or even look at it directly in ONLINE PREVIEW.




Once you download the file - just edit it in a spreadsheet - or ask your IT people to export your metadata in exactly the same format.


Mandatory columns

    • id: Your own unique identifier for each map image. The IDs of images or records in your existing cataloging / publishing system. Later you can use these IDs you supply in our APIs to identify your maps to construct links, etc.
    • filename: Name of the uploaded file. It should not contain spaces, nor 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" - ideally case sensitive.
    Optional columns:
      • link (IMPORTANT): URL of the map page in your library website (where you want to send people). On this page can be easily placed the inteligent backlink to Georeferencer service
      • viewer: URL to the zoomable viewer of the scan on the web (if different from the landing page "link" above).
      • catalog: URL to the catalog, with detailed authoritative metadata record (if different from the landing page "link" above)
      • title (IMPORTANT): Title of the map (if known).
      • date (IMPORTANT): Date of what is depicted on the map, ie. not the publishing date;
        either in YYYY or YYYY-MM-DD format
        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"
      • physical_width: Physical width of the map in centimeters
      • physical_height: Physical height of the map in centimeters
      • 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.
      An example formatting is visible under "CSV RAW" format at https://boundingbox.klokantech.com/

      Note: Do not use the NULL value or "anonymous". If the value is missing, simply omit it (empty string).
      Ĉ
      Petr Pridal,
      Jul 24, 2019, 6:29 AM