diff --git a/Gemfile b/Gemfile index e760606bc..5c7a5eb3a 100644 --- a/Gemfile +++ b/Gemfile @@ -9,6 +9,8 @@ gem 'iiifc-theme', github: 'iiif/iiifc-theme', branch: 'main' # For open graph and Twitter Card elements gem 'jekyll-seo-tag' +gem 'webrick' + group :development, :test do gem 'html-proofer', "3.19.0" gem 'rspec' diff --git a/Gemfile.lock b/Gemfile.lock index 42e956f8b..8d65219c3 100644 --- a/Gemfile.lock +++ b/Gemfile.lock @@ -118,6 +118,7 @@ GEM typhoeus (1.4.0) ethon (>= 0.9.0) unicode-display_width (1.8.0) + webrick (1.8.1) yell (2.2.2) PLATFORMS @@ -130,6 +131,7 @@ DEPENDENCIES jekyll-seo-tag rake rspec + webrick BUNDLED WITH 2.1.4 diff --git a/recipe/0313-navplace-viewcone/index.md b/recipe/0313-navplace-viewcone/index.md new file mode 100644 index 000000000..80201dafe --- /dev/null +++ b/recipe/0313-navplace-viewcone/index.md @@ -0,0 +1,34 @@ +--- +id: 313 +title: Viewcone +topic: geo-recipes +tags: [maps, geolocate, navPlace] +summary: "Use the navPlace extension to express a visual viewcone from a given point on a map." +layout: recipe +viewers: + +--- + +### Use Case +I would like to represent on a web map the orientation of a photograph, the point of origin and the visible radius. + +The application can go from showing the photographer's point of view in old photographs georeferenced on a historical map, to placing archeological findings with the correct reference point in focus, to finding the optimal placement for a work of art on an art gallery, using either the visitor's starting point as the origin, or the work of art itself. + +### Implementation Notes +The necessary data to generate the viewcone can / must be collected using external tools such as Google Earth, to pinpoint the origin point (the photographer's point of view) latitude, longitude and heading. Drawing the viewcone arch can be done manually feeding the coordinates for each point that form the radius, taken from Google Earth, or approximately by determining a default angle (narrow, wide, extra wide) and distance (short, far, infinite). The precise coordinates extracted from Google Earth will provide highest accuracy, and will be necessary to create reliable machine readable data. However, end users who can allow a larger margin of error might find it easier to use the default "sizes" for opening and distance instead, in case of missing the precise radius coordinates. + +Obstacles that might obscure part of the field of view in the viewcone are currently not supported. + + +### Example +Should be very visual, show with obstacles between the origin point and object the example is trying to prove you can/can't see. + +{% include manifest_links.html viewers="" manifest="manifest.json" %} + +{% include jsonviewer.html src="manifest.json" config='data-line="1"' %} + +## Related Recipes +* TODO + +{% include acronyms.md %} +{% include links.md %} diff --git a/recipe/0313-navplace-viewcone/manifest.json b/recipe/0313-navplace-viewcone/manifest.json new file mode 100644 index 000000000..98da67626 --- /dev/null +++ b/recipe/0313-navplace-viewcone/manifest.json @@ -0,0 +1,200 @@ +{ + "@context":[ + "http://iiif.io/api/extension/navplace/context.json", + "http://iiif.io/api/presentation/3/context.json" + ], + "id":"{{ id.url }}", + "type":"Manifest", + "label":{ + "it":[ + "Bronzo Laocoonte e i suoi figli" + ] + }, + "items":[ + { + "id":"{{ id.path }}/canvas/1", + "type":"Canvas", + "height":3000, + "width":2315, + "label":{ + "en":[ + "Front of Bronze" + ] + }, + "items":[ + { + "id":"{{ id.path }}/anno-page/1", + "type":"AnnotationPage", + "items":[ + { + "id":"{{ id.path }}/anno/1", + "type":"Annotation", + "motivation":"painting", + "body":{ + "id":"https://iiif.io/api/image/3.0/example/reference/28473c77da3deebe4375c3a50572d9d3-laocoon/full/max/0/default.jpg", + "type":"Image", + "format":"image/jpg", + "height":3000, + "width":2315, + "service":[ + { + "id":"https://iiif.io/api/image/3.0/example/reference/28473c77da3deebe4375c3a50572d9d3-laocoon", + "profile":"level1", + "type":"ImageService3" + } + ] + }, + "target":"{{ id.path }}/canvas/1" + } + ] + } + ], + "navPlace":{ + "id":"{{ id.path }}/feature-collection/1", + "type":"FeatureCollection", + "features":[ + { + "type":"Feature", + "properties":{ + "id":"c3b4090c-398a-44c8-8007-7f2e1aadf425", + "ssid":"32481287", + "title":"Vista de área aterrada e de fábrica de gás", + "creator":"Georges Leuzinger", + "creditline":null, + "artstor":null, + "firstyear":1860, + "lastyear":1870, + "thumbnail":"https://iiif.imaginerio.org/iiif/32481287/full/929,690/0/default.jpg", + "latitude":-22.90387, + "longitude":-43.1977, + "heading":-153.46874, + "updated":null, + "type":"Views" + }, + "geometry":{ + "crs":{ + "type":"name", + "properties":{ + "name":"EPSG:4326" + } + }, + "type":"Polygon", + "coordinates":[ + [ + [ + -43.19770499999997, + -22.903864999999914 + ], + [ + -43.200607999999946, + -22.906270999999897 + ], + [ + -43.200534999999924, + -22.906343999999933 + ], + [ + -43.20044899999994, + -22.90642499999992 + ], + [ + -43.20035999999993, + -22.906502999999926 + ], + [ + -43.20026899999993, + -22.906577999999953 + ], + [ + -43.20017499999991, + -22.906650999999965 + ], + [ + -43.200078999999924, + -22.90672099999996 + ], + [ + -43.199981, + -22.90678799999997 + ], + [ + -43.19987999999993, + -22.906852999999924 + ], + [ + -43.19977699999997, + -22.90691399999996 + ], + [ + -43.19967199999992, + -22.906972999999912 + ], + [ + -43.19956499999993, + -22.907027999999965 + ], + [ + -43.1994559999999, + -22.90707999999994 + ], + [ + -43.199345999999906, + -22.90712899999996 + ], + [ + -43.19923299999989, + -22.907174999999935 + ], + [ + -43.19911999999996, + -22.90721799999994 + ], + [ + -43.199004999999936, + -22.907256999999966 + ], + [ + -43.19888899999992, + -22.907292999999996 + ], + [ + -43.198770999999965, + -22.907325999999973 + ], + [ + -43.198651999999946, + -22.90735499999995 + ], + [ + -43.19853299999988, + -22.907379999999907 + ], + [ + -43.19841299999995, + -22.907402999999896 + ], + [ + -43.19829199999999, + -22.90742099999993 + ], + [ + -43.19816999999993, + -22.90743699999998 + ], + [ + -43.19804799999997, + -22.907447999999945 + ], + [ + -43.19770499999997, + -22.903864999999914 + ] + ] + ] + } + } + ] + } + } + ] +} \ No newline at end of file