theberlage / allmaps-workshop

Project NL workshop
https://theberlage.github.io/allmaps-workshop/
1 stars 16 forks source link

How to combine different maps in a single annotation? #6

Open sammeltassen opened 1 year ago

sammeltassen commented 1 year ago

Description of the issue:

I have made several new maps, added them to the IIIF-server and georeferenced them with the Allmaps Editor. Now I would like to combine them on a single AnnotationPage in order to add them as a combined layer in Placemark. How to do this?

sammeltassen commented 1 year ago

There're two methods for this:

  1. Combine the Annotations on a single AnnotationPage. This can be done in any code editor. The resulting AnnotationPage can be saved to GitHub and loaded using the raw URL in the Allmaps Viewer or TileServer.
  2. Create a new manifest containing the images. This can then be loaded in the Allmaps Editor, and the resulting AnnotationPage of the collection of images can be copied.

Here's an easy way to generate manifests of images on the fly without the need to manually edit code:

  1. Go to the the-berlage space in the DLCS portal
  2. Open one of the images that you'd like to include in the manifest
  3. Click Edit this image on the right
  4. Add theberlage to String1
  5. Add an identifier for the group to String2, e.g. group1
  6. Add an optional third string to String3 such as houses
  7. Click Save
  8. Do the same for the other images that you'd like to include
  9. Now generate the manifest by constructing the following URL: https://dlc.services/iiif-resource/7/string1string2string3/[string1]/[string2]/[string3], e.g. https://dlc.services/iiif-resource/7/string1string2string3/theberlage/group1/houses
  10. Confirm that the manifest url is working by loading it in the browser
  11. Open the URL in the Allmaps Editor, it should recognise the images that have already been georeferenced
  12. Open the code panel on the bottom right
  13. Next to Show annotation for click Collection
  14. Click Open in new tab and copy the URL
  15. You can now use this URL like other annotation URLs for the TileServer (see the examples here)

Ad. 4-7: You can consider adding a number to the Number1 field. This determines the order of images in the manifest and the annotation (relevant if images overlap). If I'm not mistaken, the first image lays on top... Ad 9: This URL is updated every time you add strings to another item; you can reload it in the Allmaps Editor to update the annotation. Please be aware that the TileServer uses cache; it could take up to 30m to see the changes. Ad. 9: You can also leave out string3 to generate a manifest for the entire group, e.g. https://dlc.services/iiif-resource/7/string1string2string3/theberlage/group1.