Use Case
You have two photographs of the subject Laocoön, one of a bronze statue and the other of a painting. You would like to show where the two works are located as Points on a web mapping platform. navPlace allows you to place the spatial representation (Point, Polygon, Line Segment) of your Canvas on a web map.
Implementation Notes
This recipe describes the use of navPlace at a Canvas implementation level, and is largely similar to the recipe to Locate a Manifest on a Web Map. The main difference to note is that each Canvas will need its own Feature Collection, as described below. In this case, each image is represented in its own Canvas. Other related recipes are listed in the links at the bottom of the page.
It is important to note that navPlace is not semantic and cannot be used to state the purpose of the location it shows. The example uses navPlace to represent the current location of the items, but it is not specified or limited to that, and more accurately we can say that navPlace is used to show a location.
The value for navPlace is a single GeoJSON Feature Collection. A Feature Collection represents an aggregation of spatially bounded areas. A Feature Collection has a type property that must be “FeatureCollection”. A Feature Collection has a features list that contains GeoJSON Features. Each Feature type has coordinates that correspond to a shape such as a Point or Polygon. An id is not required in an embedded Feature Collection, but is required when the value is a referenced Feature Collection. Each Canvas is showing individual locations and so each Canvas needs its own Feature Collection.
Note that GeoJSON specifies coordinates be recorded in Longitude, Latitude order, but Google Maps will display coordinates in Latitude, Longitude order. Always confirm the order of your coordinates when gathering them, as other web mapping platforms may have these format inconsistencies.
For technical specifics on implementing the navPlace property see the implementation notes in the IIIF Extensions directory. You can also refer to the IIIF Guides entry for step-by-step hands-on details on implementation.
The navPlace property is not processed by the Universal Viewer or Mirador viewer at this time.
Example
The Manifest contains images of the bronze by Giovanni Battista Foggini and the painting Laocoön by El Greco. The navPlace property in each Canvas stores geographic information about the works represented in the photographs, in this case their current location. navPlace contains GeoJSON-LD, and a client can parse GeoJSON features from navPlace. These GeoJSON features are rendered as geometric shapes by web mapping platforms. Data from the resource such as an image URL, label or summary is connected with those shapes via properties in GeoJSON, but this is not a required step for seeing the shape on the map.
JSON-LD | View in Navplace Viewer | View in Theseus