Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

0313 nav place viewcone #411

Open
wants to merge 5 commits into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions Gemfile
Original file line number Diff line number Diff line change
Expand Up @@ -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'
Expand Down
2 changes: 2 additions & 0 deletions Gemfile.lock
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -130,6 +131,7 @@ DEPENDENCIES
jekyll-seo-tag
rake
rspec
webrick

BUNDLED WITH
2.1.4
34 changes: 34 additions & 0 deletions recipe/0313-navplace-viewcone/index.md
Original file line number Diff line number Diff line change
@@ -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 %}
200 changes: 200 additions & 0 deletions recipe/0313-navplace-viewcone/manifest.json
Original file line number Diff line number Diff line change
@@ -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
]
]
]
}
}
]
}
}
]
}